一、常见原因与排查框架
可能导致 404 的直接原因
在 Yii2 的 CRUD 场景中，当访问 Product 模型的相关页面返回 404，通常是路由未命中或进入了错误的控制器/动作。这意味着框架找不到对应的处理逻辑，因此第一步要确认请求的路由是否能被正确解析到应用中的控制器与动作。
另一种常见情况是 URL 重写未开启或入口脚本配置不正确，导致请求没有正确经过应用入口，直接触发 404。要区分路由未命中与入口失败的场景，以免走错排查路径。
与 Product 模型相关的路由配置问题
Product 模型的 CRUD 通常由 ProductController 提供，路由规则必须覆盖 /product/index、/product/view、/product/create 等入口，如果 rules 配置错误或命名冲突，就会返回 404。
此外，若存在子模块或自定义路由，要确保父级模块的命名空间和子路由之间没有冲突，避免被其他路由覆盖或屏蔽。
二、环境与配置排查
Pretty URL 与 urlManager 配置
在配置文件 config/web.php 中，开启 Pretty URL、禁用脚本名、开启严格解析，是避免 404 的关键设置之一。未正确配置会导致请求无法被路由系统匹配到。
return ['components' => ['urlManager' => ['enablePrettyUrl' => true,'showScriptName' => false,'enableStrictParsing' => true,'rules' => ['product' => 'product/index','product/view' => 'product/view','product/' => 'product/view',],],],
]; 如果 showScriptName 设置为 true，而服务器没有正确的重写规则，访问仍然可能返回 404。同时，请确认服务器已开启 URL 重写模块，例如 Nginx 的 try_files 或 Apache 的 mod_rewrite。
服务器与入口点配置
部署结构差异（如前端/后端分离、不同入口文件夹）会影响路由的实际入口点。若访问入口不是 index.php，路由解析可能失败并返回 404，需要确保入口文件路径与 urlManager 的配置一致。
三、路由与 URL 规则的深度排查
当前路由与请求参数的快速定位
为了快速定位问题，可以输出当前路由与请求参数，确认实际命中的是哪一个路由。Yii::$app->requestedRoute 可以返回当前路由，这对于 404 的排查尤为关键。
// 在任意位置快速输出当前路由
\Yii::info('route: ' . \Yii::$app->requestedRoute, __METHOD__);// 或在视图中直接显示路由
echo \Yii::$app->requestedRoute;结合 GET/POST 参数，如 id、page、sort 等，确认规则是否包含变量匹配。
CRUD 路由覆盖与命名冲突
如果项目中存在多个模块或自定义路由，可能出现同名路由冲突，导致 /product/view 未命中。需检查 controllers/、modules/ 结构以及 urlManager 的 rules，确保没有重复或覆盖关系。
四、控制器与动作的命名空间与结构
控制器命名与文件位置
ProductController 的实际命名空间需要与应用入口的命名空间配置一致，文件应位于正确的目录下，如 controllers/ProductController.php，并且类名需与命名空间保持一致。
namespace app\controllers;use yii\web\Controller;class ProductController extends Controller
{public function actionIndex(){// 列表逻辑}public function actionView($id){// 详情逻辑}
}
如果命名空间或类名拼写错误，访问 /product/view 将直接返回 404，因此在代码级别要严格遵守命名规范。
动作方法签名与路由参数
actionView 的参数签名需要与路由规则中的变量匹配，ID 应正确传递，且避免命名冲突。当使用自定义行为或拦截机制时，仍需确保路由指向正确的动作。
五、模型、CRUD 代码与自动化生成
Product 模型与 ProductSearch
CRUD 通常需要 Product 模型及 ProductSearch，如果模型缺失、命名错误或与数据库表不匹配，将导致相应 CRUD 入口不可用，返回 404。
// 简化的 Product 模型示例
namespace app\models;use yii\db\ActiveRecord;class Product extends ActiveRecord
{public static function tableName(){return '{{%product}}';}
}请确认 ProductSearch 的存在与正确命名，以及它在 GridView、过滤与分页中的作用，它与 CRUD 路由绑定紧密。
控制器中的 CRUD 动作与路由绑定
ProductController 的 actionIndex、actionView、actionCreate、actionUpdate、actionDelete 等方法要正确实现，缺少动作实现或权限拦截导致页面不可用，表现为 404 或跳转异常。
六、日志记录与排错技巧
错误日志、调试信息的作用
开启调试模式和日志输出后，可以在 runtime/logs/app.log 中查看与 404 相关的路由和异常信息，帮助定位问题根源。
// 常见的 Yii 应用配置，开启调试和日志
'bootstrap' => ['log'],
'components' => ['log' => ['targets' => [['class' => 'yii\log\FileTarget','levels' => ['error', 'warning', 'info'],'categories' => ['application'],],],],
],此外，服务器日志（Nginx/Apache）中的 404 记录也能提示是路由错配、路径问题还是访问控制导致，需要结合应用日志进行综合判断。
配置变更后的验证步骤
对 urlManager、服务器、入口文件等关键配置进行变更后，清理缓存、重新加载应用、重新发起请求，以确保新配置生效。
