Cómo solucionar errores comunes en WordPress: Lista de verificación
¿Tu WordPress se ha quedado en blanco? ¿Ves un error 500 y no sabes por dónde empezar? Respira, es más común de lo que crees y, sobre todo, tiene solución.
En esta guía te voy a enseñar una lista de verificación paso a paso para que puedas identificar y resolver los errores más comunes de WordPress, incluso si nunca has tocado un archivo de código en tu vida.
Vamos a ir de lo más simple a lo más técnico, para que no te pierdas.
¿Por qué falla WordPress? Entendiendo el problema
Antes de lanzarnos a arreglar, es útil entender que WordPress funciona como una orquesta.
Tienes el núcleo (el director), los temas (los músicos principales) y los plugins (el resto de la banda).
Si un músico toca mal, el concierto se estropea.
Los errores suelen aparecer porque uno de estos tres elementos falla o porque hay un conflicto entre ellos.
Nuestro objetivo es aislar al culpable.
La Lista de Verificación Definitiva (Checklist)
Aquí tienes tu plan de ataque.
Sigue estos pasos en orden.
No los saltes, porque el paso 1 es el más fácil y el que más problemas resuelve.
Paso 1: La limpieza básica (Vacía la caché)
A veces el problema no es un error real, sino una versión antigua de tu web guardada en la memoria del navegador o del servidor.
[TIP] Esto es como apagar y encender el router. Es lo primero que hay que hacer siempre.
- Caché del navegador: Pulsa
Ctrl + F5(oCmd + Shift + Ren Mac) en la página que falla. - Caché de plugins: Si usas un plugin de caché como WP Rocket o W3 Total Cache, entra en su panel y pulsa el botón "Vaciar caché" o "Purgar caché".
- Caché del servidor: Si tu hosting tiene un panel como Syspanel (accesible por el puerto 2106), busca la opción de "Limpiar caché" o "Cache Manager" y haz clic en limpiar.
Si tras esto sigue el error, pasamos al siguiente paso.
Paso 2: Activar el modo de depuración (El detective)
WordPress puede contarte qué está fallando, pero necesitas pedírselo.
Este paso es clave para el WordPress troubleshooting.
Vamos a activar el modo de depuración (WP_DEBUG) para que los errores se muestren en pantalla en lugar de una pantalla en blanco.
[WARNING] Este paso es seguro, pero mostrará mensajes técnicos en tu web. No te asustes, es información para nosotros.
- Accede a tu hosting a través de Syspanel (recuerda, el puerto es el 2106).
- Entra en el Administrador de Archivos de tu dominio.
- Busca la carpeta
public_html(owww). - Busca el archivo
wp-config.php. Si no lo ves, activa la opción "Mostrar archivos ocultos". - Haz clic derecho sobre él y selecciona Editar.
- Busca la línea que dice
¡Eso es todo, deja de editar!. - Justo antes de esa línea, pega este código:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
- Guarda el archivo.
Ahora, recarga la página que daba error. Si ves un mensaje como Fatal error: ..., ¡genial! Ese mensaje te dice exactamente qué archivo está roto.
Anota el nombre del archivo que aparece en el error.
Paso 3: Desactivar todos los plugins (El sospechoso habitual)
El 80% de los errores WordPress son culpa de un plugin conflictivo.
Si no has podido ver el error del paso 2, o si el mensaje menciona un plugin, este es tu siguiente paso.
[INFO] No te preocupes, desactivar plugins no borra su configuración. Es como pausar una app en el móvil.
Forma fácil (desde el panel):
- Ve a
Plugins>Plugins instalados. - Selecciona todos los plugins con la casilla de arriba.
- En el desplegable "Acciones en bloque", elige Desactivar.
- Pulsa "Aplicar".
Ahora revisa tu web. ¿Funciona?
- Sí funciona: El problema es uno de tus plugins. Actívalos uno a uno hasta que la web se rompa. Ese es el culpable.
- No funciona: El problema no es de plugins. Continúa al siguiente paso.
Forma técnica (si no puedes entrar al panel):
Si la pantalla blanca WordPress te impide entrar al escritorio, usa el administrador de archivos de Syspanel.
- Ve a
public_html>wp-content. - Busca la carpeta
plugins. - Haz clic derecho sobre ella y selecciona Renombrar.
- Cámbiale el nombre a
plugins_desactivados.
Esto desactiva todos los plugins a la vez.
Cuando arregles el problema, vuelve a cambiar el nombre a plugins.
Paso 4: Revertir al tema por defecto
Si los plugins no eran el problema, el culpable puede ser tu tema.
Un tema mal actualizado o con errores de código puede romper todo.
- Ve a
Apariencia>Temas. - Activa un tema por defecto de WordPress, como Twenty Twenty-Four o Twenty Twenty-Three (si no lo tienes, instala uno nuevo desde "Añadir nuevo tema").
¿Se arregló? Entonces tu tema original tiene un conflicto.
Si no puedes entrar al panel, renombra la carpeta del tema en public_html > wp-content > themes.
Cámbiale el nombre a tema_temporal.
WordPress usará automáticamente un tema por defecto.
Paso 5: Aumentar el límite de memoria PHP (El error 500)
El error 500 WordPress es muy común y suele deberse a un agotamiento de memoria.
WordPress necesita memoria para funcionar, y a veces el límite que pone el servidor es muy bajo.
Aquí te digo cómo subirlo.
- Ve al archivo
wp-config.php(como en el paso 2). - Justo antes de la línea que dice
¡Eso es todo, deja de editar!, añade:
define('WP_MEMORY_LIMIT', '256M');
- Guarda y recarga.
Si no funciona, también puedes intentar editar el archivo .htaccess (en la raíz) y añadir al final:
php_value memory_limit 256M
[TIP] Si usas Syspanel, también puedes cambiar la versión de PHP desde el apartado "PHP Configuration". A veces, pasar de PHP 7.4 a PHP 8.1 soluciona muchos errores, pero a veces los rompe. Si cambias la versión y se rompe, vuelve a la anterior.
Paso 6: Reparar la base de datos
A veces la base de datos se corrompe o se llena de "basura" que causa errores.
WordPress tiene una herramienta de reparación integrada.
- Añade esta línea a tu
wp-config.php:
define('WP_ALLOW_REPAIR', true);
- Guarda el archivo.
- Ve a esta URL en tu navegador:
tudominio.com/wp-admin/maint/repair.php - Pulsa el botón "Reparar base de datos".
- Cuando termine, ELIMINA esa línea del
wp-config.phppor seguridad.
Paso 7: Comprobar los permisos de archivos
Los archivos de tu web tienen "permisos" que dicen quién puede leerlos y modificarlos.
Si están mal configurados, WordPress no puede guardar nada y da errores.
Usa el Administrador de Archivos de Syspanel.
- Selecciona la carpeta
public_html. - Haz clic derecho y elige "Permisos de archivos" o "Chmod".
- Las carpetas (directorios) deben estar en
755. - Los archivos (como
index.php) deben estar en644.
[WARNING] No pongas permisos 777 en todo, es un riesgo de seguridad grave.
Aplica los permisos correctos y prueba de nuevo.
Paso 8: Verificar el archivo .htaccess
Un archivo .htaccess corrupto causa errores 500 o de redireccionamiento.
- En el Administrador de Archivos, activa "Mostrar archivos ocultos".
- Renombra el archivo
.htaccessa.htaccess_viejo. - Ve a
Ajustes>Enlaces permanentesen tu panel de WordPress. - Pulsa "Guardar cambios" sin tocar nada.
Esto creará un nuevo .htaccess limpio.
Preguntas Frecuentes (FAQ) sobre Errores en WordPress
Aquí tienes las respuestas a las dudas más comunes que nos llegan al soporte.
¿Qué es la pantalla blanca de WordPress?
Es un error fatal que impide que la web se cargue.
Se llama "Pantalla Blanca de la Muerte" (WSOD).
Suele deberse a un plugin o tema con errores de código o a un agotamiento de memoria.
Para solucionarlo, sigue los pasos 3, 4 y 5 de esta lista.
¿Por qué veo el error 500 en mi web?
El error 500 es un error genérico del servidor.
Puede ser por un archivo .htaccess corrupto, un plugin problemático o falta de memoria PHP.
Revisa los pasos 3, 5 y 8 en ese orden.
¿Cómo sé si mi problema es de plugins o del tema?
La forma más rápida es desactivar todo (paso 3) y luego activar un tema por defecto (paso 4).
Si con todo desactivado y el tema por defecto sigue fallando, el problema es de WordPress o del servidor.
¿Es seguro editar el archivo wp-config.php?
Sí, es un archivo de configuración.
Solo debes tener cuidado de no borrar líneas importantes y de guardar siempre una copia antes de editarlo.
Si te equivocas, puedes restaurar la copia desde el Administrador de Archivos.
¿Qué pasa si nada de esto funciona?
Si has llegado hasta aquí y sigues con errores WordPress, es hora de contactar con tu proveedor de hosting.
Puede ser un problema del servidor (como un fallo de disco o una configuración de Apache/Nginx).
En tu panel de Syspanel (puerto 2106), busca la sección de "Tickets de Soporte" y envíales un mensaje explicando qué has probado y qué error ves exactamente.
Conclusión: No temas a los errores
Los errores son parte de tener una web.
Con esta lista de verificación, ya tienes el mapa para resolver el 95% de los problemas más comunes de WordPress.
Recuerda: siempre haz una copia de seguridad antes de empezar a trastear con archivos.
[TIP] La próxima vez que actualices un plugin o tema y veas un error, ya sabes por dónde empezar: desactiva lo último que tocaste.
Espero que esta guía te haya sido útil.
Si tienes dudas, déjalas en los comentarios y te echaré un cable.
¡Buena suerte con tu WordPress!
