Apache mod_rewrite规则静默失效，需分步验证：先确认RewriteEngine On已启用且位置正确，再检查mod_rewrite模块真实运行（httpd -M | grep rewrite），接着确保AllowOverride All和Options FollowSymLinks已配置并重启服务，最后用最小规则和LogLevel alert rewrite:trace3日志定位问题。

Apache mod_rewrite 规则写错不会报语法错误，而是静默失效——页面 404、重定向不触发、或规则完全没反应。所以“语法检查”不是靠编译器报错，而是靠验证执行路径 + 日志追踪 + 分步测试。

---

确认 RewriteEngine 已开启且位置正确

这是所有规则生效的前提，漏掉就全白写。

• .htaccess 或配置文件中，第一行必须是：
  RewriteEngine On
• 它不能被注释，不能放在 RewriteCond 或 RewriteRule 后面，也不能在 <IfModule> 块外孤立存在。
• 如果用 <IfModule mod_rewrite.c> 包裹，确保模块确实已加载（见下一点）。

---

验证 mod_rewrite 模块真实启用

光配置里有 LoadModule rewrite_module 不够，得确认它正在运行：

• 终端执行：

  httpd -M | grep rewrite   # CentOS/RHEL
  # 或
  apache2ctl -M | grep rewrite  # Ubuntu/Debian

  输出含 rewrite_module (shared) 才算成功。

• 若无输出，检查 httpd.conf 或 apache2.conf 中是否取消了 #LoadModule rewrite_module modules/mod_rewrite.so 的注释，并重启 Apache。

---

检查目录级重写权限是否放开

.htaccess 能否生效，取决于父级 <Directory> 配置：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

• 找到对应站点目录的 <Directory "/var/www/html">（或类似路径）块；
• 确保包含这两项：
  • AllowOverride All（不能是 None 或 FileInfo）
  • Options FollowSymLinks（旧版 Apache 必需，新版建议保留）
• 修改后必须重启 Apache，否则权限设置不生效。

---

用最小规则 + 日志定位问题

别一上来就写复杂正则，先跑通最简路径：

• 在 .htaccess 中只保留：

  RewriteEngine On
  RewriteRule ^test\.html$ /index.php [L]

  访问 yourdomain.com/test.html，看是否跳转到 index.php。

• 若不生效，启用重写日志（Apache 2.4 推荐）：
  在虚拟主机或主配置中加入：

  LogLevel alert rewrite:trace3

  然后查 error_log，搜索 [rewrite:，能看到每条规则是否匹配、为何跳过、替换结果是什么。

• ⚠️ 注意：trace3 以上级别影响性能，调试完务必调低或关闭。

---

常见语法陷阱快速核对

• 正则开头的 ^ 和结尾的 $ 是否遗漏？没锚定容易误匹配；
• RewriteRule 的替换路径：
  • 以 / 开头 → 绝对路径（从 DocumentRoot 起）；
  • 不以 / 开头 → 相对路径（需配合 RewriteBase，子目录部署时尤其关键）；
• RewriteCond 的条件顺序和逻辑：多个 RewriteCond 是“与”关系，任一不满足整组跳过；
• 标志 [L] 是否缺失？没有它，后续规则仍会继续执行，可能覆盖预期结果。

不复杂但容易忽略。