Laravel自定义Basic Auth带Authorization头时Docker环境报400错误如何解决

1. Nginx 服务配置调整（使用 Nginx 部署时优先检查） #

绝大多数该类问题都是 Nginx 默认未透传 Authorization 头，或者请求头校验规则过严直接返回400导致的：

• 找到站点对应的 Nginx 配置，在location ~ \.php$代码块中添加以下两行配置，主动将 Authorization 头传递给后端 PHP-FPM 进程：

fastcgi_pass_header Authorization;
fastcgi_param HTTP_AUTHORIZATION $http_authorization;

• 若你配置了自定义请求头规则，检查是否开启了underscores_in_headers off（默认关闭），如果有带下划线的自定义请求头需要将该配置改为on放在 server 或 http 块中。
• 若你的 Authorization 头携带了额外参数长度较大，可调大请求头大小限制避免因为头超长返回400：

client_header_buffer_size 16k;
large_client_header_buffers 4 16k;

2. Apache 服务配置调整（使用 Apache 部署时优先检查） #

Apache 默认会在 CGI/FPM 模式下丢弃 Authorization 头，需要手动配置透传：

• 把以下规则添加到 Laravel 根目录的.htaccess文件，或者站点的虚拟主机配置中：

SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

3. Laravel 入口兼容处理 #

如果确认 Web 服务已经透传了头，Laravel 仍未识别到，可以在public/index.php入口文件最开头添加以下代码手动提取请求头：

if (empty($_SERVER['HTTP_AUTHORIZATION'])) {
    $_SERVER['HTTP_AUTHORIZATION'] = getallheaders()['Authorization'] ?? '';
}

注意：FPM 模式下getallheaders()函数默认可用，不会影响 Web 请求场景的正常执行

4. Docker 入口层配置检查 #

如果你的 Docker 部署栈还使用了 Traefik、Nginx Ingress 等中间代理层，检查这些组件的配置是否存在主动删除 Authorization 头、或者请求头格式校验的规则，关闭对应过滤规则即可。

排查验证方法 #

修改完配置重启对应服务后，先进入容器内部执行curl命令本地测试，排除外层代理的影响：
curl -H "Authorization: Basic 你自己的base64编码串" http://127.0.0.1/接口路径
如果本地请求正常，再逐层向外排查外层代理、防火墙的配置即可。

内容的提问来源于stack exchange，提问作者hakyoung jung