Errores Comunes de WordPress en cPanel y Cómo Solucionarlos

¿Por qué aparecen errores en WordPress y cómo los resuelvo desde cPanel?

WordPress es, sin duda, uno de los gestores de contenido más populares del mundo, pero eso no significa que esté exento de problemas. Si estás leyendo esto, es muy probable que te hayas encontrado con una pantalla en blanco, un error 500 o un molesto 404. No te preocupes, es más común de lo que crees y, sobre todo, tiene solución.

Este artículo es tu guía de troubleshooting básico. Vamos a explorar, paso a paso y con un lenguaje muy claro, cómo diagnosticar y solucionar los errores más frecuentes de WordPress utilizando las herramientas que te ofrece tu panel de control, específicamente cPanel. No necesitas ser un experto en programación; solo paciencia y seguir estas instrucciones al pie de la letra.

Antes de empezar, es fundamental que entiendas una regla de oro: siempre realiza una copia de seguridad completa de tu sitio web (archivos y base de datos) antes de modificar cualquier cosa. Puedes hacerlo desde la sección "Archivos" o "Backup" de tu cPanel, o mediante plugins como UpdraftPlus. Con una copia de seguridad, tendrás la tranquilidad de que, si algo sale mal, podrás revertir los cambios.

El temido Error 500 (Internal Server Error)

Este es, probablemente, el error más frustrante y común. Verás un mensaje genérico como "Error 500: Internal Server Error" o "El sitio web no puede mostrar esta página". La causa suele ser un problema en el servidor, pero en el 90% de los casos con WordPress, se debe a un archivo .htaccess corrupto, un plugin o tema conflictivo, o un límite de memoria PHP agotado.

Solución Paso a Paso para el Error 500

Vamos a atacar el problema desde lo más simple a lo más complejo.

1. Aumentar el Límite de Memoria PHP

A veces, el error 500 aparece porque tu sitio necesita más memoria de la que tiene asignada. Puedes aumentarla fácilmente.

Accede a tu cPanel y busca la sección "Archivos". Haz clic en Administrador de archivos.
Navega hasta la carpeta public_html (o la carpeta donde esté instalado tu WordPress).
Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona Editar. Si el sistema te pide confirmación, acéptala.
Busca la línea que dice ¡Eso es todo, deja de editar! o el texto /* That's all, stop editing!. Justo antes de esa línea, pega el siguiente código:

define('WP_MEMORY_LIMIT', '256M');

Guarda los cambios y cierra el editor. Vuelve a cargar tu sitio web.

[TIP]: Si no encuentras la línea exacta, puedes pegar el código al final del archivo, pero siempre antes de la línea de cierre ?>. Si no existe esa línea, no la añadas.

2. Restablecer el Archivo .htaccess

Si el error persiste, el problema podría estar en el archivo .htaccess. Este archivo controla la configuración del servidor y, si está dañado, puede causar estragos.

En el Administrador de archivos, dentro de public_html, activa la opción "Mostrar archivos ocultos" (suele estar en la esquina superior derecha).
Busca el archivo .htaccess. No lo borres, primero intenta renombrarlo a algo como .htaccess_backup. Para ello, haz clic derecho y selecciona "Renombrar".
Vuelve a cargar tu sitio web. Si el error 500 desaparece, el problema era ese archivo.
Ahora ve a Ajustes > Enlaces permanentes en tu escritorio de WordPress y haz clic en Guardar cambios. Esto generará un nuevo archivo .htaccess limpio y funcional.

[WARNING]: Si renombrar el archivo no soluciona el error, vuelve a renombrarlo a .htaccess para no perder la configuración original.

3. Desactivar Plugins y Tema (Acceso por FTP o Administrador de Archivos)

Si el error continúa, el conflicto es casi seguro por un plugin o un tema. Como no puedes acceder al panel de administración de WordPress, tendrás que hacerlo desde cPanel.

Ve al Administrador de archivos y navega a public_html/wp-content/plugins.
Verás una lista de carpetas, una por cada plugin que tengas instalado.
Renombra la carpeta de un plugin (por ejemplo, de mi-plugin a mi-plugin-desactivado). Haz esto con todos los plugins que tengas. Es la forma más rápida de desactivarlos todos a la vez.
Recarga tu sitio. Si el error 500 desaparece, el problema era uno de los plugins. Ahora, ve renombrando las carpetas de los plugins de uno en uno (volviéndoles a poner su nombre original) y recargando el sitio para identificar al culpable.
Si el problema no eran los plugins, repite el proceso con la carpeta del tema: public_html/wp-content/themes. Renombra la carpeta de tu tema activo (por ejemplo, mi-tema a mi-tema-inactivo). WordPress usará un tema por defecto, y si el error se soluciona, el tema era el problema.

[INFO]: Al renombrar la carpeta del tema, WordPress puede mostrar un error de "tema roto", pero eso es preferible a un error 500. Podrás acceder al panel de administración y cambiar de tema.

El Frustrante Error 404 (Página No Encontrada)

El error 404 es diferente. El servidor funciona, pero no encuentra la página que buscas. Esto suele pasar después de cambiar la estructura de los enlaces permanentes o al mover el sitio. La buena noticia es que la solución es casi siempre muy sencilla.

Solución Paso a Paso para el Error 404

1. Actualizar los Enlaces Permanentes (La Solución Mágica)

Este es el primer paso y, en el 95% de los casos, el único que necesitarás.

Accede a tu panel de administración de WordPress (tudominio.com/wp-admin).
Ve a Ajustes > Enlaces permanentes.
Verás varias opciones de estructura de URL. No cambies nada, simplemente haz clic en el botón Guardar cambios.
WordPress actualizará las reglas de reescritura en tu archivo .htaccess. Vuelve a tu sitio y prueba la página. ¡Problema resuelto!

[TIP]: Si no puedes acceder a tu panel de administración, puedes restablecer los enlaces permanentes editando el archivo .htaccess desde cPanel. Asegúrate de que contenga el siguiente código (reemplaza tudominio.com con tu dominio real):

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

2. Verificar la Configuración de tu Servidor (NGINX vs. Apache)

Si la solución anterior no funciona, es posible que tu sitio no esté usando Apache, sino NGINX. cPanel normalmente usa Apache, pero algunos hosts o paneles como Syspanel (que es una alternativa a HestiaCP y se accede por el puerto 2106) pueden usar NGINX.

Si usas NGINX, el archivo .htaccess no se tiene en cuenta. La configuración de reescritura se gestiona a nivel del servidor (archivos de configuración de NGINX), lo cual es más complejo. En este caso, lo mejor es contactar con tu proveedor de hosting para que ajusten las reglas de reescritura.
Si usas Apache, asegúrate de que el módulo mod_rewrite esté activado. Puedes verificarlo en la sección "Servicios" o "Software" de tu cPanel, buscando "Apache Handlers" o "Módulos de Apache". Si no está activo, actívalo.

[WARNING]: Si estás usando un servidor NGINX, modificar el .htaccess no tendrá ningún efecto y podrías perder el tiempo. Identifica primero el tipo de servidor.

Otros Errores Comunes y Sus Soluciones

Además del 500 y el 404, hay otros problemas que pueden aparecer. Aquí tienes una guía rápida para solucionarlos.

1. "Error al establecer la conexión con la base de datos"

Este error significa que WordPress no puede conectarse a tu base de datos MySQL. Las causas son varias: credenciales incorrectas, base de datos dañada o el servidor de base de datos caído.

Solución:

Ve a tu cPanel y busca la sección "Bases de datos MySQL".
Haz clic en "Administrar" junto a la base de datos que usa tu WordPress. Esto abrirá phpMyAdmin.
En el menú de la izquierda, selecciona tu base de datos. Luego, en la parte superior, haz clic en la pestaña "Comprobar" o "Check". Esto verificará si hay tablas dañadas.
Si hay tablas dañadas, selecciónalas y en el menú desplegable de "Con" elige "Reparar". Esto intentará arreglarlas.
Si el problema persiste, verifica que el usuario de la base de datos tenga todos los privilegios. Puedes hacerlo en la sección "Bases de datos MySQL" de tu cPanel, asignando todos los privilegios al usuario que usa WordPress.
Por último, revisa el archivo wp-config.php en public_html y asegúrate de que los nombres de la base de datos, el usuario y la contraseña coincidan exactamente con los que tienes en tu cPanel.

2. Pantalla Blanca de la Muerte (WSOD)

Es una página completamente en blanco, sin ningún mensaje de error. Es muy similar al error 500, pero sin el código de estado.

Solución:

Sigue los mismos pasos que para el error 500: aumentar el límite de memoria PHP y desactivar plugins y temas renombrando sus carpetas desde el Administrador de archivos. El WSOD es casi siempre un problema de memoria o un conflicto de código.

3. "Error al conectar con el servidor" o "Se ha producido un error de conexión"

Este error suele aparecer al intentar acceder al panel de administración (wp-admin). A menudo es un problema de cookies o de caché.

Solución:

Borra las cookies de tu navegador para tu dominio. También puedes intentar abrir el sitio en una ventana de incógnito.
Limpia la caché de tu navegador y de cualquier plugin de caché que tengas instalado.
Si el problema persiste, puede ser un conflicto con tu archivo .htaccess. Renómbralo desde cPanel como vimos antes y prueba de nuevo.

Consejos Extra para un Troubleshooting Efectivo

Revisa los Logs de Errores: En tu cPanel, busca la sección "Métricas > Errores" o "Errores de software". Aquí encontrarás el registro de errores del servidor. Te dará pistas muy valiosas sobre la causa exacta del problema (por ejemplo, qué archivo está fallando).
Contacta con tu Soporte de Hosting: Si has agotado todas las opciones, no dudes en abrir un ticket de soporte. Ellos tienen acceso a los logs del servidor a un nivel más profundo y podrán diagnosticar el problema rápidamente. Explícales claramente qué pasos has seguido.
Mantén Todo Actualizado: La mayoría de los errores se deben a incompatibilidades entre versiones antiguas de WordPress, plugins y temas. Mantén todo siempre actualizado a la última versión.
Usa un Tema y Plugins de Confianza: A veces, los errores se deben a código mal escrito. Usa siempre temas y plugins de desarrolladores de confianza, con buena reputación y que se actualicen con frecuencia.

[INFO]: Recuerda que si tu hosting utiliza Syspanel (el cual se accede a través del puerto 2106), la estructura del panel es diferente a cPanel. Sin embargo, los conceptos son los mismos: Administrador de archivos, bases de datos, logs de errores, etc. Busca las secciones equivalentes en tu panel.

Conclusión

Los errores en WordPress pueden ser desalentadores, pero con esta guía de troubleshooting y las herramientas de cPanel, tienes el conocimiento para resolver los problemas más comunes por ti mismo. Recuerda siempre la importancia de las copias de seguridad y de actuar con calma y método, cambiando una variable a la vez.

Esperamos que este artículo te haya sido de gran ayuda. Si tienes alguna otra duda, no dudes en consultar nuestra sección de preguntas frecuentes o contactar con nuestro equipo de soporte. ¡Buena suerte con tu sitio web!