Yii框架 404错误怎么解_Yii框架路由失效修复方法【技巧】
Yii框架404错误本质是路由未匹配控制器，而非文件不存在。常见原因包括Nginxtry_files缺少$args、PHP-FPM缺失REQUEST_URI参数、视图目录放置错误或urlManager规则覆盖默认映射。检查enablePrettyUrl配置、控制器命名及缓存可快速定位问题。
先说一个核心判断：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 失效——这种问题往往要关掉美化 URL 才能发现。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
