Códigos de error PrestaShop explicados: 403, 404, 500 y 503

Entender los códigos de error HTTP en PrestaShop

Los códigos de error HTTP son respuestas estandarizadas de tu servidor web que indican que algo salió mal cuando un navegador o bot de motor de búsqueda intentó acceder a una página. Para los propietarios de tiendas PrestaShop, estos errores pueden significar ventas perdidas, clientes frustrados y posicionamientos SEO dañados.

Error 403 - Prohibido

Un error 403 significa que el servidor entendió tu solicitud pero se niega a autorizarla. Es típicamente un problema de permisos o control de acceso.

1. Permisos de archivos y directorios incorrectos

Los directorios deben estar en 755 y los archivos en 644.

find /var/www/html/prestashop -type d -exec chmod 755 {} \;
find /var/www/html/prestashop -type f -exec chmod 644 {} \;
chown -R www-data:www-data /var/www/html/prestashop

2. Reglas .htaccess bloqueando el acceso

Un archivo .htaccess demasiado restrictivo puede bloquear solicitudes legítimas.

3. ModSecurity o WAF bloqueando solicitudes

Los firewalls de aplicaciones web pueden producir falsos positivos.

Corregir errores 403

1. Verificar y corregir permisos de archivos
2. Revisar .htaccess para reglas demasiado restrictivas
3. Verificar registros de seguridad del hosting
4. Verificar que tu IP no esté en una lista negra

Error 404 - No encontrado

Un error 404 significa que el servidor no puede encontrar la página solicitada.

1. URLs amigables desactivadas o mal configuradas

Ve a Parámetros de la tienda > Tráfico y SEO, asegúrate de que las URLs amigables estén activadas y haz clic en Guardar. Verifica que mod_rewrite esté habilitado en tu servidor.

2. Productos o categorías eliminados sin redirecciones

Siempre configura redirecciones 301 al eliminar contenido.

3. .htaccess faltante o corrupto

Regenera el .htaccess desde Parámetros de la tienda > Tráfico y SEO.

Corregir errores 404

1. Verificar que .htaccess existe y está correctamente configurado
2. Verificar que mod_rewrite está habilitado
3. Regenerar el .htaccess
4. Configurar redirecciones 301
5. Verificar Google Search Console para errores de rastreo

Error 500 - Error interno del servidor

Un error 500 significa que algo salió mal en el lado del servidor.

1. Límite de memoria PHP excedido

memory_limit = 512M

2. Errores de sintaxis PHP o errores fatales

define('_PS_MODE_DEV_', true);

3. Incompatibilidad de versión PHP

4. Problemas de conexión a la base de datos

Verifica las credenciales en app/config/parameters.php.

5. Conflictos de módulos

mv modules/problematic_module modules/problematic_module_disabled

Corregir errores 500

1. Activar el modo debug
2. Verificar el registro de errores PHP
3. Aumentar el límite de memoria PHP
4. Verificar compatibilidad de versión PHP
5. Desactivar módulos instalados recientemente

Error 503 - Servicio no disponible

Un error 503 significa que el servidor no puede manejar la solicitud temporalmente.

1. Modo mantenimiento aún activo

UPDATE ps_configuration SET value = '0' WHERE name = 'PS_SHOP_ENABLE';

2. Sobrecarga del servidor

• Mejorar el plan de hosting
• Activar el caché de PrestaShop
• Usar un CDN como Cloudflare
• Activar OPcache para PHP

3. Agotamiento de workers PHP-FPM

pm = dynamic
pm.max_children = 50
pm.start_servers = 10

Corregir errores 503

1. Verificar y desactivar modo mantenimiento
2. Monitorear recursos del servidor
3. Verificar registros PHP-FPM
4. Revisar programación de tareas cron
5. Considerar mejorar el hosting

Consejos generales de depuración

• Apache - /var/log/apache2/error.log
• Nginx - /var/log/nginx/error.log
• PHP-FPM - /var/log/php-fpm/error.log
• PrestaShop - /var/logs/

Después de cada corrección, limpiar todas las cachés.