mod_rewrite路径匹配不生效主因是Apache未将请求路由至重写逻辑：DocumentRoot与<Directory>路径须逐字一致、AllowOverride未设为FileInfo或All、URI被mod_alias等前置模块拦截、RewriteEngine未开启或作用域错位。

mod_rewrite 路径匹配不生效，通常不是规则写错了，而是 apache 根本没把请求路由到你的重写逻辑里——路径字符串没对上、作用域被跳过、或 uri 在进 rewrite 引擎前就被拦下了。

确认 DocumentRoot 和 <Directory> 路径严格一致

Apache 对路径大小写、末尾斜杠、符号链接解析都敏感，差一个字符就完全忽略整个块：

• DocumentRoot "/var/www/myapp" 必须和 <Directory "/var/www/myapp"> 中的路径逐字相同（包括大小写、无多余斜杠）
• 若 DocumentRoot 是软链接（如 /var/www/site → /opt/webroot），则 <Directory> 块必须指向真实路径 /opt/webroot，或在块内加 Options +FollowSymLinks 并确保目标目录有可执行权限（+x）
• 用命令验证实际生效的目录配置：sudo apache2ctl -D DUMP_DIR，检查输出中你的路径是否被识别并应用了 Require all granted

检查 AllowOverride 是否允许重写指令执行

即使路径匹配成功，若权限未开，RewriteCond 和 RewriteRule 也会被静默跳过：

Apache Superset Dashboard and SQL Exploration Skill

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

下载

• 在对应 <Directory> 块中，AllowOverride 不能是 None；至少设为 FileInfo（支持 RewriteEngine/Cond/Rule），开发环境可用 All
• 若使用 .htaccess，请确认它位于 DocumentRoot 根目录下，文件名是 .htaccess（不是 .htaccess.txt），且第一行是 RewriteEngine On
• 查看错误日志：sudo tail -n 10 /var/log/apache2/error.log，出现 “AH00529: unable to check htaccess file” 表示 Apache 找到了文件但无权读取——此时要查文件权限或 SELinux 上下文，不是改路径

排除 URI 预处理阶段被拦截

有些请求根本到不了 mod_rewrite，因为它们在更早环节就被拒绝或重定向了：

• URL 含 %2F（即编码后的 /）时，Apache 默认拦截并返回 404；需在 <VirtualHost> 块中添加 AllowEncodedSlashes On（不能写在 .htaccess 中）
• mod_alias（如 Alias、Redirect）等前置模块可能先于 mod_rewrite 处理请求，导致重写规则不触发；可在 RewriteRule 末尾加 [PT]（Pass Through）标志强制交还控制权
• 检查是否有兜底的 <Directory /> 块设置了 Require all denied，它会覆盖你更具体的配置——确保你的站点 <Directory> 块定义在它之后，且路径更精确

验证重写引擎是否真在运行上下文中工作

作用域错位是隐形杀手：RewriteCond 必须和 RewriteRule 处于同一有效作用域内：

• RewriteEngine On 必须出现在 RewriteCond 之前，且两者在同一 <VirtualHost>、同一 <Directory> 或同一 .htaccess 文件中
• 不要把 RewriteCond 写在 <Location> 或 <Files> 块里——这些上下文不支持条件判断，只接受部分 RewriteRule 且行为受限
• 临时加一条测试规则：RewriteRule ^test-rewrite$ /index.html [L]，访问 /test-rewrite 看是否跳转；若失败，说明引擎未启用或作用域无效