Errores comunes en WordPress: FAQ y soluciones rápidas

¿Por qué mi WordPress muestra una pantalla en blanco? Causas y soluciones

Uno de los errores WordPress comunes más alarmantes es la temida pantalla blanca, también conocida como "White Screen of Death" (WSOD). No te preocupes, es frustrante pero normalmente tiene solución. Este error ocurre cuando PHP se queda sin memoria o encuentra un conflicto grave.

Causas principales de la pantalla blanca

Límite de memoria de PHP agotado: Tu sitio necesita más memoria de la que el servidor le asigna.
Plugin o tema defectuoso: Una actualización o un código mal escrito provoca el fallo.
Archivo .htaccess corrupto: Reglas incorrectas pueden bloquear la carga.
Problemas con el núcleo de WordPress: Archivos esenciales dañados o incompletos.

Solución paso a paso para la pantalla blanca

Accede a tu panel de control (Syspanel).
- Abre tu navegador y escribe http://tudominio.com:2106 (este es el puerto de acceso a Syspanel).
- Inicia sesión con tus credenciales de hosting.
Aumenta el límite de memoria de PHP temporalmente.
- En Syspanel, busca la sección "Administrador de archivos" o "File Manager".
- Navega a la carpeta public_html y localiza el archivo wp-config.php.
- Ábrelo con el editor de texto y añade esta línea justo antes de donde dice /* That's all, stop editing! */:
```
define('WP_MEMORY_LIMIT', '256M');
```
- Guarda los cambios y recarga tu sitio.
Desactiva todos los plugins desde el administrador de archivos.
- Si no puedes acceder al panel de WordPress, renombra la carpeta wp-content/plugins a wp-content/plugins_old.
- Esto desactivará todos los plugins de golpe. Si el sitio vuelve a funcionar, el problema está en uno de ellos.
- Ve renombrando los plugins de uno en uno (vuelve a llamar la carpeta plugins y renombra cada subcarpeta) para identificar el culpable.
Cambia temporalmente al tema por defecto.
- Accede a la carpeta wp-content/themes.
- Renombra la carpeta de tu tema activo (por ejemplo, mistema a mistema_old).
- WordPress cargará automáticamente un tema por defecto (Twenty Twenty-Four o similar).
- Si el error desaparece, el problema está en tu tema.

[TIP] Si tras estos pasos la pantalla sigue blanca, revisa los logs de errores de PHP en Syspanel (sección "Registros de errores") para obtener pistas más precisas.

Error de base de datos en WordPress: ¿Cómo conectarse de nuevo?

El error base de datos WordPress suele aparecer con un mensaje como "Error al establecer conexión con la base de datos". Esto impide que tu sitio cargue cualquier contenido.

Causas comunes del error de base de datos

Credenciales incorrectas: Los datos de acceso a la base de datos en wp-config.php no coinciden con los reales.
Base de datos corrupta: Puede ocurrir tras una migración fallida o un corte de energía.
Servidor de base de datos caído: El servicio MySQL/MariaDB no está funcionando en el servidor.
Tablas dañadas: Algunas tablas de WordPress necesitan reparación.

Solución paso a paso para el error de base de datos

Verifica las credenciales en wp-config.php.
- Accede a Syspanel (puerto 2106) y abre el archivo wp-config.php desde el Administrador de archivos.
- Busca estas líneas y asegúrate de que coincidan con los datos de tu base de datos:
```
define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');
```
- Si no estás seguro de los datos, consulta la sección "Bases de datos" en Syspanel para ver las credenciales correctas.
Repara la base de datos desde wp-config.php.
- Añade esta línea en wp-config.php, justo antes de la línea /* That's all, stop editing! */:
```
define('WP_ALLOW_REPAIR', true);
```
- Guarda el archivo y visita en tu navegador: http://tudominio.com/wp-admin/maint/repair.php.
- Verás una pantalla con opciones para reparar y optimizar la base de datos. Haz clic en "Reparar base de datos".
- Una vez terminado, borra esa línea de wp-config.php inmediatamente por seguridad.
Reinicia el servicio de base de datos desde Syspanel.
- En Syspanel, busca la sección "Servicios" o "Services".
- Localiza "MySQL" o "MariaDB" y haz clic en "Reiniciar".
- Espera unos segundos y vuelve a cargar tu sitio.
Restaura una copia de seguridad reciente.
- Si nada funciona, restaura la base de datos desde una copia de seguridad previa.
- En Syspanel, ve a "Base de datos" > "phpMyAdmin".
- Selecciona tu base de datos, ve a la pestaña "Importar" y sube el archivo SQL de respaldo.

[WARNING] Nunca dejes la línea WP_ALLOW_REPAIR activada permanentemente, ya que cualquiera podría reparar (o dañar) tu base de datos sin autenticación.

Error 500 Internal Server Error en WordPress

El error 500 es otro de los errores WordPress comunes que indica un problema interno del servidor, pero sin dar detalles. Suele estar relacionado con archivos del sistema o configuraciones.

Causas del error 500

Archivo .htaccess dañado: Reglas incorrectas de reescritura.
Permisos de archivos incorrectos: Archivos con permisos demasiado restrictivos o abiertos.
Plugin o tema incompatible: Un código mal optimizado genera un error fatal.
PHP con límite de ejecución excedido: Scripts que tardan demasiado.

Solución paso a paso para el error 500

Renombra el archivo .htaccess temporalmente.
- Desde el Administrador de archivos de Syspanel, ve a public_html.
- Localiza el archivo .htaccess (puede estar oculto, activa "Mostrar archivos ocultos").
- Cámbiale el nombre a .htaccess_old.
- Prueba tu sitio. Si funciona, el problema está en las reglas. Ve a Ajustes > Enlaces permanentes en WordPress y guarda los cambios para regenerar el .htaccess.
Verifica los permisos de archivos y carpetas.
- Los archivos deben tener permisos 644 y las carpetas 755.
- En Syspanel, selecciona toda la carpeta public_html y en la opción "Permisos" establece 755 para carpetas y 644 para archivos (o usa la opción de "Corregir permisos" si existe).
Aumenta el límite de tiempo de ejecución de PHP.
- Crea un archivo llamado php.ini en public_html (si no existe).
- Añade esta línea:
```
max_execution_time = 300
```
- Guarda y prueba.

[INFO] Si el error 500 persiste, revisa los logs de errores en Syspanel (sección "Registros de errores" o "Error logs"). Busca la línea que contiene "PHP Fatal error" para identificar el archivo problemático.

Error de conexión segura (SSL) en WordPress

Cuando ves "Su conexión no es privada" o el sitio carga con HTTP en lugar de HTTPS, es un problema de SSL común.

Causas del error SSL

Certificado SSL no instalado o caducado.
Contenido mixto: Imágenes o scripts cargados desde HTTP en un sitio HTTPS.
Redirección incorrecta: No se fuerza HTTPS desde WordPress o el servidor.

Solución paso a paso para el error SSL

Verifica que el certificado SSL esté activo en Syspanel.
- En Syspanel, busca la sección "SSL" o "Certificados SSL".
- Asegúrate de que tu dominio tenga un certificado válido (puede ser Let's Encrypt gratuito).
- Si no lo tiene, solicita uno nuevo desde la misma interfaz.
Configura WordPress para usar HTTPS.
- Accede a tu panel de WordPress (si puedes) o edita wp-config.php.
- Añade estas líneas:
```
define('FORCE_SSL_ADMIN', true);
$_SERVER['HTTPS'] = 'on';
```
- Guarda los cambios.
Corrige el contenido mixto.
- Instala un plugin como "Really Simple SSL" que detecta y corrige URLs HTTP automáticamente.
- O usa un plugin de búsqueda y reemplazo (como "Better Search Replace") para cambiar http://tudominio.com por https://tudominio.com en toda la base de datos.

[TIP] Después de activar HTTPS, ve a Ajustes > Generales en WordPress y actualiza las URLs de "Dirección de WordPress" y "Dirección del sitio" para que empiecen con https://.

Error al subir imágenes: "Fallo al procesar la imagen"

Este error suele aparecer al subir imágenes grandes o con formatos no soportados.

Causas del error al subir imágenes

Tamaño de archivo excesivo: Supera el límite permitido por PHP.
Formato no soportado: Archivos .webp o .svg pueden requerir configuraciones especiales.
Permisos de carpeta incorrectos: La carpeta uploads no tiene permisos de escritura.

Solución paso a paso

Aumenta el límite de subida de archivos.
- En Syspanel, ve a "Ajustes de PHP" o "PHP Settings".
- Busca upload_max_filesize y post_max_size y cámbialos a un valor mayor (por ejemplo, 64M).
- Guarda y reinicia PHP si es necesario.
Verifica los permisos de la carpeta uploads.
- En el Administrador de archivos, ve a wp-content/uploads.
- Asegúrate de que la carpeta tenga permisos 755 y que exista una subcarpeta para el año y mes actuales (ej. 2024/10).
- Si no existe, créala manualmente.
Convierte la imagen a un formato compatible.
- Usa herramientas online o de escritorio para convertir la imagen a JPEG o PNG antes de subirla.
- Reduce su tamaño a menos de 2 MB si es posible.

[WARNING] No subas archivos .exe, .php o .html en la galería de medios, ya que WordPress los bloqueará por seguridad.

Error de actualización de WordPress: "La actualización falló"

Cuando intentas actualizar WordPress, el núcleo, un plugin o un tema, puede aparecer este error.

Causas del error de actualización

Permisos de archivos insuficientes: El servidor no puede escribir en los archivos.
Falta de memoria PHP: El proceso de actualización requiere más recursos.
Conexión a internet inestable: Durante la descarga del paquete.
Conflictos con plugins de seguridad: Algunos bloquean las actualizaciones.

Solución paso a paso

Aumenta la memoria PHP temporalmente (como en el paso 1 de la pantalla blanca).
Desactiva temporalmente los plugins de seguridad (Wordfence, Sucuri, etc.) desde el administrador de archivos renombrando sus carpetas.
Realiza la actualización manualmente:
- Descarga la última versión de WordPress desde wordpress.org.
- Descomprime el archivo en tu computadora.
- Sube la carpeta wp-admin y wp-includes (y el archivo wp-content solo si no tienes personalizaciones) a tu servidor mediante FTP o el Administrador de archivos de Syspanel, sobrescribiendo los existentes.
- Luego, ve a /wp-admin/upgrade.php para completar la actualización de la base de datos.

[INFO] Siempre haz una copia de seguridad completa (archivos y base de datos) antes de cualquier actualización. En Syspanel, usa la función "Backup" para crear una copia de seguridad fácilmente.

Preguntas frecuentes adicionales sobre errores en WordPress

¿Por qué mi sitio carga muy lento?

Causas: Plugins pesados, imágenes sin optimizar, hosting compartido saturado, falta de caché.
Soluciones: Instala un plugin de caché (como W3 Total Cache), optimiza imágenes con Smush, y considera migrar a un plan de hosting más potente.

¿Cómo recupero mi sitio si no puedo acceder al panel de administración?

Usa el Administrador de archivos de Syspanel para desactivar plugins o cambiar temas.
Si el problema persiste, restaura una copia de seguridad desde Syspanel (sección "Backup").

¿Qué hago si veo "Error de sintaxis, error inesperado"?

Este error suele aparecer al editar archivos PHP (como functions.php) y olvidar un punto y coma o cerrar una llave.
Accede al archivo mediante Syspanel, busca la línea indicada en el mensaje de error y corrige la sintaxis. Si no ves el error, revisa el archivo con un editor de código que resalte la sintaxis.

¿El error "No se puede establecer conexión con el servidor FTP" al instalar plugins?

WordPress a veces pide credenciales FTP si no tiene permisos de escritura.
Solución: En wp-config.php, añade estas líneas para forzar el uso del sistema de archivos directo:
```
define('FS_METHOD', 'direct');
```
Esto evita la necesidad de FTP.

Conclusión: Mantén tu WordPress saludable

Los errores WordPress comunes son parte del día a día, pero con estas soluciones podrás resolver la mayoría sin ayuda técnica. Recuerda:

Siempre mantén copias de seguridad actualizadas.
Actualiza WordPress, plugins y temas regularmente.
Usa un hosting confiable como el que ofrece Syspanel (accesible por puerto 2106) para tener herramientas de administración fáciles.
Si un error persiste, no dudes en contactar al soporte técnico de tu hosting.

Con paciencia y estos pasos, tu sitio volverá a funcionar en minutos. ¡Ánimo!