yii3部署后404需依次排查：web服务器root是否指向public目录；nginx需配置try_files，apache需启用allowoverride和mod_rewrite；访问/public/index.php验证框架是否启动；检查环境变量与配置加载顺序；确认urlmanager启用enableprettyurl和showscriptname。
Yii3项目部署完成后访问首页或任意路由始终返回404，不是页面空白也不是500错误，说明Web服务器能正常接收请求，但路由未被框架识别或入口文件未正确触发。
确认Web服务器是否将请求正确转发给index.php
第一步：打开Nginx或Apache配置文件，检查root指令是否指向Yii3项目的public目录（不是项目根目录）。Yii3强制要求Web根目录必须是public，否则静态资源和入口文件无法被正确暴露。
第二步：Nginx用户请确认location块中包含以下关键配置：
location / {<br> try_files $uri $uri/ /index.php?$query_string;<br>}
缺少try_files或写成try_files $uri $uri/ =404会导致所有非静态资源请求直接被Nginx拦截并返回404，根本不会到达PHP层面。
第三步：Apache用户需确保.htaccess文件存在于public目录下且AllowOverride All已启用。若使用Apache 2.4+且禁用了mod_rewrite，则rewrite规则完全失效，所有路由都会404。
验证Yii3应用是否真正启动
在浏览器中直接访问https://your-domain.com/public/index.php（显式带上/public/路径）。如果能显示Yii3欢迎页或路由错误提示（如“No route found”），说明框架已加载，问题出在重写规则；如果仍404，说明Web服务器连入口文件都没找到。
这一步能快速区分问题是出在Web服务器配置层，还是PHP应用层。
注意：【不要把index.php放在web根目录外再用alias映射】，Yii3的App::getAlias('@webroot')会基于public目录计算路径，alias映射会导致asset发布、URL生成等全部异常。
检查环境与配置文件加载顺序
方法一：临时修改public/index.php，在$app = new yii\web\Application($config);之前插入一行：
file_put_contents('/tmp/yii3-env.log', print_r($_SERVER, true), FILE_APPEND); die('env ok');
访问页面，查看/tmp/yii3-env.log是否存在、内容是否包含SCRIPT_FILENAME指向public/index.php。若无日志或路径错误，说明请求根本没进到PHP。
方法二：在config/web.php中，将'components' => [ ... ]里任意一项故意写错（比如'class' => 'yii\web\NotExistsApplication'），保存后刷新。如果出现PHP Fatal Error，说明配置已加载；如果仍是404，证明配置文件根本未被读取——大概率是require __DIR__ . '/../vendor/autoload.php';路径错误或autoload未生效。
排查路由定义与匹配逻辑
第一步：执行php yii debug/routes（需先确保console应用可运行），查看当前注册的所有路由。若命令报错“Command not found”，说明console配置缺失或未安装yii-debug扩展。
第二步：检查config/web.php中'urlManager'配置是否启用'enablePrettyUrl' => true且'showScriptName' => false。这两项必须同时为true，否则index.php会强制出现在URL中，而重写规则又试图隐藏它，造成冲突。
第三步：在任意控制器动作开头加入var_dump(\Yii::$app->requestedRoute); exit;。若输出为null或空字符串，说明Router未解析出有效route，常见于urlManager.rules中正则书写错误或defaults覆盖了默认行为。
