Cómo Solucionar el Error 'Invalid Form Key' en Magento 2 Paso a Paso

¿Qué es el error 'Invalid Form Key' en Magento 2?

El error 'Invalid Form Key' es uno de los problemas más frustrantes y comunes a los que se enfrentan los administradores y usuarios de Magento 2. Ocurre generalmente cuando la clave de formulario (form key) generada por el sistema no coincide con la enviada por el navegador, interrumpiendo acciones críticas como iniciar sesión en el admin, añadir productos al carrito o completar el proceso de pago (checkout).

Causas principales del error

Este fallo de seguridad suele estar relacionado con discrepancias en la configuración de las cookies o con problemas de almacenamiento en caché. Las causas más habituales son:

• Configuración incorrecta del dominio base en la URL (falta de coherencia entre con 'www' y sin 'www', o entre HTTP y HTTPS).
• Problemas con los dominios de las cookies (Cookie Domain o Cookie Path mal configurados).
• Caché de Magento desactualizada o sesiones bloqueadas.
• Límites de variables en el servidor (como max_input_vars en PHP).

Método 1: Ajustar la URL Base y las Cookies desde la Base de Datos

Si no puedes acceder al panel de administración debido a este error, puedes corregir los valores directamente ejecutando consultas SQL en tu base de datos mediante phpMyAdmin o la terminal.

1. Accede a tu gestor de base de datos (por ejemplo, phpMyAdmin).
2. Busca la tabla core_config_data y ejecuta las siguientes consultas (asegúrate de cambiar https://tu-tienda.com/ por tu URL real):
3. UPDATE core_config_data SET value='https://tu-tienda.com/' WHERE path='web/unsecure/base_url';
4. UPDATE core_config_data SET value='https://tu-tienda.com/' WHERE path='web/secure/base_url';
5. Limpia los campos relacionados con las cookies para forzar a Magento a usar los valores por defecto:
6. UPDATE core_config_data SET value='' WHERE path='web/cookie/cookie_domain';
7. UPDATE core_config_data SET value='' WHERE path='web/cookie/cookie_path';

Método 2: Limpiar la Caché y Reindexar por la Terminal SSH

Los archivos de caché corruptos suelen retener claves de formulario antiguas. Para solucionarlo, conéctate a tu servidor mediante SSH y ejecuta los comandos oficiales de limpieza de Magento.

1. Abre tu terminal SSH y navega hasta la raíz de tu instalación de Magento: cd /var/www/html/tu-tienda
2. Limpia toda la caché del sistema ejecutando: php bin/magento cache:clean
3. Elimina el contenido de las carpetas de generación y caché manualmente si el problema persiste: rm -rf var/cache/* var/generation/* var/page_cache/*
4. Vuelve a compilar y limpiar: php bin/magento setup:upgrade

Método 3: Aumentar el límite de variables en PHP (max_input_vars)

A veces, el formulario envía más datos de los que PHP permite procesar, lo que trunca la clave de formulario y genera el error. Sigue estos pasos para ampliar el límite:

1. Localiza tu archivo de configuración de PHP, normalmente llamado php.ini.
2. Busca la directiva max_input_vars y aumenta su valor a 5000 o más: max_input_vars = 5000
3. Guarda los cambios y reinicia tu servidor web (Apache o Nginx): sudo systemctl restart apache2 o sudo systemctl restart nginx