Apache mod_rewrite规则写错通常静默失效，需分步验证：先确认模块加载、AllowOverride生效、RewriteEngine开启；再用最简规则测试；最后通过LogLevel alert rewrite:trace3查错误日志定位问题。
先确认 RewriteEngine 真的开启了
很多问题其实卡在这一步：RewriteEngine on 写了，但模块没加载，或目录权限被禁用。
- 检查
httpd.conf或虚拟主机配置里是否启用模块：确保LoadModule rewrite_module modules/mod_rewrite.so这行没被注释 - 检查对应目录是否允许 .htaccess 覆盖：
AllowOverride All（或至少AllowOverride FileInfo）必须生效 - 重启 Apache 后，用
apache2ctl -M | grep rewrite（Debian/Ubuntu）或httpd -M | grep rewrite（RHEL/CentOS）确认模块已加载
用最简规则做“能跑通”测试
别一上来就写复杂正则。先验证整个链路是否通畅：
- 在网站根目录新建或编辑
.htaccess，只保留两行：
<IfModule mod_rewrite.c> RewriteEngine on RewriteRule ^test-rewrite$ /index.html [L] </IfModule>
访问 https://yoursite.com/test-rewrite，应直接显示 index.html 内容（地址栏仍为 /test-rewrite）。如果 404，说明重写引擎根本没工作；如果跳转失败，再查路径、权限或模块状态。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
打开重写日志，看它到底匹配了什么
Apache 2.4 推荐用 LogLevel，比旧版 RewriteLog 更安全可控：
- 在虚拟主机或主配置中添加（不要放 .htaccess）：
LogLevel alert rewrite:trace3 - 重启 Apache，然后发起一次请求（比如访问刚才的
/test-rewrite） - 查看错误日志（通常是
/var/log/apache2/error.log或/var/log/httpd/error_log），搜索[rewrite:trace开头的行 - 你会看到每条规则是否匹配、捕获组值、是否跳过、是否应用了 [L] 等细节。trace3 足够定位常见问题；trace5+ 信息爆炸，仅限深度排查
注意常见“假失败”陷阱
规则看似正确，但实际不生效，往往因为这些细节：
-
路径上下文差异：在
.htaccess中，RewriteRule匹配的是“URL 路径去掉前缀后”的部分（比如站点是example.com/blog/，.htaccess 在/blog/目录下，则规则里的^foo实际匹配的是/blog/foo的foo部分） - 条件顺序和 [L] 标志：[L] 表示“最后一条”，但只对当前轮次有效；有多个规则时，[L] 后面的规则仍可能被后续轮次处理，除非加 [END]
-
正则开头结尾没锚定：写成
foo会匹配/foo、/foobar、/afoo；应写成^foo$或^foo/明确边界 -
未启用 FollowSymLinks（某些系统要求）：在
<Directory>块中，确保有Options +FollowSymLinks或Options +SymLinksIfOwnerMatch
