Yii框架404错误解决方法

Yii框架中的404错误多数并非Nginx层面的文件缺失，而是请求虽成功抵达index.php，却因路由配置不当（如urlManager未匹配、Nginx try_files遗漏$arguments、PHP-FPM缺失REQUEST_URI参数）、控制器/视图路径错误（如Gii生成后视图放错目录）、命名不规范（大小写敏感、方法名非action前缀）或自定义路由规则误覆盖默认逻辑等原因，导致UrlManager无法解析出有效控制器动作——掌握这些关键排查点，能快速定位并彻底解决看似棘手的“假404”问题。

Yii 404 错误本质是路由没走到控制器，不是文件找不到

绝大多数 Yii 404 并非 Nginx 返回的“找不到页面”，而是 Yii 自己抛出的 NotFoundHttpException。这意味着请求确实进了 index.php，但 UrlManager 没匹配到任何路由规则，或控制器/动作根本不存在。先确认这点，能避开大量无效排查。

快速验证：临时注释掉 urlManager 配置里的 enablePrettyUrl => true，用 ?r=product/index 访问。如果能打开，说明问题出在美化 URL 链路上；如果还是 404，那大概率是控制器名、动作名拼错，或没生成对应文件。

Nginx try_files 配置漏掉 $args 就会丢参数

try_files $uri $uri/ /index.php?$args; 这行必须完整，尤其末尾的 $args 不可省略。漏掉它会导致 /product/123 被转给 /index.php 时丢失原始路径信息，Yii 只看到空的 REQUEST_URI 或默认值，UrlManager 根本无法解析出 product/123 对应哪个控制器和动作。

• 错误写法：try_files $uri $uri/ /index.php;（无 $args）
• 正确写法：try_files $uri $uri/ /index.php?$args;
• 如果你用的是 pathInfo 模式（默认），Nginx 不需要额外重写，靠 $args 把完整路径传过去即可
• 如果你用的是 get 模式（如 ?r=product/view&id=123），则 try_files 末尾要改成 /index.php?，但不推荐

PHP-FPM 缺 fastcgi_param REQUEST_URI 就等于没传路由

即使 Nginx 正确转发了请求，如果 PHP-FPM 没收到真实的 REQUEST_URI，Yii 依然拿不到美化后的路径。常见于只配了 location ~ \.php$ 却漏掉关键参数。

必须确保该 location 块内包含：

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param REQUEST_URI $request_uri;

缺 REQUEST_URI：Yii 看到的是 /index.php，不是 /product/123，所有美化规则失效；
缺 SCRIPT_FILENAME：PHP 报 No input file specified.；
PATH_INFO 在某些 urlManager 配置下也必需，尤其启用了 usePathInfo => true 时。

Gii 生成 CRUD 后 404，90% 是视图目录放错了

Gii 生成的 ProductController 默认期望视图在 views/product/ 下。如果手抖拖进了 views/layouts/product/ 或 views/site/product/，Yii 找不到 index.php 就直接 404，连控制器都进不去。

• 检查实际路径：views/product/index.php 是否存在（不是 views/layouts/product/）
• 控制器类名必须是 ProductController，且文件名是 ProductController.php，大小写敏感
• 动作方法名必须是 actionIndex()、actionView($id) 等，不能写成 index() 或 view()
• 清除缓存：php yii cache/flush-all，否则旧路由规则可能还在生效

最隐蔽的一点：urlManager 的 rules 数组里如果写了自定义规则，且正则写得太宽（比如 '/' => '/'），反而会覆盖默认的控制器/动作映射逻辑，导致 Gii 生成的标准 URL 失效——这种问题往往要关掉美化才能发现。

今天关于《Yii框架404错误解决方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！