Yii框架RESTful接口404怎么解_Yii框架路由匹配失败排查【方法】

Yii RESTful接口返回404，问题通常不在代码里——请求很可能根本没进入框架。这不是瞎猜，而是无数次排查后得出的经验。先别急着翻控制器，把入口验证做完再说。

直接访问 /index.php/api/users，带上前缀。如果能通，说明是重写规则的问题；不通，则要检查入口脚本权限、PHP-FPM是否运行，或者index.php是否默默报错被吞了。在index.php开头加一行日志，file_put_contents('/tmp/yii-req.log', print_r($_SERVER, 1), FILE_APPEND);，然后看看REQUEST_URI和SCRIPT_NAME的值是否符合预期，比如有没有多出/web，或者被截断。

Apache环境下，记得确认.htaccess生效。运行apache2ctl -M | grep rewrite，看rewrite_module是否加载，虚拟主机配置里块有没有AllowOverride All。这些细节少一个，重写规则就不走。

urlManager配置错一个参数，整个REST路由就失效

urlManager是Yii REST路由的总开关。enablePrettyUrl和showScriptName必须配合Web服务器重写规则使用，单独改没有意义。

一个常见现象：后台/index.php/admin能打开，但/api/users返回404。这说明urlManager根本没接管API请求。

关键点：'enablePrettyUrl' => true和'showScriptName' => false必须同时存在。若设为true，所有URL都得显式带index.php，这显然不是REST应有的风格。

再检查'rules'数组里有没有匹配api/*的规则。比如'api//' => '/view'，注意正则边界和大小写——\w+不匹配中划线，需要用[\w\-]+。

如果API模块独立，推荐用模块化路由：'api' => ['class' => 'app\modules\api\Module']，在模块内部定义urlManager规则，避免主配置臃肿。

抛出NotFoundHttpException却还是200或空白页

异常确实抛了，但Yii的错误处理器没接住——状态码写了，响应体没发，或者被其他输出提前冲掉。

标准做法是在findModel()里查不到记录时直接throw new NotFoundHttpException()。手动调用setStatusCode(404)反而容易失效，别绕弯子。

确认config/web.php中'errorHandler'组件没有被注释或覆盖，且'errorAction'指向有效action，比如'site/error'。

检查'catchAll'配置是否误开启——这个配置会拦截所有请求，异常根本不会触发。

API场景下，actionError必须判断请求类型：if (Yii::$app->request->getIsJsonp() || Yii::$app->request->getIsAjax()) { return $this->asJson([...]); }。否则默认渲染HTML错误页，前端收不到JSON。

绝对不要在actionError里再throw新异常，那样会导致无限递归崩溃。

Nginx下PATH_INFO解析失败，/api/users直接404

Yii 2.x默认依赖PATH_INFO解析路由，Nginx默认不提供，必须手动拆分并注入。否则index.php收到的只是脚本路径，后续路由完全失灵。

没有fastcgi_split_path_info时，Nginx会把整个URI当作脚本名尝试执行，找不到文件就直接返回404，连PHP解释器都不会调用。

在Nginx的location ~ \.php$块中必须包含：fastcgi_split_path_info ^(.+\.php)(/.+)$;和fastcgi_param PATH_INFO $fastcgi_path_info;。

SCRIPT_FILENAME务必用$realpath_root$fastcgi_script_name，不用$document_root。符号链接环境下，$document_root会指向链接源路径，导致文件找不到。

确认try_files包含$args：try_files $uri $uri/ /index.php?$args;。缺了$args，GET参数丢失，路由匹配失败。

真正卡住的地方往往不在控制器里，而在Web服务器传进来的原始路径是否完整、urlManager是否启用、以及错误处理器有没有被绕过。三者缺一不可，少配一个，throw new NotFoundHttpException()就只是个不会落地的异常。