Errores comunes en PrestaShop: 500, 404 y base de datos [Soluciones]

Introducción: Cuando tu tienda PrestaShop da problemas

Si tienes una tienda online con PrestaShop, es muy probable que en algún momento te hayas encontrado con pantallas en blanco, mensajes de error o páginas que no cargan. No te preocupes: es algo más común de lo que parece y, en la mayoría de los casos, tiene solución.

En este artículo vamos a desgranar los tres errores más frecuentes que afectan a las tiendas PrestaShop: el temido error 500, el frustrante error 404 y los problemas con la base de datos. Te explicaré de forma sencilla, paso a paso, cómo identificarlos y solucionarlos, incluso si no eres una persona técnica.

Antes de empezar, una aclaración importante: si tu hosting utiliza Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel de control se realiza a través del puerto 2106. Lo mencionaremos más adelante, porque desde ahí podrás gestionar archivos y bases de datos sin necesidad de ser un experto.

Error 500 en PrestaShop: Causas y soluciones

El error 500 PrestaShop es, probablemente, el más odiado por los comerciantes. Se trata de un error genérico del servidor que indica que algo ha fallado internamente, pero sin dar demasiados detalles. Es como si el servidor dijera: "algo ha ido mal, pero no te digo el qué".

¿Por qué aparece el error 500?

Las causas más habituales son las siguientes:

Un módulo incompatible recién instalado o actualizado.
Archivos con permisos incorrectos (normalmente, demasiado restrictivos o demasiado permisivos).
Un archivo .htaccess corrupto o mal configurado.
Problemas de memoria PHP (límite de memoria agotado).
Errores en la base de datos que impiden que la tienda cargue.

Solución paso a paso para el error 500

Vamos a por ello. Sigue estos pasos en orden, ya que van de lo más simple a lo más complejo.

Paso 1: Activa el modo de depuración (debug mode)

PrestaShop oculta los errores por defecto. Para ver qué está fallando realmente, tienes que activar el modo debug.

Accede a tu servidor por FTP o desde el administrador de archivos de Syspanel (recuerda, puerto 2106).
Busca el archivo config/defines.inc.php en la raíz de tu instalación.
Ábrelo con un editor de texto (el Bloc de notas sirve).
Busca la línea que dice define('_PS_MODE_DEV_', false);
Cámbiala por define('_PS_MODE_DEV_', true);
Guarda el archivo y sube los cambios.

Ahora, cuando recargues tu tienda, verás un mensaje de error mucho más detallado. Anota el mensaje, porque te indicará el archivo y la línea exacta del problema.

[WARNING] No olvides volver a poner false una vez hayas solucionado el error. Dejar el modo debug activado en producción es un riesgo de seguridad grave.

Paso 2: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son una causa muy común del error 500.

Las carpetas deben tener permisos 755.
Los archivos deben tener permisos 644.
La carpeta var/cache (o cache en versiones antiguas) debe tener permisos 775 o incluso 777 temporalmente.

Desde Syspanel, en el administrador de archivos, puedes hacer clic derecho sobre una carpeta o archivo y cambiar los permisos fácilmente.

Paso 3: Limpia la caché

A veces, una caché corrupta es la culpable.

Desde el administrador de archivos, entra en la carpeta var/cache (o cache).
Borra todo el contenido de las subcarpetas dev y prod. No borres las carpetas en sí, solo su contenido.
Si no puedes borrarlos, renómbralos (por ejemplo, prod_old) y crea una carpeta prod nueva.

Paso 4: Revisa el archivo .htaccess

El archivo .htaccess en la raíz de PrestaShop puede estar dañado.

Renombra el archivo .htaccess a .htaccess_old (esto lo desactiva).
Ve al panel de administración de PrestaShop: Parámetros avanzados > Rendimiento.
Activa la opción "Regenerar el archivo .htaccess" y guarda.
Si no puedes acceder al panel, simplemente sube una copia de seguridad de un .htaccess de una instalación limpia de PrestaShop (de la misma versión).

Paso 5: Aumenta el límite de memoria PHP

Si el error menciona "memory exhausted" o "allowed memory size", el problema es la memoria.

Localiza el archivo php.ini en la raíz de tu hosting (o créalo si no existe).
Añade o modifica esta línea: memory_limit = 256M
Guarda y recarga.

Si no tienes acceso al php.ini, puedes añadir esta línea al archivo config/defines.inc.php justo después de la apertura del <?php:

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

Error 404 en PrestaShop: Páginas que no se encuentran

El error 404 PrestaShop es más fácil de entender: significa que la página que buscas no existe o no se encuentra en el servidor. Pero, ¿por qué pasa si tu página sí existe?

Causas comunes del error 404

URLs amigables mal configuradas (el famoso "pretty URLs").
Cambios en la estructura de categorías o productos.
El archivo .htaccess no se ha regenerado después de un cambio.
Enlaces internos rotos o redirecciones mal hechas.

Cómo solucionar el error 404

Paso 1: Regenera las URLs amigables

Este es el primer paso y el que soluciona el 90% de los casos.

Accede al panel de administración de PrestaShop.
Ve a Parámetros avanzados > SEO y URLs.
Asegúrate de que la opción "URLs amigables" está activada.
Haz clic en el botón "Guardar" (aunque no cambies nada). Esto fuerza la regeneración del .htaccess.
Si tienes acceso al servidor, también puedes borrar el .htaccess y luego pulsar Guardar en esa misma pantalla para que se regenere desde cero.

Paso 2: Comprueba las redirecciones

Si has cambiado la URL de una categoría o producto, es posible que los enlaces antiguos sigan apuntando a la URL vieja.

Desde el panel de administración, en Parámetros avanzados > SEO y URLs, puedes configurar redirecciones 301 desde la URL antigua a la nueva.
Si no sabes hacerlo, una solución rápida es crear reglas en el .htaccess.

Paso 3: Revisa la estructura de carpetas

Asegúrate de que los archivos y carpetas de tu instalación están en el lugar correcto. A veces, al mover la tienda de servidor o de carpeta, las rutas se rompen.

Verifica que la tienda está en la carpeta correcta (por ejemplo, public_html o una subcarpeta).
Comprueba que el archivo config/settings.inc.php (en versiones antiguas) o app/config/parameters.php (en versiones modernas) tiene las rutas correctas.

[TIP] Si has movido tu tienda recientemente, revisa también que la URL de la tienda en el panel de administración (Parámetros avanzados > SEO y URLs) coincide con la nueva ubicación.

Errores de base de datos en PrestaShop: Guía de recuperación

La base de datos PrestaShop es el corazón de tu tienda. Si falla, todo se detiene. Los errores de base de datos pueden manifestarse de muchas formas: pantallas en blanco, mensajes del tipo "Error de conexión con la base de datos", o tablas que no se encuentran.

Síntomas típicos de problemas con la base de datos

"Link to database cannot be established" (No se puede establecer la conexión con la base de datos).
"Table 'ps_shop_url' doesn't exist" (La tabla no existe).
"Error de SQL" con números como 1045, 1049 o 2002.
La tienda va muy lenta y las páginas tardan en cargar.

Soluciones para los errores de base de datos

Paso 1: Verifica los datos de conexión

Lo primero es comprobar que los datos de acceso a la base de datos son correctos.

Accede a Syspanel (puerto 2106).
Ve a la sección de bases de datos y anota el nombre de la base, el usuario y la contraseña.
Busca el archivo app/config/parameters.php (PrestaShop 1.7 y 8) o config/settings.inc.php (PrestaShop 1.6 y anteriores).
Comprueba que los valores database_host, database_name, database_user y database_password coinciden con los de Syspanel.

Paso 2: Repara las tablas corruptas

Si el error menciona tablas específicas, es posible que estén corruptas.

Desde Syspanel, entra en phpMyAdmin (la herramienta de gestión de bases de datos).
Selecciona tu base de datos en el panel izquierdo.
En la parte inferior, verás un enlace que dice "Comprobar todas" o "Check All". Selecciónalo.
En el desplegable "Con seleccionar", elige "Reparar tabla" o "Repair".

Esto intentará reparar las tablas dañadas automáticamente.

Paso 3: Optimiza las tablas

A veces, el problema es simplemente que las tablas están fragmentadas y van lentas.

En phpMyAdmin, selecciona todas las tablas (clic en "Seleccionar todo").
En el menú desplegable, elige "Optimizar tabla".
Esto no borra nada, solo reorganiza los datos para que sean más eficientes.

Paso 4: Restaura desde una copia de seguridad

Si la base de datos está muy dañada y no hay manera de repararla, tendrás que restaurar desde una copia de seguridad.

En Syspanel, ve a la sección de copias de seguridad (Backups).
Localiza la copia más reciente de tu base de datos.
Restaura la copia. Ten en cuenta que perderás todos los cambios realizados desde que se hizo esa copia.

[WARNING] Antes de restaurar, exporta la base de datos actual a un archivo SQL local. Así, si la copia es muy antigua, al menos tendrás los datos recientes en bruto para intentar recuperar algo.

Paso 5: Comprueba la versión de MySQL

PrestaShop tiene requisitos de versión de MySQL. Si tu hosting ha actualizado MySQL a una versión incompatible, pueden aparecer errores.

Verifica en Syspanel qué versión de MySQL tienes.
PrestaShop 1.7 y 8 requieren MySQL 5.6 o superior (idealmente 5.7 o 8.0).
Si tu versión es anterior, contacta con tu proveedor de hosting para actualizar.

Herramientas útiles para diagnosticar errores en PrestaShop

Además de las soluciones anteriores, existen herramientas que te facilitarán la vida a la hora de diagnosticar errores PrestaShop.

El registro de errores de PrestaShop

PrestaShop guarda un registro de errores en el archivo var/logs/ (en versiones modernas) o log/ (en versiones antiguas).

Busca archivos con nombres tipo prod.log o dev.log.
Ábrelos con un editor de texto y busca las líneas que contengan "ERROR" o "CRITICAL".

El modo de mantenimiento

Si tu tienda está caída y no quieres que los clientes vean el error, activa el modo de mantenimiento.

Accede al panel de administración (si puedes).
Ve a Parámetros avanzados > Mantenimiento.
Activa el modo mantenimiento y escribe un mensaje temporal.

Si no puedes acceder al panel, edita el archivo app/config/parameters.php y busca la línea 'PS_SHOP_ENABLE' => 0 y cámbiala a 1.

Comprobador de requisitos de PrestaShop

PrestaShop tiene un script que comprueba si tu servidor cumple los requisitos mínimos.

Descarga la carpeta install de tu versión de PrestaShop.
Súbela al servidor en la raíz.
Accede a tudominio.com/install/ y sigue los pasos hasta que te muestre el análisis del servidor.
Anota los requisitos que fallen y soluciónalos.

[INFO] Este método es de solo diagnóstico. No completes la instalación, solo úsalo para ver el informe.

Consejos de prevención para evitar errores futuros

Como dice el refrán, más vale prevenir que curar. Aquí tienes una lista de buenas prácticas para evitar que estos errores aparezcan:

Haz copias de seguridad semanales de tu base de datos y de tus archivos. En Syspanel puedes automatizar esta tarea.
No instales módulos de fuentes dudosas. Un módulo mal codificado puede romper tu tienda.
Actualiza PrestaShop con cuidado. Antes de actualizar, haz una copia de seguridad y prueba en un entorno de staging.
Mantén los permisos de archivos correctos. No dejes todo en 777.
Revisa los logs periódicamente. Dedica 10 minutos a la semana a mirar el registro de errores.
Usa un hosting de calidad. Un hosting barato con poca memoria es una receta para el error 500.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop da error 500 después de instalar un módulo?

Lo más probable es que el módulo sea incompatible con tu versión de PrestaShop o que esté mal programado. Desactiva el módulo desde el panel de administración (si puedes acceder) o elimínalo directamente desde el servidor borrando la carpeta correspondiente en modules/.

¿Cómo sé si mi base de datos está corrupta?

Los síntomas más claros son errores SQL en la pantalla, tablas que no se encuentran y una lentitud extrema. También puedes ejecutar el "Comprobar" en phpMyAdmin para que te diga si hay tablas dañadas.

¿Puedo solucionar el error 404 sin acceso al panel de administración?

Sí, puedes intentar regenerar el .htaccess desde el servidor. Borra el archivo .htaccess y luego crea uno nuevo con el contenido básico de PrestaShop. Sin embargo, la forma más fiable es desde el panel, así que si no tienes acceso, contacta con tu soporte de hosting.

¿Qué hago si no tengo copia de seguridad de la base de datos?

Es una situación complicada, pero no imposible. Contacta con tu proveedor de hosting: algunos guardan copias de seguridad automáticas durante unos días. Si no, intenta usar herramientas de recuperación de datos como "mysqldump" con parámetros de reparación.

¿El error 500 puede deberse a un problema de mi hosting?

Sí, absolutamente. Si el servidor está sobrecargado, si hay un problema de configuración de PHP o si el hosting ha cambiado algo en su configuración, tu tienda puede dar error 500. Contacta con tu soporte de hosting y diles que tu tienda PrestaShop da error 500: ellos pueden revisar los logs del servidor.

Conclusión

Los errores PrestaShop pueden ser frustrantes, pero como has visto, la mayoría tienen solución si sabes dónde mirar. La clave está en identificar la causa raíz y no quedarse en el síntoma.

Recuerda: activa el modo debug para ver el error real, revisa los permisos de archivos, regenera el .htaccess para el 404 y verifica los datos de conexión para los problemas de base de datos PrestaShop. Y, sobre todo, haz copias de seguridad con regularidad.

Si te has sentido perdido en algún paso, no dudes en contactar con el soporte téc