{"id":9305,"date":"2025-04-28T11:07:40","date_gmt":"2025-04-28T09:07:40","guid":{"rendered":"https:\/\/www.nicalia.com\/nicapedia\/guias\/prestashop\/lo-basico-sobre-prestashop\/habilitar-modo-debug-de-prestashop\/"},"modified":"2026-06-01T16:10:23","modified_gmt":"2026-06-01T14:10:23","slug":"habilitar-modo-debug-de-prestashop","status":"publish","type":"docs","link":"https:\/\/www.nicalia.com\/nicapedia\/guias\/prestashop\/habilitar-modo-debug-de-prestashop\/","title":{"rendered":"C\u00f3mo activar el modo debug en PrestaShop: 2 m\u00e9todos"},"content":{"rendered":"

El modo debug de PrestaShop<\/strong> muestra mensajes de error detallados en lugar de una pantalla en blanco o un error gen\u00e9rico, lo que permite identificar exactamente qu\u00e9 plugin, tema o l\u00ednea de c\u00f3digo est\u00e1 causando el problema. Es la primera herramienta a activar cuando la tienda muestra errores, deja de cargar o se comporta de forma inesperada.<\/p>\n

Hay dos formas principales de activarlo: desde el propio panel de administraci\u00f3n (si todav\u00eda es accesible) o editando directamente el archivo de configuraci\u00f3n del servidor (cuando el Back Office tampoco carga). Ambos m\u00e9todos son v\u00e1lidos para PrestaShop 1.6, 1.7 y 8.x<\/strong>.<\/p>\n

\u26a0\ufe0f El modo debug nunca debe dejarse activo en una tienda en producci\u00f3n.<\/strong> Muestra informaci\u00f3n t\u00e9cnica interna que puede ser aprovechada por terceros. Act\u00edvalo solo para diagnosticar el problema, y desact\u00edvalo en cuanto hayas identificado el error.<\/p>\n

<\/p>\n

M\u00e9todo 1 \u2014 Desde el Back Office de PrestaShop<\/h2>\n

Este es el m\u00e9todo m\u00e1s r\u00e1pido si todav\u00eda puedes acceder al panel de administraci\u00f3n.<\/p>\n

PrestaShop 1.6 y 1.7<\/h3>\n
    \n
  1. Accede al Back Office<\/strong> de tu tienda (por ejemplo, https:\/\/tutienda.com\/admin<\/code>).<\/li>\n
  2. Ve a Par\u00e1metros Avanzados \u2192 Rendimiento<\/strong>.<\/li>\n
  3. En la secci\u00f3n Modo Debug<\/strong>, activa la opci\u00f3n \u00abActivar modo depuraci\u00f3n\u00bb<\/strong>.<\/li>\n
  4. Guarda los cambios.<\/li>\n<\/ol>\n

    PrestaShop 8.x<\/h3>\n
      \n
    1. Accede al Back Office<\/strong>.<\/li>\n
    2. Ve a Configuraci\u00f3n Avanzada \u2192 Rendimiento<\/strong> (la secci\u00f3n se renombr\u00f3 en PS 8).<\/li>\n
    3. En el apartado Depuraci\u00f3n<\/strong>, activa el modo debug<\/strong>.<\/li>\n
    4. Guarda los cambios.<\/li>\n<\/ol>\n

      Si tras activarlo desde el Back Office sigues sin ver mensajes de error, prueba el M\u00e9todo 2 directamente en el archivo de configuraci\u00f3n.<\/p>\n

      <\/p>\n

      M\u00e9todo 2 \u2014 Editando el archivo defines.inc.php<\/h2>\n

      Si el Back Office no carga (pantalla en blanco, error 500 o error de PHP), debes activar el debug directamente en el servidor. Para ello necesitas acceso por FTP\/SFTP<\/a> o mediante el Administrador de Archivos de cPanel<\/a>.<\/p>\n

        \n
      1. Con\u00e9ctate v\u00eda FTP\/SFTP o abre el Administrador de Archivos de tu panel de hosting.<\/li>\n
      2. Navega hasta el archivo \/config\/defines.inc.php<\/code><\/strong> en la ra\u00edz de tu instalaci\u00f3n de PrestaShop.<\/li>\n
      3. Edita el archivo y localiza esta l\u00ednea (habitualmente cerca del principio del archivo):\n
        define('PS_MODE_DEV', false);<\/code><\/pre>\n<\/li>\n
      4. Cambia false<\/code> por true<\/code>:\n
        define('PS_MODE_DEV', true);<\/code><\/pre>\n<\/li>\n
      5. Guarda el archivo.<\/li>\n<\/ol>\n
        Recarga la p\u00e1gina problem\u00e1tica en el navegador \u2014 ahora deber\u00edas ver el mensaje de error detallado en lugar de la pantalla en blanco.<\/p>\n
        \u26a0\ufe0f Recuerda volver a cambiar true<\/code> por false<\/code><\/strong> en cuanto hayas identificado y resuelto el error.<\/p>\n
        <\/p>\n
        Si el modo debug est\u00e1 activo pero no aparecen errores: borra la cach\u00e9<\/h2>\n
        Si despu\u00e9s de activar el modo debug el problema sigue sin mostrarse, es probable que PrestaShop est\u00e9 sirviendo p\u00e1ginas en cach\u00e9. Borra la cach\u00e9 por cualquiera de estos m\u00e9todos:<\/p>\n
        Desde el Back Office<\/h3>\n
        Ve a Par\u00e1metros Avanzados \u2192 Rendimiento \u2192 Borrar cach\u00e9<\/strong> y haz clic en el bot\u00f3n de limpiar.<\/p>\n
        Desde el servidor (PrestaShop 1.7 y 8.x)<\/h3>\n
        Elimina manualmente el contenido de la carpeta \/var\/cache\/<\/code> dentro de tu instalaci\u00f3n de PrestaShop, manteniendo la carpeta pero vaciando su contenido. Puedes hacerlo por FTP o desde el Administrador de Archivos de cPanel.<\/p>\n
        Desde el servidor (PrestaShop 1.6)<\/h3>\n
        Vac\u00eda el contenido de las carpetas \/cache\/smarty\/compile\/<\/code> y \/cache\/smarty\/cache\/<\/code>.<\/p>\n
        <\/p>\n
        C\u00f3mo desactivar el modo debug cuando termines<\/h2>\n
        Una vez identificado y resuelto el error, es imprescindible desactivar el modo debug antes de que la tienda vuelva a recibir visitas<\/strong>. Con el debug activo, cualquier visitante puede ver los mensajes de error con rutas internas, versiones de software y otra informaci\u00f3n t\u00e9cnica sensible.<\/p>\n
        Desde el Back Office<\/h3>\n
        Ve a la misma ruta donde lo activaste (Par\u00e1metros Avanzados \u2192 Rendimiento \u2192 Modo Debug<\/strong>) y desactiva la opci\u00f3n. Guarda los cambios.<\/p>\n
        Desde el archivo defines.inc.php<\/h3>\n
        Abre \/config\/defines.inc.php<\/code> y cambia de nuevo la l\u00ednea:<\/p>\n
        define('PS_MODE_DEV', true);<\/code><\/pre>\n
        a:<\/p>\n
        define('PS_MODE_DEV', false);<\/code><\/pre>\n
        Guarda el archivo.<\/p>\n
        <\/p>\n
        Errores frecuentes al activar el modo debug en PrestaShop<\/h2>\n
        Pantalla en blanco incluso con el modo debug activado<\/h3>\n
        Puede deberse a un error de PHP tan grave que impide mostrar cualquier salida, o a que la cach\u00e9 sigue sirviendo p\u00e1ginas antiguas. Prueba a limpiar la cach\u00e9 (carpeta \/var\/cache\/<\/code>) y recarga. Si sigue en blanco, verifica el log de errores de PHP<\/strong> desde cPanel (M\u00e9tricas \u2192 Registro de errores) o directamente en el archivo error_log<\/code> en la ra\u00edz de tu hosting.<\/p>\n
        El archivo defines.inc.php no existe en la ruta indicada<\/h3>\n
        Verifica que est\u00e1s buscando en la ra\u00edz correcta de tu instalaci\u00f3n de PrestaShop. Si tienes PrestaShop instalado en un subdirectorio (por ejemplo \/public_html\/tienda\/<\/code>), la ruta completa ser\u00eda \/public_html\/tienda\/config\/defines.inc.php<\/code>.<\/p>\n
        No tengo acceso al Back Office ni a FTP<\/h3>\n
        Si no puedes acceder por ninguno de los dos m\u00e9todos anteriores, usa el Terminal de cPanel<\/strong> (cPanel \u2192 Avanzado \u2192 Terminal<\/em>) para editar el archivo directamente:<\/p>\n
        nano \/home\/USUARIO_CPANEL\/public_html\/config\/defines.inc.php<\/code><\/pre>\n
        Sustituye USUARIO_CPANEL<\/code> y la ruta por los valores correctos de tu instalaci\u00f3n.<\/p>\n
        Los errores aparecen pero no se entienden<\/h3>\n
        PrestaShop en modo debug muestra el tipo de error, el archivo y la l\u00ednea donde se produce. Los errores m\u00e1s frecuentes son de tipo Fatal error<\/code> (PHP incapaz de continuar, habitualmente un plugin o theme mal codificado), Warning<\/code> (problema no fatal, la p\u00e1gina puede cargar igualmente) y Notice<\/code> (advertencia informativa, generalmente no cr\u00edtica). Busca el mensaje del Fatal error<\/code> y el nombre del archivo indicado \u2014 casi siempre apunta al m\u00f3dulo o tema que est\u00e1 causando el problema.<\/p>\n
        El modo debug muestra errores de m\u00f3dulos que no uso<\/h3>\n
        PrestaShop carga algunos m\u00f3dulos en segundo plano aunque no est\u00e9n visibles en el frontend. Si el error apunta a un m\u00f3dulo instalado pero inactivo, desinst\u00e1lalo completamente desde el gestor de m\u00f3dulos del Back Office y comprueba si el error desaparece.<\/p>\n
        <\/p>\n
        Preguntas frecuentes sobre el modo debug de PrestaShop<\/h2>\n
        \u00bfEl modo debug afecta al funcionamiento de la tienda para los clientes?<\/h3>\n
        S\u00ed. Con el modo debug activo, cualquier visitante ver\u00e1 los mensajes de error t\u00e9cnico en lugar de la p\u00e1gina normal. Adem\u00e1s, en algunos casos puede ralentizar la tienda. Por eso debe usarse exclusivamente para diagn\u00f3stico y desactivarse inmediatamente despu\u00e9s.<\/p>\n
        \u00bfEs diferente el procedimiento en PrestaShop 8 respecto a 1.7?<\/h3>\n
        El procedimiento es pr\u00e1cticamente id\u00e9ntico. La principal diferencia en PS 8 es que la secci\u00f3n del Back Office se llama Configuraci\u00f3n Avanzada<\/strong> en lugar de Par\u00e1metros Avanzados<\/strong>. El archivo defines.inc.php<\/code> y la variable PS_MODE_DEV<\/code> funcionan igual en ambas versiones.<\/p>\n
        \u00bfPuedo activar el modo debug solo para mi IP y no para los clientes?<\/h3>\n
        PrestaShop no tiene esta funcionalidad de forma nativa. La forma m\u00e1s habitual de diagnosticar sin afectar a los clientes es poner la tienda en modo mantenimiento<\/strong> (Par\u00e1metros de la Tienda \u2192 General \u2192 Modo Mantenimiento<\/em>), con tu IP en la lista blanca, y entonces activar el debug. As\u00ed solo t\u00fa ves la tienda y los errores.<\/p>\n
        \u00bfD\u00f3nde se guardan los logs de error de PrestaShop?<\/h3>\n
        PrestaShop guarda logs de errores en dos lugares: en el Back Office<\/strong> en Configuraci\u00f3n Avanzada \u2192 Logs<\/em> (donde puedes configurar el nivel de severidad que se registra), y en los logs del servidor que puedes consultar desde cPanel \u2192 M\u00e9tricas \u2192 Registro de Errores<\/em>. El modo debug muestra los errores directamente en pantalla, pero los logs del servidor son \u00fatiles para errores que ocurren en segundo plano o en tareas cron.<\/p>\n
        \u00bfQu\u00e9 hago si el error apunta a un archivo del core de PrestaShop?<\/h3>\n
        Si el error no apunta a un m\u00f3dulo ni a un tema sino a un archivo del n\u00facleo de PrestaShop (carpetas \/classes\/<\/code>, \/controllers\/<\/code>, \/src\/<\/code>), las causas m\u00e1s habituales son: (1) archivos del core modificados o corruptos \u2014 considera reinstalar PrestaShop manteniendo la base de datos; (2) incompatibilidad entre la versi\u00f3n de PHP del servidor y la versi\u00f3n de PrestaShop instalada \u2014 verifica en cPanel que la versi\u00f3n de PHP es compatible con tu versi\u00f3n de PrestaShop.<\/p>\n","protected":false},"excerpt":{"rendered":"
        El modo debug de PrestaShop muestra mensajes de error detallados en lugar de una pantalla en blanco o un error gen\u00e9rico, lo que permite identificar exactamente qu\u00e9 plugin, tema o l\u00ednea de c\u00f3digo est\u00e1 causando el problema. Es la primera herramienta a activar cuando la tienda muestra errores, deja de cargar o se comporta de […]<\/p>\n","protected":false},"author":5,"featured_media":0,"parent":9299,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-9305","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"acf":[],"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/c64e192e92bea4df8a48c5da36fb4618ceff98bc7377f1f887657a979722a633?s=96&d=mm&r=g","author_name":"Jose Manuel Garc\u00eda Romero","_links":{"self":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/9305","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/comments?post=9305"}],"version-history":[{"count":6,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/9305\/revisions"}],"predecessor-version":[{"id":10001,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/9305\/revisions\/10001"}],"up":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/9299"}],"wp:attachment":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/media?parent=9305"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_tag?post=9305"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_badge?post=9305"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}