Error InvalidTypeException: Invalid type for path en Prestashop

🐛 Cómo solucionar el error «InvalidTypeException: Invalid type for path» en PrestaShop

Si estabas ajustando la configuración de tu tienda y de pronto la pantalla se puso en blanco mostrando un mensaje de error que empieza de esta manera:

(1/1) InvalidTypeException
Invalid type for path "doctrine.dbal.connections.dbname". Expected array, but got string
in ArrayNode.php line 261

¡Respira hondo, no has roto nada grave! Este es un clásico error de formato. El archivo que estábamos editando (llamado doctrine.yml) utiliza un lenguaje que es extremadamente estricto con los espacios.

Lo que ocurrió fue que las palabras quedaron mal alineadas. Variables como dbname o user quedaron a la misma altura que default: en lugar de ir un poco más a la derecha (dentro de él). El sistema se confundió y por eso mostró el error. A continuación, te mostramos cómo dejarlo perfecto.

📝 Paso 1: Corregir la alineación en doctrine.yml

1. Ingresa a tu panel de control (cPanel o DirectAdmin) y abre el Administrador de Archivos (File Manager).
2. Ve a la carpeta de tu tienda web, que por lo general es public_html.
3. Navega por las carpetas app y luego config.
4. Haz clic derecho sobre el archivo doctrine.yml y selecciona Edit (Editar).
5. Para evitar dolores de cabeza contando espacios, borra el contenido de ese archivo y copia y pega exactamente este código (hemos corregido todos los espacios por ti):

# Doctrine Configuration
doctrine:
  dbal:
    default_connection: default

    connections:
        default:
            driver: pdo_mysql
            server_version: '10.6.12-MariaDB'
            host: "%database_host%"
            port: "%database_port%"
            dbname:   "%database_name%"
            user:     "%database_user%"
            password: "%database_password%"
            charset:  utf8mb4
            mapping_types:
              enum: string
            options:
              # PDO::MYSQL_ATTR_INIT_COMMAND
              # 1002: "SET sql_mode=(SELECT REPLACE(@@sql_mode,'ONLY_FULL_GROUP_BY',''))"
              # PDO::MYSQL_ATTR_MULTI_STATEMENTS
              # 1013: '%env(const:runtime:_PS_ALLOW_MULTI_STATEMENTS_QUERIES_)%'

  orm:
    auto_generate_proxy_classes: "%kernel.debug%"
    naming_strategy: prestashop.database.naming_strategy
    auto_mapping: true
    dql:
      string_functions:
        regexp: DoctrineExtensions\Query\Mysql\Regexp

Guarda los cambios en la parte superior derecha y cierra el editor.

🧹 Paso 2: Limpiar la caché (¡Sí, otra vez!)

Como hubo un error al intentar leer el archivo anterior, PrestaShop guardó esa «basura» en su memoria temporal. Debemos borrarla obligatoriamente para que lea el archivo corregido.

1. Vuelve a la carpeta principal de tu tienda (public_html).
2. Navega hacia la carpeta var y entra en cache.
3. Entra a la carpeta prod, selecciona todos los archivos y carpetas dentro, y elimínalos. Haz lo mismo con la carpeta dev si tiene contenido.

public_html/var/cache/prod/*
public_html/var/cache/dev/*

🎉 ¡Problema solucionado!

Recarga tu página web. Al corregir la estricta alineación del archivo YAML y limpiar la caché, tu tienda PrestaShop cargará sin inconvenientes. Recuerda que si el problema persiste o prefieres no tocar estos códigos, puedes abrirnos un ticket y el equipo de PremiumHosting lo resolverá por ti.