Solución de errores comunes en PrestaShop (500, 503, base de datos)

¿Por qué aparecen estos errores en PrestaShop?

Si estás leyendo esto, probablemente te has encontrado con un mensaje de error en tu tienda online y necesitas una solución errores PrestaShop rápida. No te preocupes, es más común de lo que parece. Los errores 500, 503 y los problemas con la base de datos son los más frecuentes en este CMS, y en la mayoría de los casos tienen una solución sencilla que puedes aplicar tú mismo sin ser un experto.

En esta guía vamos a desglosar cada error, entender por qué ocurre y, lo más importante, cómo solucionarlo paso a paso. Vamos a ello.

Error 500 PrestaShop: El error interno del servidor

El error 500 PrestaShop es probablemente el más temido, pero también el más fácil de diagnosticar si sabes dónde mirar. Este error significa que algo en tu servidor ha fallado internamente, pero no te dice exactamente qué es. Puede ser un problema con un módulo, un tema, o incluso con los permisos de los archivos.

Causas más comunes del error 500

• Permisos incorrectos en archivos y carpetas.
• Archivos .htaccess corruptos o mal configurados.
• Módulos incompatibles o con errores de código.
• Límite de memoria PHP agotado.
• Versiones incompatibles de PHP o PrestaShop.

Cómo solucionar el error 500 en PrestaShop

Paso 1: Activa el modo debug de PrestaShop

Lo primero que necesitas es ver el error real. PrestaShop oculta los detalles por defecto, pero puedes activar el modo debug fácilmente:

1. Accede a tu panel de control (si usas Syspanel, recuerda que el puerto de acceso es el 2106).
2. Ve al administrador de archivos y busca la carpeta raíz de tu PrestaShop.
3. Abre el archivo config/defines.inc.php.
4. Busca la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a true.
5. Guarda el archivo y recarga tu tienda. Ahora verás el error específico en pantalla.

[WARNING] No olvides volver a poner el modo debug en false cuando termines de solucionar el problema, o tu tienda quedará expuesta públicamente.

Paso 2: Revisa los permisos de archivos

Si el error no te da pistas claras, revisa los permisos. Los archivos deben tener permiso 644 y las carpetas 755. Para cambiarlos:

1. Desde Syspanel (puerto 2106), abre el gestor de archivos.
2. Selecciona todos los archivos y carpetas de tu instalación.
3. Cambia los permisos a los valores recomendados.
4. Si usas FTP, también puedes hacerlo con FileZilla: clic derecho → "Permisos de archivo".

Paso 3: Verifica el archivo .htaccess

El .htaccess puede estar causando el error. Prueba a renombrarlo temporalmente:

1. Ve a la raíz de tu PrestaShop.
2. Renombra .htaccess a .htaccess.bak.
3. Recarga tu tienda. Si funciona, el problema está en ese archivo.
4. Ve a Back Office → Parámetros avanzados → Rendimiento y pulsa "Regenerar el archivo .htaccess".

Paso 4: Aumenta el límite de memoria PHP

A veces el error 500 se debe a falta de memoria. Edita el archivo config/settings.inc.php (o app/config/parameters.php en versiones nuevas) y busca la línea de memoria:

ini_set('memory_limit', '128M');

Cámbiala a 256M o incluso 512M si tu hosting lo permite.

[TIP] Si el problema persiste, desactiva todos los módulos no esenciales desde la base de datos. Puedes hacerlo con una consulta SQL: UPDATE ps_modules SET active = 0 WHERE name != 'ps_mainmenu'; (cambia el prefijo ps_ si usas otro).

Error 503 PrestaShop: Servicio no disponible

El error 503 en PrestaShop indica que el servidor está en mantenimiento o que la tienda está en modo de mantenimiento sin querer. También puede aparecer cuando hay un problema con el archivo de mantenimiento o cuando el servidor está sobrecargado.

Causas del error 503

• Modo mantenimiento activado por error.
• Archivos de mantenimiento corruptos.
• Problemas con el servidor (sobrecarga, límites de recursos).
• Actualizaciones incompletas.

Soluciones para el error 503

Opción 1: Desactiva el modo mantenimiento desde el Back Office

Si tienes acceso al panel de administración:

1. Ve a Parámetros generales → Mantenimiento.
2. Cambia "Activar el modo mantenimiento" a "No".
3. Guarda los cambios.

Opción 2: Desactiva el mantenimiento desde la base de datos

Si no puedes acceder al Back Office, tendrás que hacerlo directamente en la base de datos:

1. Entra a Syspanel (puerto 2106) y busca el gestor de bases de datos (suele ser phpMyAdmin).
2. Selecciona la base de datos de tu PrestaShop.
3. Busca la tabla ps_configuration (o el prefijo que uses).
4. Ejecuta: SELECT * FROM ps_configuration WHERE name = 'PS_SHOP_ENABLE';
5. Si el valor es 0, cámbialo a 1 con: UPDATE ps_configuration SET value = '1' WHERE name = 'PS_SHOP_ENABLE';

[INFO] Esta consulta activa la tienda. Si el valor ya es 1, entonces el problema no es el modo mantenimiento.

Opción 3: Verifica el archivo de mantenimiento

En la raíz de PrestaShop hay un archivo llamado maintenance.php. Si está presente y con contenido, puede causar problemas. Renómbralo a maintenance.php.bak y prueba de nuevo.

Opción 4: Comprueba los recursos del servidor

Si el error 503 aparece solo en momentos de mucho tráfico, puede ser que tu hosting no tenga suficientes recursos. Contacta con tu proveedor o considera actualizar tu plan.

Errores de base de datos PrestaShop

Los problemas con la base de datos PrestaShop son otro de los grandes dolores de cabeza. Pueden manifestarse de muchas formas: páginas en blanco, errores de conexión, mensajes de "tabla no encontrada", etc.

Errores típicos de base de datos

• Error de conexión: "Link to database cannot be established".
• Tablas corruptas o faltantes.
• Prefijo incorrecto en las tablas.
• Versión incompatible entre PrestaShop y MySQL/MariaDB.

Cómo solucionar problemas de base de datos en PrestaShop

Paso 1: Verifica la conexión a la base de datos

El error de conexión es el más común. Revisa los datos de conexión:

1. Accede a tu Syspanel (puerto 2106).
2. Abre el archivo app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en 1.6).
3. Verifica que los datos de database_host, database_name, database_user y database_password sean correctos.

[TIP] Si cambiaste la contraseña de la base de datos recientemente, asegúrate de actualizarla también en este archivo.

Paso 2: Repara las tablas corruptas

Si el error menciona tablas específicas, puedes repararlas desde phpMyAdmin:

1. Entra a phpMyAdmin desde Syspanel.
2. Selecciona tu base de datos.
3. Marca todas las tablas (clic en "Seleccionar todo").
4. En el menú desplegable, elige "Reparar tabla".

Paso 3: Comprueba el prefijo de las tablas

Si ves errores tipo "Table 'ps_products' doesn't exist", el prefijo puede ser incorrecto:

1. Ve a phpMyAdmin y mira el nombre real de las tablas.
2. Si usan otro prefijo (por ejemplo prestashop_products), abre parameters.php y cambia el valor de database_prefix.

Paso 4: Optimiza las tablas

A veces las tablas simplemente están demasiado fragmentadas. Desde phpMyAdmin, selecciona todas las tablas y elige "Optimizar tabla". Esto no borra datos, solo reorganiza la información.

Paso 5: Verifica la versión de MySQL/MariaDB

PrestaShop 1.7 requiere MySQL 5.0 o superior, y PrestaShop 8 necesita MySQL 5.6+ o MariaDB 10.0+. Si tu servidor usa una versión más antigua, tendrás problemas. Consulta con tu hosting o en Syspanel la versión instalada.

[WARNING] No intentes actualizar la versión de MySQL por tu cuenta si no sabes lo que haces. Podrías perder datos. Mejor contacta con soporte técnico.

Prevención: Cómo evitar futuros errores PrestaShop

La mejor forma de lidiar con los errores PrestaShop es prevenirlos. Aquí tienes una lista de buenas prácticas:

• Mantén PrestaShop actualizado: Usa siempre la última versión estable.
• Haz copias de seguridad periódicas: Tanto de archivos como de la base de datos. Puedes programarlas desde Syspanel (puerto 2106).
• No instales módulos piratas: Suelen contener errores de código que rompen la tienda.
• Revisa los permisos de archivos después de cada actualización.
• Monitoriza el espacio en disco: Si se llena, la base de datos fallará.

Preguntas frecuentes (FAQ)

¿Cómo sé si mi error 500 es por un módulo?

Activa el modo debug como explicamos antes. Si el error menciona el nombre de un módulo, ese es el culpable. Desactívalo desde la base de datos y luego elimínalo.

¿Puedo recuperar mi tienda si no tengo copia de seguridad?

Es complicado, pero no imposible. Contacta con tu proveedor de hosting, ya que a veces tienen copias internas. En Syspanel (puerto 2106) también puede haber opción de restaurar versiones anteriores.

¿Cuánto tarda en solucionarse un error de base de datos?

Depende. Si es una tabla corrupta, con reparar en phpMyAdmin suele bastar (5 minutos). Si hay que restaurar desde una copia de seguridad, puede llevar más tiempo.

¿Debo contactar con soporte técnico?

Si tras seguir todos estos pasos el error persiste, sí. No pierdas más tiempo y contacta con tu hosting o con un profesional. A veces el problema está en el servidor y no en tu tienda.

Resumen final

Hemos visto los tres errores más comunes en PrestaShop y cómo solucionarlos:

• Error 500: Activa el modo debug, revisa permisos, .htaccess y memoria PHP.
• Error 503: Desactiva el modo mantenimiento y verifica los recursos del servidor.
• Errores de base de datos: Comprueba la conexión, repara tablas y verifica prefijos.

Recuerda que la solución errores PrestaShop casi siempre pasa por revisar los archivos de configuración y la base de datos. Con un poco de paciencia y estas guías, podrás resolver la mayoría de problemas sin necesidad de ser un experto.

[TIP] Si usas Syspanel, recuerda que el puerto de acceso es el 2106. Desde ahí puedes gestionar archivos, bases de datos y mucho más sin necesidad de FTP.

Esperamos que esta guía te haya sido útil. Si te quedan dudas, déjalas en los comentarios y estaremos encantados de ayudarte. ¡Buena suerte con tu tienda!