🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Guía para solucionar errores comunes en WordPress desde cPanel

Actualizado el 18 de enero de 2026

¿Tu sitio en WordPress dejó de funcionar y ves una pantalla en blanco, un error de conexión a la base de datos o un mensaje de “Error al establecer conexión con la base de datos”? No te preocupes, es más común de lo que crees y, por suerte, la mayoría de estos problemas se pueden resolver directamente desde cPanel (o su equivalente, como Syspanel). En esta guía te explicamos paso a paso cómo solucionar los errores más frecuentes en WordPress usando las herramientas de tu panel de control, sin necesidad de ser un experto en desarrollo.

¿Qué necesitas para empezar?

Antes de lanzarte a solucionar errores, asegúrate de tener a mano:

  • Acceso a cPanel (o Syspanel): normalmente lo recibes al contratar tu hosting. Si usas Syspanel, recuerda que la URL de acceso suele ser tudominio.com:2106.
  • Credenciales de FTP o del administrador de archivos (usuario y contraseña).
  • Acceso a phpMyAdmin (para gestionar la base de datos).
  • Paciencia: muchos errores se resuelven en minutos si sigues el orden correcto.

1. Error de conexión a la base de datos (“Error establishing a database connection”)

Este es el error más temido, pero casi siempre tiene una solución sencilla. Significa que WordPress no puede comunicarse con la base de datos donde guarda tus contenidos.

### Paso 1: Verifica los datos de conexión en wp-config.php

  1. Entra a cPanel (o Syspanel por el puerto 2106).
  2. Busca la sección Archivos y haz clic en Administrador de archivos (File Manager).
  3. Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta como blog).
  4. Busca el archivo wp-config.php y haz clic derecho > Editar (o “View/Edit”).
  5. Revisa estas líneas: 
    define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');
    Asegúrate de que coincidan exactamente con los datos que te proporcionó tu hosting. Si no los recuerdas, puedes consultarlos en la sección Bases de datos MySQL de cPanel.

[TIP] Si el host no es “localhost”, puede ser algo como “mysql.tudominio.com”. Pregunta a tu proveedor o revisa el correo de bienvenida.

### Paso 2: Repara la base de datos desde phpMyAdmin

  1. En cPanel, ve a phpMyAdmin (dentro de Bases de datos).
  2. Selecciona la base de datos de tu WordPress (la misma que aparece en wp-config.php).
  3. Marca todas las tablas (puedes usar la casilla “Seleccionar todo”).
  4. En el menú desplegable de acciones, elige Reparar tabla.
  5. Espera unos segundos y verifica si el error desaparece.

[WARNING] Si la base de datos está corrupta, este proceso la repara sin perder datos. Si el error persiste, contacta a soporte técnico.

2. Pantalla blanca de la muerte (White Screen of Death)

Ves solo un fondo blanco en tu sitio. No hay mensajes de error, pero tampoco contenido. Esto suele deberse a un plugin o tema conflictivo, o a un límite de memoria excedido.

### Solución 1: Aumenta el límite de memoria de WordPress

  1. Desde el Administrador de archivos de cPanel, edita el archivo wp-config.php.
  2. Justo antes de la línea que dice /* That's all, stop editing! */, agrega: 
    define('WP_MEMORY_LIMIT', '256M');
  3. Guarda los cambios y recarga tu sitio.

### Solución 2: Desactiva todos los plugins (sin acceso al panel)

Si no puedes entrar al administrador de WordPress, hazlo desde cPanel:

  1. En el Administrador de archivos, ve a la carpeta /wp-content/plugins/.
  2. Cambia el nombre de la carpeta plugins a plugins_old (esto desactiva todos los plugins de golpe).
  3. Vuelve a cargar tu web. Si funciona, el problema está en uno de los plugins.
  4. Luego, ve renombrando las subcarpetas de plugins_old de una en una (por ejemplo, plugins_old/akismet a plugins/akismet) para identificar al culpable.

[INFO] Si el error se soluciona al renombrar la carpeta, significa que algún plugin está fallando. Puedes reinstalarlo o buscar una alternativa.

### Solución 3: Cambia temporalmente al tema por defecto

  1. En /wp-content/themes/, localiza la carpeta de tu tema activo (por ejemplo, mi-tema).
  2. Cámbiale el nombre a mi-tema_old.
  3. WordPress cargará automáticamente un tema por defecto (Twenty Twenty-Four, por ejemplo).
  4. Si el sitio aparece, el problema es de tu tema. Actualízalo o contacta al desarrollador.

3. Error 500 – Internal Server Error

Este error genérico indica que algo falla en el servidor, pero no da más detalles. Las causas más comunes son archivos .htaccess corruptos o problemas de permisos.

### Paso 1: Renombra el archivo .htaccess

  1. En el Administrador de archivos, busca el archivo .htaccess en la raíz de WordPress.
  2. Cámbiale el nombre a .htaccess_old.
  3. Vuelve a cargar tu sitio. Si funciona, el problema está en ese archivo.
  4. Para regenerarlo, ve a Ajustes > Enlaces permanentes en el panel de WordPress y haz clic en Guardar cambios (sin modificar nada).

### Paso 2: Revisa los permisos de archivos y carpetas

Los permisos incorrectos pueden provocar errores 500. Desde cPanel:

  1. Selecciona todos los archivos de la raíz (Ctrl + A).
  2. Haz clic derecho > Cambiar permisos.
  3. Aplica 755 para carpetas y 644 para archivos.
  4. Marca la opción “Recursivo” si aparece.

[WARNING] No uses permisos 777 (escritura total) porque es un riesgo de seguridad. Solo en casos muy específicos.

4. Error de “Estableciendo conexión con la base de datos” en la instalación

Si estás instalando WordPress por primera vez y te aparece este error, probablemente los datos de la base de datos no son correctos.

### Solución desde cPanel

  1. Ve a Bases de datos MySQL y crea una nueva base de datos (por ejemplo, mipagina_db).
  2. Crea un usuario (ej. mipagina_user) y asígnale todos los privilegios.
  3. Anota el nombre de la base, el usuario y la contraseña.
  4. Durante la instalación de WordPress, usa esos datos exactos. El host casi siempre es localhost.

[TIP] Si tu hosting usa Syspanel, el proceso es similar: busca la sección “Bases de datos” y sigue los mismos pasos.

5. Error de “Headers already sent” o “Cannot modify header information”

Este error aparece como un texto feo al principio de la página o en el panel de administración. Indica que hay un espacio o línea en blanco antes de la etiqueta <?php en algún archivo.

### Cómo localizar el archivo problemático

  1. Desde Administrador de archivos, revisa el archivo wp-config.php.
  2. Asegúrate de que no haya espacios ni líneas en blanco antes de <?php (debe ser la primera línea).
  3. También revisa functions.php de tu tema (en /wp-content/themes/tu-tema/).
  4. Si encuentras un espacio, bórralo y guarda.

[INFO] Este error suele ocurrir después de editar archivos con un editor que añade saltos de línea (como el bloc de notas de Windows). Usa editores como Notepad++ o el propio editor de cPanel.

6. Problemas de permisos de archivos (no puedes subir imágenes o instalar plugins)

Si al intentar subir una imagen ves “Fallo al escribir el archivo en el disco” o no puedes instalar plugins, los permisos de la carpeta wp-content/uploads están mal.

### Solución desde cPanel

  1. Ve a /wp-content/uploads/.
  2. Selecciona la carpeta y haz clic derecho > Cambiar permisos.
  3. Pon 755 y marca “Recursivo” (para que se aplique a todas las subcarpetas).
  4. Si el problema persiste, prueba con 775 temporalmente (pero luego vuelve a 755 por seguridad).

7. Error de “El enlace que has seguido ha caducado” al subir un tema o plugin

Esto ocurre cuando el archivo es demasiado grande y el servidor tiene un límite de tiempo de ejecución bajo.

### Solución desde cPanel

  1. Edita el archivo php.ini (si no existe, créalo en la raíz de WordPress).
  2. Agrega estas líneas: 
    max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 128M
  3. Guarda los cambios. Si tu hosting no permite editar php.ini, contacta a soporte.

[WARNING] No todos los hostings permiten modificar php.ini. En ese caso, usa un plugin como “WP Increase Upload Limits” o pide ayuda a tu proveedor.

8. Error de “No se puede conectar a la base de datos” después de migrar el sitio

Si cambiaste de hosting o de dominio, es muy común que los datos de conexión hayan cambiado.

### Solución rápida

  1. Edita wp-config.php desde el Administrador de archivos.
  2. Actualiza las constantes DB_NAME, DB_USER, DB_PASSWORD y DB_HOST con los datos del nuevo hosting.
  3. Si además cambiaste el dominio, debes actualizar las URLs en la base de datos. Puedes hacerlo con un plugin como “Better Search Replace” o desde phpMyAdmin ejecutando: 
    UPDATE wp_options SET option_value = 'https://nuevodominio.com' WHERE option_name = 'siteurl';
UPDATE wp_options SET option_value = 'https://nuevodominio.com' WHERE option_name = 'home';
    (Reemplaza wp_ por el prefijo de tus tablas si es diferente).

Preguntas Frecuentes (FAQ)

¿Qué hago si no tengo acceso a cPanel?

Pide las credenciales a tu proveedor de hosting. Si usas Syspanel, recuerda que la URL es tudominio.com:2106. Si no tienes acceso, solicita soporte técnico.

¿Puedo dañar mi sitio si modifico archivos desde cPanel?

Sí, pero siguiendo esta guía los cambios son reversibles. Siempre haz una copia de seguridad antes. En cPanel puedes usar la herramienta “Backup” para descargar todo tu sitio.

¿Por qué mi sitio sigue en blanco después de seguir todos los pasos?

Puede ser un problema del servidor (PHP desactualizado, límites de recursos). Contacta a tu hosting y pídeles que revisen los logs de error. También puedes activar el modo debug en WordPress añadiendo a wp-config.php:

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

Luego revisa el archivo wp-content/debug.log.

¿Es seguro usar Syspanel?

Sí, Syspanel es una alternativa moderna a cPanel, con funciones similares. Solo recuerda que el puerto de acceso es el 2106, no el 2083 como en cPanel.

¿Cada cuánto debo hacer mantenimiento a mi WordPress?

Recomendamos revisar permisos, actualizar plugins y temas, y hacer backups al menos una vez al mes. Los errores suelen aparecer después de actualizaciones, así que siempre prueba en un entorno de staging si es posible.

Conclusión

La mayoría de los errores comunes en WordPress se pueden resolver desde cPanel (o Syspanel) sin necesidad de ser un experto. Con solo saber usar el Administrador de archivos, phpMyAdmin y modificar algunos archivos de configuración, puedes recuperar tu sitio en minutos. Recuerda siempre:

  • Hacer una copia de seguridad antes de cualquier cambio.
  • Seguir el orden lógico: primero verifica la base de datos, luego los plugins y temas, y finalmente los permisos.
  • No entrar en pánico: los errores son parte del aprendizaje y, con esta guía, tienes las herramientas para solucionarlos.

Si después de todo el problema persiste, no dudes en contactar al soporte técnico de tu hosting. ¡Ellos están para ayudarte!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel