Cómo solucionar errores comunes en WordPress (500, 404, etc.)
¿Te ha pasado que entras a tu web de WordPress y te encuentras con una pantalla en blanco, un mensaje de "Error 500 – Error interno del servidor" o un "404 – Página no encontrada"? No te preocupes, es más común de lo que crees y, en la mayoría de los casos, tiene solución sin necesidad de ser un experto en desarrollo web.
Como parte del equipo de soporte, he visto cientos de casos de errores wordpress y te aseguro que casi siempre se deben a problemas simples de configuración, memoria o archivos corruptos. En esta guía extensa te voy a explicar paso a paso cómo diagnosticar y solucionar error 500 wordpress, el temido 404, la pantalla blanca (WSOD) y otros fallos típicos.
Vamos a ponernos manos a la obra. Recuerda que si tienes acceso a tu panel de control, por ejemplo a Syspanel (recuerda que se accede por el puerto 2106), muchas de estas soluciones serán más rápidas.
1. Error 500 – Error interno del servidor (Internal Server Error)
Este es probablemente el error más frustrante porque no te da detalles. Simplemente la web no carga. La causa suele ser un plugin o tema conflictivo, un archivo .htaccess dañado o un límite de memoria PHP excedido.
### 1.1. Causas principales del error 500
- Plugin o tema recién instalado/actualizado que genera un conflicto.
- Archivo .htaccess corrupto (muy común).
- Límite de memoria PHP insuficiente para el proceso que intenta ejecutarse.
- Permisos de archivos incorrectos (muy raro pero posible).
- Error en el archivo wp-config.php (una línea mal escrita).
### 1.2. Solución paso a paso para el error 500
Paso 1: Desactiva todos los plugins
Accede a tu hosting por FTP o mediante el administrador de archivos de Syspanel (puerto 2106). Ve a la carpeta wp-content/ y cambia el nombre de la carpeta plugins a plugins_desactivados. Esto fuerza a WordPress a no cargar ningún plugin. Si la web funciona, el problema está en uno de ellos. Luego, renombra la carpeta a plugins de nuevo y ve activando uno por uno desde el panel de administración (si puedes acceder).
Paso 2: Revisa el tema activo
Si el problema persiste, cambia temporalmente al tema por defecto de WordPress (Twenty Twenty-Four o similar). Puedes hacerlo desde el administrador de archivos: ve a wp-content/themes/ y renombra la carpeta de tu tema activo (por ejemplo, mi-tema a mi-tema-viejo). WordPress automáticamente usará un tema por defecto. Si la web carga, tu tema es el culpable.
Paso 3: Restablece el archivo .htaccess
Conéctate por FTP o al administrador de archivos y localiza el archivo .htaccess en la raíz de tu instalación de WordPress. Renómbralo a .htaccess_viejo. Luego, ve a Ajustes > Enlaces permanentes en tu panel de WordPress (si puedes acceder) y haz clic en "Guardar cambios" para regenerarlo. Si no puedes acceder al panel, crea un archivo .htaccess nuevo con este contenido básico:
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
Paso 4: Aumenta el límite de memoria PHP
Edita el archivo wp-config.php en la raíz y agrega esta línea justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */:
define('WP_MEMORY_LIMIT', '256M');
Si no funciona, prueba con 512M. También puedes solicitar a tu proveedor de hosting (a través de Syspanel) que aumente el límite de memoria desde la configuración de PHP.
[TIP] Si después de estos pasos el error 500 sigue, revisa los logs de error del servidor. En Syspanel puedes acceder a ellos desde la sección "Registros" o "Logs". Busca la línea que contenga "PHP Fatal error" para identificar el archivo exacto que falla.
2. Error 404 – Página no encontrada
El error 404 significa que el servidor no encuentra la página que buscas. En WordPress suele ocurrir después de cambiar la estructura de enlaces permanentes o al mover el sitio de dominio.
### 2.1. Causas más comunes del 404
- Enlaces permanentes no regenerados después de un cambio.
- Archivo .htaccess faltante o corrupto (sí, también afecta a 404).
- Problemas con el módulo mod_rewrite de Apache (si usas Apache).
- Redirecciones mal configuradas o plugins de caché que guardan rutas antiguas.
### 2.2. Cómo solucionar el error 404
Paso 1: Regenera los enlaces permanentes
Ve a tu panel de WordPress > Ajustes > Enlaces permanentes. Sin cambiar nada, simplemente haz clic en "Guardar cambios". Esto fuerza a WordPress a reescribir las reglas en el .htaccess.
Paso 2: Verifica el archivo .htaccess
Si el paso anterior no funciona, revisa que el archivo .htaccess exista y tenga los permisos correctos (generalmente 644 o 640). Si no está, créalo con el contenido que te mostré en la sección del error 500.
Paso 3: Comprueba que el módulo mod_rewrite esté activo
Si tienes acceso a la terminal del servidor (por SSH) o a Syspanel, verifica que Apache tenga habilitado mod_rewrite. En Syspanel puedes ir a "Servicios Web" > "Apache" y asegurarte de que el módulo esté marcado. Si no, actívalo y reinicia Apache.
Paso 4: Limpia la caché del navegador y de plugins
A veces el navegador guarda una versión antigua de la página. Borra la caché del navegador (Ctrl+Shift+Supr) y, si usas un plugin de caché (como W3 Total Cache o WP Super Cache), purga toda la caché desde el panel de administración.
[WARNING] Si migraste tu sitio a un nuevo dominio, asegúrate de haber actualizado la URL en Ajustes > Generales (tanto la dirección de WordPress como la del sitio). Además, ejecuta una búsqueda y reemplazo en la base de datos para cambiar todas las URLs viejas por las nuevas. Puedes usar un plugin como "Better Search Replace".
3. Pantalla blanca de la muerte (WSOD – White Screen of Death)
La pantalla blanca es un caso particular de error 500, pero sin mensaje. Simplemente ves una página en blanco. Las causas son similares: memoria insuficiente, errores de PHP, plugins o temas defectuosos.
### 3.1. Diagnóstico rápido para la WSOD
Activa el modo de depuración de WordPress editando el wp-config.php. Busca la línea define('WP_DEBUG', false); y cámbiala a:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Esto creará un archivo debug.log dentro de la carpeta wp-content/. Accede a él por FTP o desde el administrador de archivos de Syspanel. El contenido te dirá exactamente qué archivo o función está causando el error.
### 3.2. Soluciones específicas para la WSOD
- Aumenta la memoria PHP como en el error 500 (ya viste cómo).
- Desactiva todos los plugins mediante FTP (renombra la carpeta
plugins). - Cambia al tema por defecto (renombra la carpeta de tu tema).
- Revisa el archivo functions.php de tu tema – a veces un error de sintaxis (como un punto y coma faltante) provoca la pantalla blanca. Edítalo con un editor de texto plano y busca errores.
[INFO] Si no puedes acceder ni siquiera al panel de administración, usa FTP o el administrador de archivos de Syspanel para realizar los cambios. Es la vía más segura.
4. Error de conexión a la base de datos
Este error aparece como "Error al establecer una conexión con la base de datos". Es grave pero tiene solución.
### 4.1. Causas
- Credenciales incorrectas en
wp-config.php(nombre de BD, usuario, contraseña). - Servidor de base de datos caído o sobrecargado.
- Tablas corruptas en la base de datos.
- El usuario de la BD no tiene permisos sobre la base de datos.
### 4.2. Pasos para solucionarlo
Paso 1: Verifica las credenciales en wp-config.php
Abre el archivo wp-config.php y busca estas líneas:
define('DB_NAME', 'nombre_base');
define('DB_USER', 'usuario_base');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');
Asegúrate de que coincidan exactamente con los datos que te proporcionó tu hosting. Si usas Syspanel, puedes encontrar esta información en "Bases de datos" > "MySQL".
Paso 2: Revisa que el servidor de BD esté funcionando
Si tienes acceso a Syspanel, ve a "Servicios" y verifica que MySQL/MariaDB esté activo. Si está detenido, inícialo.
Paso 3: Repara las tablas de la base de datos
Puedes hacerlo desde phpMyAdmin (accesible desde Syspanel). Selecciona tu base de datos, marca todas las tablas y en el menú desplegable elige "Reparar tabla". También puedes agregar esta línea al wp-config.php para forzar la reparación automática:
define('WP_ALLOW_REPAIR', true);
Luego visita tudominio.com/wp-admin/maint/repair.php y elige "Reparar y optimizar base de datos". No olvides borrar esa línea después.
5. Error 403 – Acceso prohibido (Forbidden)
Este error indica que el servidor rechaza tu solicitud por permisos.
### 5.1. Cómo arreglar el error 403
- Permisos de archivos incorrectos: Los archivos deben tener permisos 644 o 640, y las carpetas 755 o 750. En Syspanel puedes cambiar permisos fácilmente desde el administrador de archivos.
- Archivo .htaccess bloqueando el acceso: Revisa si hay reglas de denegación. Prueba a renombrar el
.htaccesstemporalmente. - Plugin de seguridad bloqueando tu IP: Si instalaste un plugin de seguridad, desactívalo por FTP renombrando su carpeta.
6. Error 502 – Bad Gateway
Este error suele ser del servidor, no de WordPress directamente. Indica que el servidor web (Apache/Nginx) no se comunica bien con PHP.
### 6.1. Soluciones rápidas
- Reinicia los servicios de PHP y el servidor web desde Syspanel (sección "Servicios").
- Aumenta los límites de tiempo de ejecución de PHP (max_execution_time) a 300 segundos.
- Verifica que el socket de PHP esté funcionando (en Syspanel puedes revisar el estado de PHP-FPM).
[TIP] Si el error 502 aparece de repente y no has cambiado nada, contacta a tu proveedor de hosting. Puede ser un problema de recursos del servidor.
7. Mantenimiento preventivo: cómo evitar estos errores
La mejor solución es la prevención. Sigue estos consejos para minimizar los errores wordpress:
- Actualiza siempre WordPress, temas y plugins desde el panel de administración. Pero antes de hacerlo, haz una copia de seguridad completa (archivos y base de datos). En Syspanel puedes programar copias automáticas.
- No instales demasiados plugins. Cada plugin adicional aumenta el riesgo de conflictos.
- Usa un tema de calidad y evita temas nulled o modificados.
- Monitorea los logs del servidor periódicamente. En Syspanel puedes ver los logs de error de Apache y PHP.
- Configura un límite de memoria PHP adecuado desde el principio (256M es un buen estándar).
8. Preguntas frecuentes (FAQ)
¿Por qué mi web da error 500 después de actualizar un plugin?
Porque el plugin actualizado puede tener un conflicto con tu tema u otro plugin. Sigue los pasos de desactivación por FTP que te expliqué.
¿El error 404 puede deberse a la caché del navegador?
Sí, a veces el navegador muestra una página 404 en caché. Limpia la caché del navegador y prueba de nuevo.
¿Cómo accedo a Syspanel para resolver estos errores?
Syspanel es el panel de control de tu hosting. Accede a través de tudominio.com:2106 (puerto 2106) con tus credenciales de administrador.
¿Es seguro modificar el archivo wp-config.php?
Sí, siempre que hagas una copia de seguridad antes y edites con un editor de texto plano (como Notepad++ o el editor de Syspanel). No uses WordPad o procesadores de texto.
¿Qué hago si no puedo acceder ni a FTP ni al panel de administración?
Contacta a tu proveedor de hosting. Ellos pueden reiniciar servicios o restaurar una copia de seguridad desde Syspanel.
Conclusión
Los errores wordpress como el 500, 404 o la pantalla blanca son frustrantes, pero en la gran mayoría de los casos se resuelven con unos pocos pasos lógicos. Recuerda que como wordpress sysadmin tu mejor aliado es la paciencia y el método: primero desactiva plugins, luego cambia el tema, revisa el .htaccess y por último aumenta la memoria.
Si después de todo esto el problema persiste, no dudes en abrir un ticket de soporte con tu proveedor de hosting. Ellos tienen acceso directo a los logs del servidor y pueden identificar el fallo en minutos.
Espero que esta guía te haya sido de gran ayuda. ¡Ahora ya sabes cómo enfrentarte a cualquier error de WordPress como un verdadero sysadmin!
