Tutoriales de VPS
Nginx 400 Header or Cookie Too Large: localizar el campo y corregir el límite
Localiza cookies y cabeceras grandes, distingue errores del cuerpo y de la respuesta upstream, configura Nginx de forma persistente y verifica el login completo.

Después de iniciar sesión, una web que antes funcionaba muestra 400 Bad Request y Request Header Or Cookie Too Large. Puede que Cookie u otro campo de la petición supere el límite del servidor que lo recibe. El visitante puede comparar una ventana privada; quien administra la web debe localizar el campo excesivo y la capa que lo rechaza.
Para recuperar el acceso provisionalmente, elimina las cookies de esa web y vuelve a entrar. Si reaparece, investiga servidor y aplicación. Aumentar client_max_body_size afecta al cuerpo de las peticiones, por ejemplo una subida, y normalmente no resuelve este problema de cabeceras.
Abre la misma URL completa sin iniciar sesión y comprueba después la página autenticada. Si funciona en privado, pero no en la ventana habitual, elimina únicamente las cookies de ese dominio en la configuración del navegador. Tendrás que iniciar sesión de nuevo y puedes perder un carrito o preferencias guardados en cookies.
No hace falta borrar los datos de todas las webs. Si falla inmediatamente al entrar, comunica al administrador URL, hora y la diferencia entre antes y después del login. Borrar cookies reduce temporalmente la petición; no cambia el límite ni impide que la aplicación vuelva a generar datos grandes.
| Error o registro | Primera comprobación | Qué debes corregir |
|---|---|---|
| 400 con Header Or Cookie Too Large | Cookie, Authorization y otras cabeceras enviadas a Nginx | Búferes de petición y tamaño de cookies o tokens |
| 431 Request Header Fields Too Large | Proxy o aplicación que responde | Límite individual o total de cabeceras en esa capa |
| 414 URI Too Long | Ruta y consulta de la URL | Longitud de URL y línea de petición |
| 413 Request Entity Too Large | Archivo subido o cuerpo enviado | Límites del cuerpo en el punto de subida y la aplicación |
| 502 con upstream sent too big header | Respuesta del backend, como Set-Cookie | Respuesta de la aplicación y búferes de respuesta |
Un 400 por sí solo no demuestra que Cookie sea demasiado grande. También aparece con peticiones mal formadas. Revisa mensaje y logs. Un 431 puede señalar un campo o el conjunto de cabeceras, según MDN. Para subidas con 413, consulta los límites de Nginx, PHP y Cloudflare.
En Network de las herramientas del navegador, selecciona la petición fallida. Revisa URL, estado y Request Headers; presta atención a Cookie, Authorization y campos personalizados largos. Compara la misma página antes y después del login, no solo la portada.
Varias cookies pequeñas pueden formar un único campo Cookie grande. Cookies con igual nombre y distintos Domain o Path pueden enviarse juntas. document.cookie no muestra las HttpOnly; consulta la petición real.
En el VPS, confirma versión, configuración efectiva y ubicación de logs:
nginx -v
sudo nginx -T
sudo tail -n 100 /var/log/nginx/error.log
Adapta las rutas. nginx -T expande la configuración e identifica los archivos de origen; permite encontrar http, server y ajustes duplicados. Anota nombres y longitudes, y elimina cookies, tokens y credenciales antes de compartir información.
Puede aparecer client sent too large header, pero el nivel de registro quizá no lo incluya. Su ausencia no descarta la causa. Si el access log contiene $upstream_status, compara hora y registros del backend para saber si llegó a la aplicación. Que la página diga Nginx no identifica cuál de los proxies respondió.
Los valores predeterminados documentados son:
client_header_buffer_size 1k;
large_client_header_buffers 4 8k;
1k es el búfer inicial. Cuando no basta, se pueden solicitar búferes grandes; no implica un máximo absoluto de 1 KB. 4 8k permite hasta cuatro búferes grandes de 8 KB.
En HTTP/1.1, cada campo debe caber en un búfer grande. Una Cookie de más de 8 KB no consigue un espacio continuo de 64 KB al usar 8 8k. La referencia oficial distingue una línea de petición demasiado larga, con 414, y un campo excesivo, con 400.
El artículo original describe una prueba local aislada con Nginx 1.19.6 y HTTP/1.1. Cinco cookies simuladas con 1.800 caracteres ASCII cada una produjeron un valor Cookie de 9.023 bytes. El endpoint devolvía normalmente 204:
| Configuración | Sin cookies | Cookie simulada de 9.023 bytes |
|---|---|---|
4 8k | 204 | 400, mensaje de Cookie excesiva |
8 8k | 204 | 400 nuevamente |
4 16k | 204 | 204; se aceptó la cabecera |
Es una prueba histórica de los parámetros de HTTP/1.1. Utiliza una versión mantenida en producción. El 204 solo demuestra recepción de la petición simulada, no que funcione el login real. Comprueba HTTP/2 y HTTP/3 con tu versión y protocolo efectivos.
Si una petición legítima necesita más espacio, ampliar cada búfer de 8 KB a 16 KB puede ser un punto de partida. Sigue investigando el origen de los datos y decide el límite final según tamaños reales, tráfico y demás proxies.
Este fragmento va dentro del bloque http existente. Modifica los ajustes originales; no añadas otro bloque http:
client_header_buffer_size 1k;
large_client_header_buffers 4 16k;
Ambas directivas admiten http y server, pero no location. En http, las heredan los sitios sin una configuración propia; valora el efecto sobre otros dominios. En un server particular, revisa servidor predeterminado, SNI, Host y fase de procesamiento; consulta la selección de servidores virtuales.
Respalda el archivo real antes de editar. Aquí se utiliza /etc/nginx/nginx.conf; cambia la ruta para un archivo de sitio y usa un nombre de copia nuevo:
sudo cp -a /etc/nginx/nginx.conf /etc/nginx/nginx.conf.header-backup-20261109
Tras guardar, verifica la configuración:
sudo nginx -t
Solo si termina correctamente, recarga:
sudo systemctl reload nginx
Para revertir, restaura la copia, comprueba y recarga. Los búferes grandes se asignan según necesidad, pero muchas peticiones grandes simultáneas aumentan la memoria. No copies parámetros enormes como 16 128k sin justificar el tamaño.
En Docker, modifica el archivo persistente del host montado en el contenedor. Si el servicio Compose se llama nginx, comprueba antes de recargar:
docker compose exec nginx nginx -t
docker compose exec nginx nginx -s reload
Adapta el nombre. Editar un archivo temporal dentro del contenedor puede perderse al recrearlo. En BaoTa, 1Panel o Nginx Proxy Manager, usa el mecanismo persistente del panel y confirma que su contexto permita estas directivas.
Ampliar el búfer no justifica que las cookies crezcan indefinidamente. Causas frecuentes: perfiles completos, listas de permisos o carritos en cookies; tokens con muchos roles; y plugins antiguos que dejan cookies homónimas en distintas rutas.
Reduce campos innecesarios o usa un identificador corto de sesión con los detalles en el servidor, si la aplicación lo admite. Para eliminar una cookie antigua, coincide con su Domain y Path. Verifica cierre de sesión, renovación y autorización después de modificar las sesiones.
En navegador → CDN → Nginx → aplicación, cada capa puede imponer límites. Cambiar el origen no arregla un rechazo de la CDN. Nginx también puede aceptar mientras el backend devuelve 431. Sigue la misma petición fallida por toda la cadena.
Si aparece upstream sent too big header, Nginx falla al leer una respuesta del upstream, posiblemente con Set-Cookie grande. Revisa la respuesta y proxy_buffer_size, no los búferes del cliente. Consulta proxy_buffer_size.
Repite la prueba en la ventana original y conserva la petición fallida para comparar. En una ventana limpia, entra, actualiza una página autenticada, sal y entra otra vez. Confirma tamaños estables, ausencia del error y recepción correcta en el backend. Un curl sin cookies a la portada no verifica este fallo.
Evita http2_max_field_size y http2_max_header_size de tutoriales antiguos de HTTP/2. Están obsoletas desde 1.19.7; la alternativa documentada es large_client_header_buffers. Consulta el módulo HTTP/2 y comprueba el protocolo real.
Para errores relacionados: