伪静态未生效需依次检查Nginx重写模块加载、配置重载、PHP pathinfo支持、子目录/多域名适配及框架规则匹配性；务必查看error.log定位真实错误。
伪静态没生效？先确认 Nginx 重写模块和配置加载方式
宝塔面板里的“伪静态”开关本身不启用任何功能，它只是往站点的 nginx.conf 片段里插入一段 location / 块。真正起作用的是 Nginx 是否加载了该规则、是否满足重写条件，以及 PHP 是否能正确接收 PATH_INFO 或 QUERY_STRING。
常见错误现象：页面 404、URL 中仍带 index.php、后台跳转错乱。
- 检查 Nginx 是否已重载：修改伪静态后必须点“重载 Nginx”，仅保存不生效
- 确认站点根目录下没有冲突的
.htaccess（Apache 遗留文件，Nginx 不读取，但可能误导判断） - PHP 要求开启
pathinfo支持（尤其 ThinkPHP/Laravel），可在宝塔 PHP 设置 → “禁用函数”中确认未禁用apache_getenv等辅助函数 - 若用子目录部署（如
/blog/），伪静态规则中的rewrite ^(.*)$ /index.php?s=$1 last;会出错，应改为rewrite ^/blog/(.*)$ /blog/index.php?s=$1 last;
不同框架的伪静态规则不能混用
ThinkPHP、Laravel、WordPress 的重写逻辑差异很大，直接套用会导致路由解析失败或无限重定向。宝塔提供的模板是按框架入口行为定制的，不是通用万能规则。
使用场景举例：你用 Laravel 但选了 ThinkPHP 模板，index.php?s=xxx 这种参数 Laravel 根本不认，结果就是所有请求都 fallback 到首页或 404。
-
ThinkPHP 6+（PATHINFO 模式）：
if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; } -
Laravel（标准模式）：
if (!-e $request_filename) { rewrite ^(.*)$ /index.php last; }（注意没有?s=$1） -
WordPress：
location / { try_files $uri $uri/ /index.php?$args; }（必须带$args，否则分页、搜索失效） - Phpcms v9 多站点需额外判断 host：
if ($host ~* ^([a-z0-9\-]+)\.example\.com$) { set $subdomain $1; }，再配合rewrite把请求导向对应子站目录
二级域名伪静态要分两步走：先捕获子域，再映射路径
想让 shop.example.com 自动指向 /www/wwwroot/example.com/shop/，不能只靠一条 rewrite。Nginx 不会自动把子域名变成路径段，得靠变量提取 + root 重设或内部重写。
容易踩的坑：只写 rewrite ^(.*)$ /shop/$1 last;，这只能改 URI，不能切换物理目录；用户访问 shop.example.com/admin 仍会去找主站根目录下的 admin，而不是子站目录。
- 推荐做法是在站点配置中用
server_name shop.example.com;单独建一个站点，根目录直指/www/wwwroot/example.com/shop/，再为其单独配伪静态规则——最稳 - 若坚持单站点多二级域，需在主配置里用
map提取子域：map $host $subdir { default ""; ~^(\w+)\.example\.com$ $1; }，再用root /www/wwwroot/example.com/$subdir; - 切勿依赖
if ($host = ...)做重定向，Nginx 官方明确不推荐在server块中用if做 host 判断，易引发不可预期的匹配顺序问题
自定义规则调试：别只看浏览器，要看 Nginx error.log
伪静态出问题时，浏览器只显示 404 或空白，真正线索藏在日志里。比如 rewrite or internal redirection cycle 表示重写死循环；no such file or directory 可能是 $request_filename 判定路径错了。
调试建议直接打开宝塔 → 网站 → 日志 → 错误日志，实时刷新并触发一次请求，比猜强十倍。
- 临时加日志观察重写过程：
rewrite_log on;（需在 Nginx 主配置开启error_log /www/wwwlogs/nginx_error.log notice;） - 测试正则是否匹配：用在线工具（如 regex101）粘贴你的 URI 和规则，注意 Nginx 使用 PCRE，不支持 lookbehind
- 避免滥用
break：它会终止当前 location 块内后续指令，常导致fastcgi_pass没执行就返回 404 - 上线前务必关掉
rewrite_log，它严重拖慢性能
伪静态真正的复杂点不在写那几行正则，而在于它横跨 Nginx 配置层、PHP 运行时环境、框架路由机制三层。少一个环节对不上，整条链就断了。很多人卡在“明明规则一样，别人能用我不能”，往往就是 PHP 的 $_SERVER['PATH_INFO'] 没传进来，或者 Nginx 把 $request_uri 和 $uri 搞混了。
