Yii 404本质是路由未匹配控制器,而非文件缺失;需验证urlManager配置、Nginx try_files含$args、PHP-FPM传入REQUEST_URI及视图目录是否为views/product/。

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$ 却漏掉关键参数。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
必须确保该 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 失效——这种问题往往要关掉美化才能发现。










