伪静态不生效需排查Nginx配置是否真实加载、规则位置是否正确、框架适配是否合规、网站目录设置是否匹配、HTTPS及二级目录路径是否准确、CDN干扰及注释语法是否规范。
伪静态规则在宝塔里不生效，先看 Nginx 配置是否真被加载
宝塔界面点“保存”不等于 Nginx 实际重载了配置，更不等于你改的 location 块真进了站点配置文件。常见现象是：规则写得没问题，但访问 /article/123 仍 404，或直接跳转到首页。
实操建议：
- 打开终端，执行
nginx -t，确认语法无误；再执行nginx -s reload手动重载（宝塔有时没自动触发） - 检查真实配置路径：
/www/server/panel/vhost/nginx/你的域名.conf，别只信宝塔「伪静态」标签页里显示的内容 - 重点看该文件里是否真有你填的规则——宝塔会把伪静态内容塞进
location / { ... }或单独的location ~ \.php$ { ... }块里，位置错了就失效 - 如果用了「反向代理」或「SSL 强制跳转」，规则可能被外层
server块提前拦截，此时需把伪静态逻辑挪到更外层或加break控制流程
ThinkPHP/Laravel 的 rewrite 规则在宝塔里要手动适配 Nginx 语法
宝塔「伪静态」下拉菜单里的 ThinkPHP 模板，本质是 Apache 的 .htaccess 转译版，直接粘贴进 Nginx 容易漏掉关键修饰符，比如 last 和 break 的区别、try_files 的 fallback 顺序。
实操建议：
- ThinkPHP 6 常见错误写法：
rewrite ^(.*)$ /index.php?s=$1;→ 缺少last，会导致循环重写，Nginx 报rewrite or internal redirection cycle - 正确写法应为：
try_files $uri $uri/ /index.php?s=$uri&$args;（推荐）或rewrite ^(.*)$ /index.php?s=$1 last; - Laravel 的
try_files $uri $uri/ /index.php?$query_string;必须放在location /块内，且不能和location ~ \.php$冲突；若宝塔自动生成了两个独立的location，要把try_files移进去 - 注意
$args和$query_string的差异：前者不含问号，后者含；Laravel 用后者，ThinkPHP 通常用前者
宝塔「网站目录」设置与伪静态规则发生路径冲突
当网站根目录不是 /www/wwwroot/你的域名，而是子目录（如 /www/wwwroot/你的域名/public），伪静态规则里的路径匹配就会错位。典型表现：后台能进，但前台路由全 404，或者 CSS/JS 404 连带出现。
实操建议：
- 进入宝塔「网站」→「设置」→「网站目录」，确认「运行目录」是否选对了（Laravel 是
/public，ThinkPHP 是/public或根目录，视版本而定） - 如果运行目录设为
/public，那所有伪静态规则都应基于该子目录生效——意味着location /实际匹配的是/public/下的请求，不是整个域名根 - 此时不要在伪静态里写
rewrite ^/admin/(.*)$ /admin/index.php?$1;，而应去掉开头的/，写成rewrite ^admin/(.*)$ /admin/index.php?$1;，否则路径多了一级 - 检查 Nginx 日志：
/www/wwwlogs/你的域名.error.log，搜索open() "/www/wwwroot/..." failed (2: No such file)，能快速定位路径错在哪一层
HTTPS + 二级目录部署时，rewrite 中的协议和 host 判断容易出错
用宝塔建了主站 HTTPS，又在子目录放了另一个 PHP 应用（如博客），伪静态规则里如果硬写 http:// 或依赖 $host，会因混合协议或 host 头被 CDN/反代覆盖而跳转失败。
实操建议：
- 避免在 rewrite 中拼接完整 URL，尤其别写
http://$host—— Nginx 不会自动转 HTTPS，且 CDN 后端可能传的是X-Forwarded-Proto: https，但$scheme仍是http - 用
$scheme替代硬编码协议，但前提是确保proxy_set_header X-Forwarded-Proto $scheme;已在宝塔「反向代理」或主配置中设置 - 二级目录伪静态（如
/blog/）必须加前缀匹配：location /blog/ { try_files $uri $uri/ /blog/index.php?$query_string; }，不能只写location / { ... }，否则主站规则会覆盖子目录 - 如果用了 CDN，检查「强制 HTTPS」开关是否开启，它可能绕过 Nginx 的 rewrite，直接 301 到 HTTPS 版本，导致伪静态还没跑就跳走了
最常被忽略的一点：宝塔「网站」→「配置文件」里手动加的注释行，如果包含中文或特殊符号（如 # 用于 Laravel），可能导致 nginx -t 报错退出，整段配置不加载——Nginx 注释只认英文井号，且不能跟在语句同一行末尾。
