FastCGI环境下同服务器PHP+CURL调用REST API返回401错误问题

云原生阿岚

2026-10-1

问题根因

这是cPanel服务器同IP多虚拟主机场景下的典型请求头拦截问题：cPanel默认会将同服务器的域名请求解析到本地回环地址127.0.0.1，不走公网链路，本地回环请求的Authorization头会被Apache的mod_proxy_fcgi模块过滤，即使配置了CGIPassAuth On也不会传递给PHP FastCGI进程，所以服务端读不到$_SERVER['PHP_AUTH_USER']返回401。

解决方案

方案1：强制curl走公网链路请求（改造成本最低，无需修改服务端逻辑）

在客户端curl代码中添加CURLOPT_RESOLVE配置，强制将服务端域名解析到公网IP，绕开本地回环逻辑，此时请求和外部Postman/跨IP请求逻辑完全一致，原有认证配置即可生效：

$ch = curl_init("https://www.my-server-url.com/api/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER,["Cache-Control: no-cache, must-revalidate"]); 
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, $username. ":" . $password);
// 新增配置，将www.my-server-url.com的443端口请求强制指向你的服务器公网IP，替换成实际IP即可
curl_setopt($ch, CURLOPT_RESOLVE, ['www.my-server-url.com:443:你服务器的公网IP']);

方案2：服务端显式透传Authorization头

如果无法修改客户端代码，可在服务端.htaccess文件中添加重写规则，强制将Authorization头传递给PHP进程：

CGIPassAuth On
RewriteEngine On
# 显式将Authorization头存入环境变量
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]

服务端PHP代码中新增兼容逻辑读取认证信息：

if (empty($_SERVER['PHP_AUTH_USER']) && !empty($_SERVER['HTTP_AUTHORIZATION'])) {
    // 解析Basic auth头
    list($user, $pass) = explode(':', base64_decode(substr($_SERVER['HTTP_AUTHORIZATION'], 6)));
    $_SERVER['PHP_AUTH_USER'] = $user;
    $_SERVER['PHP_AUTH_PW'] = $pass;
}