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 数组里如果写了自定义规则，且正则写得太宽（比如 '<controller:>/<action:>' => '<controller>/<action>'</action></controller></action:></controller:>），反而会覆盖默认的控制器/动作映射逻辑，导致 Gii 生成的标准 URL 失效——这种问题往往要关掉美化才能发现。
