Yii2 GET请求报错：缺少必填参数key的技术求助

看起来你遇到的问题是Yii2无法正确解析GET请求中的key参数，同时伴随Nginx和Yii2的警告，我来一步步帮你排查：

1. 最可能的根源：Nginx配置未正确传递Query String #

从日志显示$_GET = ['args' => '']来看，PHP根本没接收到key参数，这大概率是Nginx的rewrite/try_files规则弄丢了查询字符串。

检查你的Nginx配置，确保在转发请求到index.php时带上?$query_string：

server {
    # 其他配置...
    root /var/www/arm/web;

    location / {
        # 正确的写法：带上$query_string确保GET参数被传递
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php8.0-fpm.sock; # 根据你的PHP版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }
}

如果之前用了类似rewrite ^(.*)$ /index.php$1 last;的规则，会导致Query String丢失，改成rewrite ^(.*)$ /index.php?$query_string last;即可。

修改后执行nginx -t验证配置正确性，然后重启Nginx：systemctl restart nginx

2. 排查Yii2 UrlManager路由规则问题 #

日志中的args参数空字符串，说明你的UrlManager规则可能包含<args>占位符，导致Yii错误解析请求路径：

// 错误示例：这种规则会把路径末尾的部分解析为args，而非处理Query String
'rules' => [
    'api/v1/<controller>/<action>/<args>' => 'api/v1/<controller>/<action>',
],

调整路由规则，直接映射你的Action，不需要<args>：

'rules' => [
    'api/v1/users/user-settings' => 'api/v1/users/user-settings',
    // 或者通用API规则，不要带<args>
    'api/v1/<controller>/<action>' => 'api/v1/<controller>/<action>',
],

这样Yii会正确将Query String中的key参数绑定到Action的$key参数上。

3. 验证参数是否到达PHP #

在项目根目录的web/index.php开头添加调试代码，确认PHP是否接收到参数：

var_dump($_GET);
exit;

发送请求/api/v1/users/user-settings?key=model-manual-user-settings，如果输出里没有key，说明Nginx配置问题还没解决；如果有key，再检查Yii的参数绑定逻辑（比如Controller的beforeAction是否修改了请求参数）。

4. 关于BaseArrayHelper的foreach警告 #

这个警告是因为Yii尝试遍历$_GET['args']这个空字符串（而非数组），只要解决前面的路由/参数传递问题，这个警告会自动消失——因为args参数不会再被错误解析为空字符串。

内容的提问来源于stack exchange，提问作者Александр Кулишов