Yii2升级2.0.46迁移Nginx后QueryParamAuth认证失败求助

核心问题 #

你的Nginx配置中/api/路径的try_files指令存在错误，导致URL查询参数（包括access-token）没有正确传递给Yii2的API入口文件，最终引发认证失败。

具体错误点 #

你当前的/api/ location配置：

location /api/ {
    try_files $uri $uri/ /api/index.php?query_string;
}

这里的query_string是静态字符串，并非Nginx的内置变量，正确写法应为$query_string（带美元符号）。缺少美元符号会导致请求的查询参数无法传递到api/index.php，Yii2的QueryParamAuth组件也就无法获取到access-token参数，从而返回401未授权错误。

修复步骤 #

1. 修改Nginx配置中的/api/块：

location /api/ {
    try_files $uri $uri/ /api/index.php?$query_string;
}

2. 重启Nginx服务使配置生效：

sudo systemctl restart nginx

额外验证建议 #

可在API控制器中临时添加日志，确认参数是否正常传递：

public function actionMethod()
{
    \Yii::info('Received access-token: ' . \Yii::$app->request->get('access-token'), 'api-debug');
    // 原有业务逻辑
}

查看Yii2日志文件，确认access-token参数是否被正确接收。

版本问题排除 #

从代码逻辑和你的描述来看，Yii2 2.0.46版本的QueryParamAuth组件逻辑未发生变更，旧环境正常运行说明代码本身无问题，故障完全源于Nginx的参数传递配置错误。

内容的提问来源于stack exchange，提问作者Karlis Pokkers