Solucionar error 500 en WordPress por permisos de archivos

¿Por qué aparece el error 500 en WordPress y qué tienen que ver los permisos?

El temido error 500 en WordPress es uno de los problemas más comunes y, a la vez, más frustrantes para cualquier persona que gestiona una web. Ver una pantalla en blanco con el texto "Error 500 – Internal Server Error" puede generar pánico, pero te aseguro que en la mayoría de los casos tiene una solución clara y accesible.

Este error, en esencia, significa que el servidor encontró una condición inesperada que le impidió completar la solicitud. No es un problema de tu navegador ni de tu conexión a internet; es un problema del lado del servidor donde se aloja tu sitio web.

Uno de los culpables más frecuentes detrás de este error son los permisos de archivos incorrectos. Cada archivo y carpeta en tu hosting tiene un conjunto de permisos que determinan quién puede leer, escribir o ejecutar. Si estos valores se configuran de forma incorrecta, el servidor web (como Apache o Nginx) puede bloquear el acceso a los archivos esenciales de WordPress, provocando el error 500.

En esta guía extensa y práctica, vamos a desglosar, paso a paso y sin tecnicismos innecesarios, cómo solucionar el error 500 en WordPress corrigiendo los permisos de archivos. Además, hablaremos de otras causas comunes y te daremos trucos que te ahorrarán muchos dolores de cabeza.

Entendiendo los permisos de archivos: La base de todo

Antes de lanzarnos a cambiar cosas, es fundamental entender qué son esos famosos permisos y cómo funcionan. Imagina que tu hosting es un edificio de oficinas. Las carpetas son las salas y los archivos son los documentos que hay dentro. Los permisos son las llaves que deciden quién puede entrar, quién puede leer los documentos y quién puede modificarlos o tirarlos a la basura.

En el mundo de Linux (el sistema operativo que usan la mayoría de los hostings), estos permisos se representan con números. Verás códigos como 644, 755, 600 o 777. Vamos a descifrarlos:

• El primer número corresponde a los permisos del propietario del archivo (normalmente, tu usuario de hosting).
• El segundo número corresponde a los permisos del grupo (un conjunto de usuarios, a menudo el grupo del servidor web).
• El tercer número corresponde a los permisos de otros (cualquier otro usuario del sistema).

Cada número es la suma de tres valores:

• 4 = Permiso de lectura (Read).
• 2 = Permiso de escritura (Write).
• 1 = Permiso de ejecución (Execute).

Por lo tanto:

• 755: El propietario puede leer, escribir y ejecutar (4+2+1=7). El grupo y otros pueden leer y ejecutar (4+1=5). Este es el valor estándar para carpetas en la mayoría de los hostings.
• 644: El propietario puede leer y escribir (4+2=6). El grupo y otros solo pueden leer (4). Este es el valor estándar para archivos en la mayoría de los hostings.
• 777: Todos pueden hacer todo. Es un permiso muy inseguro y rara vez necesario. Evítalo a menos que sea absolutamente imprescindible y temporal.

[INFO] Si tu web está en un hosting compartido, es muy probable que los valores correctos sean 755 para carpetas y 644 para archivos. Esta es la configuración que busca el 99% de los servidores.

El primer paso: Accede a tu hosting y verifica los permisos

Para solucionar el error 500, necesitas acceder a los archivos de tu WordPress. Tienes dos herramientas principales: el Administrador de Archivos de tu panel de control (como cPanel, Plesk o Syspanel) o un Cliente FTP (como FileZilla). Para esta guía, usaremos el Administrador de Archivos, que es más visual y no requiere instalar nada.

[INFO] Si tu hosting utiliza Syspanel (anteriormente conocido como HestiaCP), recuerda que el acceso se realiza a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Una vez dentro, busca la sección "Administrador de Archivos".

Ahora, sigue estos pasos para revisar los permisos actuales:

1. Accede a tu panel de control de hosting.
2. Abre el Administrador de Archivos.
3. Navega hasta la carpeta raíz de tu WordPress. Normalmente se llama public_html, htdocs o www. Es donde están las carpetas wp-admin, wp-content y wp-includes.
4. Selecciona todos los archivos y carpetas de la raíz. Puedes usar Ctrl+A (o Cmd+A en Mac) para seleccionarlos todos.
5. Busca la opción "Permisos" en la barra de herramientas. En algunos paneles, esta opción aparece al hacer clic derecho sobre los archivos seleccionados.

Se te mostrará una ventana con un campo numérico o una serie de casillas de verificación. Anota los valores que ves. Si ves valores como 644 o 755, los permisos no son el problema (o al menos no el principal). Si ves valores como 666, 777 o algo extraño como 000, entonces has encontrado al culpable.

Cómo corregir los permisos de archivos en WordPress (paso a paso)

Una vez que has identificado que los permisos son incorrectos, es hora de arreglarlos. Vamos a hacerlo de forma segura y efectiva, distinguiendo entre carpetas y archivos.

Configurando las carpetas a 755

Las carpetas necesitan el permiso de ejecución para que el servidor pueda "entrar" en ellas y leer su contenido. La configuración correcta es 755.

1. En el Administrador de Archivos, selecciona todas las carpetas de la raíz de tu WordPress. Son las que no tienen un punto al final (como .htaccess). Las carpetas típicas son: wp-admin, wp-content, wp-includes.
2. Haz clic derecho y selecciona "Permisos" o "Change Permissions".
3. En el campo numérico, escribe 755.
4. Asegúrate de que la opción "Recursivo" o "Aplicar a subcarpetas" esté marcada. Esto es crucial, ya que aplicará el permiso a todas las carpetas internas también.
5. Haz clic en "Aceptar" o "Guardar".

Configurando los archivos a 644

Los archivos, por otro lado, solo necesitan ser leídos y, en algunos casos, escritos. La configuración estándar es 644.

1. Vuelve a la raíz de tu WordPress.
2. Selecciona todos los archivos (no las carpetas). Puedes hacer clic en el icono de tipo de archivo para ordenarlos y seleccionarlos más fácilmente.
3. Haz clic derecho y elige "Permisos".
4. En el campo numérico, escribe 644.
5. Esta vez, marca la opción "Aplicar a archivos dentro de subcarpetas" o "Recursivo" (si tu panel te lo permite, pero ten cuidado de no cambiar los permisos de las subcarpetas a 644; lo ideal es hacerlo por separado, pero en la mayoría de los casos el sistema es lo suficientemente inteligente para solo cambiar archivos si seleccionas esa opción específica).
6. Haz clic en "Aceptar".

[WARNING] Si tu panel no tiene una opción separada para "solo archivos" y "solo carpetas", te recomiendo encarecidamente que uses un cliente FTP como FileZilla. En FileZilla, puedes seleccionar todo, hacer clic derecho -> "Permisos de archivo..." y luego marcar la casilla "Redirigir a subdirectorios" y elegir "Solo archivos" o "Solo directorios". Esto te da un control mucho más preciso y evita errores.

Después de hacer estos cambios, recarga tu sitio web (con Ctrl+F5 para evitar la caché del navegador). En la gran mayoría de los casos, el error 500 desaparecerá.

¿Y si el problema persiste? Otras causas del error 500

Si después de corregir los permisos sigues viendo el error 500, no te preocupes. Hay otros sospechosos habituales. Vamos a repasarlos en orden de probabilidad.

1. Un plugin o tema defectuoso

Esta es la causa más común después de los permisos. Un plugin o tema puede tener un conflicto de código que rompe todo el sitio.

Cómo solucionarlo: Renombra la carpeta wp-content/plugins a wp-content/plugins_old usando el Administrador de Archivos. Esto desactiva todos los plugins. Si el error desaparece, el problema es uno de ellos.

• Para encontrar al culpable: Ve a wp-content/plugins_old y ve renombrando las carpetas de los plugins de una en una (por ejemplo, plugin1 a plugin1_old). Después de cada cambio, recarga tu sitio. Cuando el error aparezca, habrás encontrado al infractor.

Para los temas, el proceso es similar. Renombra la carpeta de tu tema activo en wp-content/themes/. WordPress usará un tema por defecto, y si el error desaparece, el problema es tu tema.

2. Un archivo .htaccess corrupto

El archivo .htaccess es un archivo de configuración crítico para Apache. Si está dañado, puede provocar un error 500.

Cómo solucionarlo: Renombra el archivo .htaccess a .htaccess_old. WordPress lo regenerará automáticamente la próxima vez que recargues la página. Si el error desaparece, el problema era este archivo.

[TIP] Después de renombrarlo, ve a Ajustes -> Enlaces permanentes en tu panel de WordPress y haz clic en "Guardar cambios". Esto fuerza la regeneración del .htaccess con las reglas correctas.

3. Límite de memoria PHP agotado

Tu sitio puede estar pidiendo más memoria de la que el servidor le permite. Esto es común si tienes muchos plugins o un tema pesado.

Cómo solucionarlo: Edita el archivo wp-config.php (con un editor de texto del Administrador de Archivos) y añade esta línea justo antes de la línea que dice /* That's all, stop editing! */:

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

Si esto no funciona, puedes intentar aumentar el límite desde el archivo .htaccess añadiendo:

php_value memory_limit 256M

4. Errores en el archivo .maintenance

Si tu WordPress se quedó atascado en un proceso de actualización, puede haber creado un archivo .maintenance. Si existe, WordPress mostrará un mensaje de "mantenimiento" o un error.

Cómo solucionarlo: Busca un archivo llamado .maintenance en la raíz de tu WordPress. Si existe, bórralo o renómbralo a .maintenance_old.

Preguntas frecuentes (FAQ) sobre el error 500

¿Puedo usar un plugin para arreglar los permisos?
Sí, existen plugins como "WP File Permissions" que pueden ayudarte a restablecer los permisos desde el propio panel de WordPress. Sin embargo, si no puedes acceder al panel, tendrás que hacerlo manualmente como hemos descrito.

¿Es peligroso usar permisos 777?
Sí, es muy peligroso. Un permiso 777 permite que cualquier usuario del servidor (incluidos los de otras webs en un hosting compartido) pueda leer, modificar y ejecutar tus archivos. Esto es una puerta abierta a ataques de seguridad. Úsalo solo de forma temporal y nunca lo dejes de forma permanente.

¿Cuál es la diferencia entre un error 500 y un error 403?
Un error 500 es un "Error Interno del Servidor", lo que significa que algo falló en el servidor. Un error 403 es de "Acceso Prohibido", lo que significa que el servidor entendió tu solicitud pero se niega a mostrarla por falta de permisos. Ambos pueden estar relacionados con los permisos, pero el 500 es más general.

¿Debo contactar con mi proveedor de hosting si nada funciona?
¡Por supuesto! Si has probado todos los pasos de esta guía y sigues con el error 500, es hora de contactar con el soporte técnico de tu hosting. Ellos tienen acceso a los registros de errores del servidor y pueden identificar el problema exacto en cuestión de minutos. Diles que ya has verificado los permisos de archivos, desactivado plugins y temas, y que el problema persiste.

[TIP] Antes de contactar con el soporte, revisa el archivo error_log en la raíz de tu WordPress. Este archivo contiene los errores exactos del servidor. Si ves líneas con "PHP Fatal error", eso te dará una pista muy valiosa sobre el archivo y la línea exacta del problema.

Conclusión: La paciencia y el método son tus mejores aliados

El error 500 en WordPress es un problema desalentador, pero es raramente permanente. Como has visto, la causa más común y la primera que debes verificar son los permisos de archivos. Con un poco de método y siguiendo los pasos que te hemos dado, podrás diagnosticar y solucionar el problema tú mismo en la mayoría de los casos.

Recuerda siempre trabajar con calma, hacer una copia de seguridad de tus archivos antes de hacer cambios drásticos y, si te sientes perdido, no dudes en pedir ayuda a tu proveedor de hosting. La comunidad de WordPress es enorme y siempre hay alguien dispuesto a echar una mano. ¡Mucha suerte y que tu web vuelva a estar en línea muy pronto!