Antler WHMCS Template

Esta guía explica los errores más comunes que pueden aparecer en tu sitio web —incluyendo errores 500, 403, 404, modo mantenimiento, errores de permisos, límites LVE o configuraciones .htaccess— y las soluciones prácticas para resolverlos desde cPanel.

Resumen rápido

• Error 500 → problema interno: .htaccess, PHP, plugins o límites LVE.
• Error 403 → permisos incorrectos o carpeta protegida.
• Error 404 → archivo o ruta inexistente; index borrado.
• Página de mantenimiento → archivo .maintenance o plugin de mantenimiento.
• Error 503 → límites LVE alcanzados (CPU/RAM/Entry Processes).
• Error 401 → autenticación inválida o HTTP Auth activo.

Error 500 — Internal Server Error

Es uno de los errores más comunes e indica un problema interno del servidor o de tu aplicación (WordPress, Laravel, etc.).

Causas principales

• Archivo .htaccess corrupto.
• Versión de PHP incompatible.
• Plugins o temas defectuosos.
• Permisos incorrectos (ej.: 777).
• Límites LVE alcanzados.

Soluciones rápidas

1. Regenerar .htaccess:

   # Renombra .htaccess a .htaccess.bak
   # Luego en WP-Admin → Ajustes → Enlaces permanentes → Guardar
   

2. Cambiar versión de PHP (8.1 recomendado).
3. Desactivar plugins renombrando wp-content/plugins.
4. Revisar permisos recomendados:
   • Archivos: 644
   • Carpetas: 755
5. Revisar Resource Usage por límites.

Error 403 — Forbidden

Indica que el servidor bloquea el acceso.

Causas comunes

• Permisos incorrectos (ej.: carpetas en 700).
• .htaccess con reglas que bloquean acceso.
• Archivo index faltante.
• Firewall bloqueando IP del visitante.
• Protección de directorio activada.

Soluciones

1. Verificar permisos correctos:
   • Carpetas → 755
   • Archivos → 644
2. Verificar si la carpeta tiene un archivo .htaccess con reglas erróneas.
3. Asegurarse de que exista index.php o index.html.
4. Desactivar temporalmente “Directory Privacy” en cPanel.

Error 404 — Not Found

Indica que la ruta no existe o el archivo no está presente.

Soluciones

• Verifica que el archivo o carpeta exista realmente.
• En WordPress: reescribe enlaces permanentes desde Ajustes → Enlaces permanentes → Guardar.
• Regenera el .htaccess por defecto.
• Comprueba que no existan reglas de redirección incorrectas.

Sitio en modo mantenimiento (WordPress)

Ocurre cuando queda un archivo .maintenance activo.

Solución

1. Ve a File Manager.
2. Busca el archivo .maintenance en public_html.
3. Bórralo.
4. El sitio debería volver a cargar.

Error 503 — Service Unavailable

Indica que se han alcanzado límites LVE del hosting:

• CPU
• RAM
• Entry Processes
• NPROC

Soluciones

• Habilitar caché (LiteSpeed Cache).
• Eliminar plugins pesados o duplicados.
• Optimizar base de datos.
• Reducir cronjobs muy frecuentes.
• Bloquear bots mediante plugin o firewall.
• Si es frecuente → considerar upgrade.

Error 401 — Unauthorized

Indica que falta autenticación o credenciales incorrectas.

Soluciones

• Revisar “Directory Privacy”.
• Eliminar o editar manuales en .htaccess:

  AuthType Basic
  AuthUserFile "/home/usuario/.htpasswds/public_html/passwd"
  

• Verificar credenciales correctas.

Errores PHP comunes

1) Fatal error: Allowed memory size

Solución:

memory_limit = 512M

2) Maximum execution time exceeded

max_execution_time = 300

3) Upload max filesize / post max size

upload_max_filesize = 64M
post_max_size = 64M

Cómo revisar logs para encontrar el error real

Los logs se encuentran en:

• public_html/error_log
• cPanel → Errors
• cPanel → Metrics → Errors
• WordPress: wp-content/debug.log (si está habilitado)

Activar WP_DEBUG temporalmente

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Buenas prácticas

• Guarda un backup antes de hacer cambios.
• No uses permisos 777 en ningún archivo.
• Evita modificar .htaccess innecesariamente.
• Actualiza plugins y temas con frecuencia.
• Usa PHP 8.1 o superior en sitios nuevos.
• Limpia cachés después de cualquier actualización.

Plantilla para abrir ticket (errores del sitio)

Asunto: Error en mi sitio — [mi-dominio.com]

Hola equipo,

Detalles:
- Dominio: [mi-dominio.com]
- Tipo de error: [500 / 403 / 404 / mantenimiento / 503 / otro]
- CMS utilizado: [WordPress / Joomla / Laravel / otro]
- Mensaje exacto del error (si aparece):
- Acciones que ya realicé:
- ¿Puedo acceder a cPanel?: [Sí/No]
- Capturas del error (si aplica):

Gracias,
[Tu nombre]

Recursos útiles

• Cambiar versión de PHP
• Límites LVE
• Desactivar plugins sin WP-Admin