Errores comunes en WordPress y cómo solucionarlos con cPanel
¡Hola! Soy tu técnico de soporte amigable. ¿Estás teniendo problemas con tu WordPress? No te preocupes, es más común de lo que crees. A veces, la página se queda en blanco, no puedes acceder al panel de administración, o ves errores extraños. Lo bueno es que muchos de estos errores WordPress cPanel tienen solución desde el propio panel de control de tu hosting.
En esta guía, te voy a enseñar a solucionar errores WordPress usando cPanel (y si tu hosting usa Syspanel, recuerda que el acceso es por el puerto 2106). Vamos a ir paso a paso, como si estuviéramos viendo la pantalla juntos. No necesitas ser un experto, solo seguir las instrucciones.
Prepárate un café, vamos a ello.
1. El temido "Error al establecer conexión con la base de datos"
Este es, sin duda, uno de los problemas comunes WordPress más frustrantes. Ves tu web y solo aparece ese mensaje. No entres en pánico. Esto suele pasar porque WordPress no encuentra la base de datos o los datos de acceso son incorrectos.
¿Por qué ocurre?
- Cambiaste la contraseña de la base de datos desde cPanel y olvidaste actualizar WordPress.
- Moviste tu web a otro servidor y los datos no se actualizaron.
- La base de datos se corrompió o fue eliminada accidentalmente.
Solución paso a paso desde cPanel:
- Accede a cPanel. Normalmente es
tudominio.com/cpanelo te lo proporciona tu hosting. Si usas Syspanel, la dirección estudominio.com:2106. - Busca la sección "Bases de Datos" y haz clic en "phpMyAdmin".
- En phpMyAdmin, selecciona tu base de datos de WordPress (suele tener un nombre como
tuusuario_wpdb). - No necesitas hacer nada aquí de momento, solo confirma que la base de datos existe y tiene tablas (son como carpetas con nombres como
wp_options,wp_posts). Si no ves tablas, la base de datos está vacía y tendrás que restaurar una copia de seguridad. - Ahora, vuelve a cPanel y busca el "Administrador de Archivos".
- Navega hasta la carpeta donde está instalado tu WordPress (normalmente
public_htmlo una subcarpeta). - Busca el archivo
wp-config.phpy haz clic derecho sobre él. Selecciona "Editar". - Busca estas líneas:
define('DB_NAME', 'nombre_de_tu_bd'); define('DB_USER', 'usuario_de_tu_bd'); define('DB_PASSWORD', 'contraseña_de_tu_bd'); define('DB_HOST', 'localhost'); - Verifica que los datos coincidan exactamente con los de tu base de datos. Puedes encontrar el usuario y nombre de la BD en la sección "Bases de datos MySQL" de cPanel.
[TIP] El valor de
DB_HOSTcasi siempre eslocalhost. Si tu hosting usa un servidor de bases de datos externo, te lo habrán indicado. Si no estás seguro, dejalocalhost.
- Corrige la contraseña si la cambiaste. Guarda los cambios y cierra el archivo.
- Prueba tu web. Si no funciona, repite los pasos y asegúrate de que no hay espacios extra en las comillas.
2. Pantalla blanca de la muerte (WSOD – White Screen of Death)
Ves tu web y solo hay un fondo blanco. Nada más. Esto es otro clásico de los errores WordPress cPanel. La causa suele ser un plugin o tema defectuoso, o un límite de memoria PHP agotado.
Solución: Desactivar todo desde cPanel (sin acceso al admin)
Como no puedes entrar a tu panel de WordPress, lo haremos a la fuerza desde el administrador de archivos.
- Ve al "Administrador de Archivos" en cPanel.
- Entra a la carpeta
public_html(o donde tengas WordPress). - Busca la carpeta
wp-content. - Dentro de
wp-content, busca la carpetaplugins. - Cambia el nombre de la carpeta
pluginsa algo comoplugins_desactivados. Esto obliga a WordPress a no encontrar ningún plugin, desactivándolos todos. - Vuelve a cargar tu web. Si funciona, el problema era un plugin.
- Para saber cuál, crea una nueva carpeta llamada
plugins(vacía). - Dentro de
plugins, ve creando subcarpetas con el nombre de cada plugin que tenías (ej:akismet,yoast, etc.) y ve moviendo los archivos deplugins_desactivadosa su carpeta correspondiente, uno por uno. Después de cada movimiento, prueba la web. Cuando deje de funcionar, ¡ese es el plugin culpable!
- Para saber cuál, crea una nueva carpeta llamada
- Si la web sigue en blanco, el problema puede ser el tema.
- En
wp-content, busca la carpeta de tu tema activo (normalmente se llama como el tema, ej:twentytwentyfour). - Cambia su nombre a
tema_desactivado. - WordPress usará un tema por defecto (como Twenty Twenty-Four). Si la web funciona, el tema era el problema. Instala uno nuevo desde el panel de admin.
- En
Aumentar la memoria PHP (otra causa común)
- En el "Administrador de Archivos", busca el archivo
wp-config.php. - Edítalo y, justo antes de la línea que dice
/* That's all, stop editing! Happy blogging. */, añade esta línea:define('WP_MEMORY_LIMIT', '256M'); - Guarda los cambios. Esto le da más memoria a WordPress.
[WARNING] No aumentes la memoria a más de 512M a menos que sepas lo que haces. Podría saturar el servidor.
3. Error 500 – Internal Server Error
Un error 500 es genérico, pero casi siempre se debe a un archivo .htaccess dañado o a un plugin con un error de sintaxis.
Solución: Regenerar el .htaccess
- En el "Administrador de Archivos", activa la opción "Mostrar archivos ocultos" (suele ser un botón en la esquina superior derecha).
- Busca el archivo
.htaccessen la raíz de tu WordPress (public_html). - Renómbralo a
.htaccess_viejo(esto lo desactiva). - Ve a tu web. Si funciona, el
.htaccessestaba corrupto. - Ahora, entra a tu panel de WordPress (si puedes, si no, continúa).
- Ve a Ajustes > Enlaces permanentes.
- Simplemente haz clic en "Guardar cambios" (no necesitas cambiar nada). Esto regenera un
.htaccessnuevo y limpio.
Depuración de plugins (otra causa del error 500)
Si el error persiste, sigue los mismos pasos que para la Pantalla Blanca: desactiva todos los plugins renombrando la carpeta plugins.
4. Error 403 – Forbidden (Acceso prohibido)
Este error suele indicar un problema de permisos de archivos. Has puesto los permisos demasiado restrictivos.
Solución: Revisar permisos desde cPanel
Los archivos de WordPress deben tener permisos 644 y las carpetas 755.
- En el "Administrador de Archivos", selecciona todos los archivos de la raíz de tu WordPress (puedes hacer Ctrl+E o el botón "Seleccionar todo").
- Haz clic derecho y selecciona "Cambiar permisos".
- Marca las casillas para que quede así:
- Archivos:
644(Propietario: Lectura/Escritura, Grupo: Lectura, Público: Lectura). - Carpetas:
755(Propietario: Lectura/Escritura/Ejecución, Grupo: Lectura/Ejecución, Público: Lectura/Ejecución).
- Archivos:
- Aplica los cambios.
[INFO] No es recomendable poner permisos
777a nada. Es un agujero de seguridad. Solo algunos plugins de caché lo piden temporalmente.
5. El administrador de archivos no carga o tarda mucho
A veces, el propio cPanel va lento. No te preocupes, hay otra forma de acceder a los archivos.
Solución alternativa: FTP o File Manager en Syspanel
- Con FTP: Usa un cliente como FileZilla con los datos que te proporcionó tu hosting (servidor, usuario, contraseña, puerto 21).
- Con Syspanel: Si tu hosting usa Syspanel (puerto 2106), dentro del panel hay un gestor de archivos muy rápido. Simplemente accede a
tudominio.com:2106, busca la sección "Archivos" y listo.
FAQ WordPress cPanel: Preguntas frecuentes
Aquí tienes las dudas más comunes que resuelvo a diario.
¿Puedo dañar mi web editando archivos desde cPanel?
Sí, si no sabes lo que haces. Pero si solo tocas lo que te indico aquí (renombrar carpetas de plugins, editar wp-config.php para cambiar la contraseña de la BD, o regenerar el .htaccess), es bastante seguro. Siempre puedes deshacer el cambio. Si tienes dudas, haz una copia de seguridad antes desde la sección "Copias de seguridad" de cPanel.
¿Y si no encuentro el archivo wp-config.php?
A veces está en una carpeta superior a public_html. Revisa también en la raíz del dominio. Si usas un hosting con subdominios, cada subdominio tiene su propia carpeta.
¿Cómo restauro mi web desde una copia de seguridad en cPanel?
- Ve a la sección "Copias de seguridad" en cPanel.
- Descarga la copia de seguridad completa (Home Directory) y la de la base de datos.
- Para restaurar, sube los archivos por FTP y luego importa la base de datos desde phpMyAdmin. Es un proceso más largo, pero es tu salvavidas.
Mi web va muy lenta, ¿cómo lo soluciono desde cPanel?
No es un error como tal, pero es un problema común WordPress. Puedes:
- Activar la caché: Muchos hostings tienen un plugin de caché integrado o puedes instalar uno como WP Rocket o W3 Total Cache.
- Optimizar imágenes: No desde cPanel, sino con un plugin como Smush o ShortPixel.
- Ver el uso de recursos: En cPanel, busca la sección "Estadísticas" o "Uso de recursos". Si tu web consume mucha CPU, puede que necesites más recursos de hosting.
No puedo acceder a cPanel, ¿qué hago?
Prueba con tudominio.com/cpanel o tudominio.com:2083. Si no funciona, contacta con tu proveedor de hosting. También puedes preguntar si usan Syspanel, en cuyo caso la URL sería tudominio.com:2106.
Conclusión: No temas a cPanel
Como has visto, muchos errores WordPress cPanel tienen una solución sencilla que puedes aplicar tú mismo. La clave está en mantener la calma, seguir los pasos de solucionar errores WordPress que te he dado, y siempre, siempre, tener una copia de seguridad reciente.
Si después de todo esto tu WordPress no funciona cPanel y el error persiste, no dudes en abrir un ticket con tu soporte técnico. Diles exactamente qué has hecho (ej: "Renombré la carpeta plugins y el error 500 desapareció, pero al reactivar el plugin X volvió"). Así te ayudarán mucho más rápido.
Recuerda: cPanel es tu mejor amigo para el mantenimiento de WordPress. Con práctica, te volverás un experto. ¡Mucho ánimo!
