伪静态不生效主因是Yii的urlManager三配置缺一（enablePrettyUrl、showScriptName、rules）或Web服务器未正确转发请求：Apache需启用mod_rewrite、AllowOverride All并配置.htaccess；Nginx需在location /中用try_files $uri $uri/ /index.php?$args;。
伪静态配不生效？90% 是 urlManager 三处配置缺一，或 Web 服务器 rewrite 没兜住请求——不是 Yii 配错了，是请求根本没进 PHP。
enablePrettyUrl、showScriptName、rules 必须同时设对
Yii 2.0+ 的伪静态开关有三个硬性依赖，少一个就 404：
-
enablePrettyUrl必须为true，否则整个美化逻辑不加载 -
showScriptName必须为false，否则 URL 永远带index.php（比如/index.php/site/index） -
rules至少得有一条兜底规则，例如'' => 'site/index'，否则根路径/直接报错
常见错误：只改了 enablePrettyUrl 和 rules，但漏掉 showScriptName => false，结果所有链接仍含 index.php；或者 rules 空着，首页直接 404。
Apache 下 .htaccess 写法和关键检查点
Yii 的 urlManager 只负责解析进来的 URL，不负责重写。如果 Apache 没把 /user/123 转给 index.php，那请求压根不会走到 Yii。
标准 .htaccess 内容（放在 web/ 目录下，与 index.php 同级）：
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]
必须确认的三件事：
- Apache 已启用
mod_rewrite（httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so前无#） - 对应目录的
AllowOverride All（不是None） - 项目根目录下确实存在
.htaccess文件，且文件名完整（Windows 下容易误存为.htaccess.txt）
本地用 XAMPP/WAMP 却始终 404？大概率是 AllowOverride 没开。
rules 规则顺序和正则写法易踩坑
URL 规则按数组顺序从上到下匹配，命中即停。顺序错，路由就乱。
比如你要支持：
/api/v1/users/user/123/post/view
就得这样写 rules：
'api/v1/<controller:>' => 'api/v1/<controller>', 'user/<id:>' => 'user/view', 'post/<action:>' => 'post/<action>', '<controller:>/<action:>' => '<controller>/<action>',</action></controller></action:></controller:></action></action:></id:></controller></controller:>
不能把泛匹配 ' 放最前，否则 /user/123 会被当成 controller=user, action=123，根本进不了你写的 user/ 规则。
另外注意：\d+ 是 PCRE 正则，不是通配符；想支持可选参数（如 /user/123?tab=profile），不用改 rule，Yii 默认保留 query string。
Nginx 用户别照抄 Apache 的 .htaccess
Nginx 没有 .htaccess，rewrite 逻辑全在 server 块里。关键就这一行：
location / {
try_files $uri $uri/ /index.php?$args;
}
它表示：先找真实文件/目录，找不到就交给 index.php 处理，并把原始 query string（$args）传进去。漏掉 $args，GET 参数会丢失；写成 /index.php?r=... 是错的，Yii 2.0+ 不再依赖 r 参数。
如果部署在子目录（比如 https://example.com/myapp/），try_files 得改成：
try_files $uri $uri/ /myapp/index.php?$args;
而 urlManager 中还需加 'baseUrl' => '/myapp'，否则生成的 URL 会漏前缀。
最常被忽略的一点：伪静态是否生效，跟 urlManager 配置无关的部分，其实占一半——Web 服务器转发是否正确、入口脚本是否被隐藏、规则顺序是否合理，这三个地方任何一个出问题，都会让调试变成盲猜。
