伪静态不生效主因是mod_rewrite未启用或.htaccess被忽略：需终端执行httpd -M | grep rewrite验证模块真实加载，检查httpd.conf中LoadModule及Include语句，确认虚拟主机配置含AllowOverride All，并确保.htaccess首行有RewriteEngine On。
伪静态不生效，90% 是 mod_rewrite 没启用，或 .htaccess 被 Apache 忽略了——不是规则写错了，而是根本没走到规则这一步。
确认 mod_rewrite 模块是否已启用
宝塔面板里「软件商店 → Apache → 设置 → 模块管理」能看到已启用模块列表，但这个界面有时会“假显示”：勾选了不代表真正加载成功。最可靠的验证方式是终端执行：
httpd -M | grep rewrite
如果输出包含 rewrite_module (shared) 才算真实启用；若无输出，说明模块未加载。此时不能只点面板上的“启用”，还要检查：
- /www/server/apache/conf/httpd.conf 中是否有 LoadModule rewrite_module modules/mod_rewrite.so（且未被注释）
- 同一文件中是否漏掉了 Include conf/vhost/*.conf 或类似包含语句（否则虚拟主机配置不生效）
- 修改后必须执行 systemctl restart httpd 或在宝塔面板点击「重载配置」，仅「重启」可能不触发模块重载
检查 .htaccess 是否被允许读取
Apache 默认禁止目录下 .htaccess 生效，即使写了规则也直接跳过。关键看对应站点的虚拟主机配置（路径如 /www/server/panel/vhost/apache/xxx.com.conf）中，<directory></directory> 块内是否有：
AllowOverride All
如果写的是 AllowOverride None 或缺失该指令，.htaccess 就完全被无视。常见错误包括：
- 宝塔新建站点时默认生成的是 AllowOverride None（为性能考虑）
- 手动改了主配置但忘了同步到每个子站点的 conf 文件
- 使用了 <directorymatch></directorymatch> 等高级匹配，却没覆盖到实际网站根目录路径
改完记得重载 Apache，别只改 .htaccess 自己
验证 RewriteEngine 是否在 .htaccess 中正确开启
很多人复制了伪静态规则，但开头漏了这行：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
RewriteEngine On
没有它，所有 RewriteRule 和 RewriteCond 都不执行。另外注意：
- RewriteBase 在子目录部署时容易出错，比如站点绑在 example.com/blog/，但 .htaccess 里写 RewriteBase / 就会导致重写路径错位
- 规则中的 [L] 标志不是必须的，但缺了可能导致后续规则意外触发，调试时建议加上
- 宝塔文件管理器默认隐藏以点开头的文件，需在右上角开启「显示隐藏文件」才能编辑 .htaccess
日志里找真实失败原因
光看网页 404 或 500 没用，Apache 的重写过程只记录在 error_log（路径见站点配置里的 ErrorLog 指令）。临时开启详细重写日志：
RewriteLogLevel 3<br>RewriteLog "/www/wwwlogs/rewrite.log"
⚠️ 注意：这两行只能放在主配置或虚拟主机配置里，.htaccess 不支持；且 RewriteLogLevel 在 Apache 2.4+ 已废弃，新版本应改用：
LogLevel alert rewrite:trace3
然后查 /www/wwwlogs/xxx.error.log，搜索 rewrite:，你会看到每一步匹配、跳过、重写的完整链条——这才是定位问题的唯一可靠依据。
