apache mod_rewrite常见错误表现为404、500或资源错乱，主因是规则逻辑错误、模块未启用（需a2enmod rewrite）、allowoverride非all、重写目标缺失、缺少rewriteengine on、正则循环、标志误用、未豁免静态文件及%2f被拦截等。
Apache mod_rewrite 的常见错误不是“报错代码”本身，而是请求行为异常后返回的 HTTP 状态码（如 404、500、403）或页面内容错乱（比如图片变白屏、PHP 脚本输出 HTML 而非二进制资源），根本原因几乎都出在规则逻辑、权限配置或路径解析环节。
404 Not Found：规则没生效或路径被拦截
最常见却最容易误判。表面是“找不到文件”，实际往往是：
-
mod_rewrite 模块未启用：运行
apachectl -M | grep rewrite，无输出说明未加载；Ubuntu/Debian 执行sudo a2enmod rewrite，CentOS/RHEL 检查httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so是否已取消注释 -
.htaccess 不被读取：虚拟主机或目录配置中
AllowOverride为None，需改为All或至少FileInfo；同时确认DocumentRoot对应目录有读取权限 -
重写目标不存在：例如规则
RewriteRule ^/user/(\d+)$ /profile.php?id=$1，但/profile.php文件实际在子目录或已被移走
500 Internal Server Error：规则语法或逻辑冲突
服务器内部崩溃，通常由 .htaccess 写错引发：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
缺少
RewriteEngine On：所有规则前必须显式开启引擎，否则整段被忽略，但某些 Apache 版本会直接报 500 -
正则无限循环：如
RewriteRule ^(.*)$ index.php?path=$1 [L]未加条件判断，当index.php被重写后又匹配自身，触发递归超限 -
标志使用错误：比如在内部重写中误用
[R]（强制跳转），或漏掉[L]导致后续规则意外执行；[QSA]忘记加可能丢失原有查询参数
图片/CSS/JS 加载失败（白屏、样式错乱）
浏览器返回 200 但内容不对——HTML 替代了图片，本质是静态资源被错误重写：
-
规则过于宽泛：像
RewriteRule ^(.*)$ index.php/$1会把/assets/img/logo.png也转发给 PHP，而 PHP 脚本无法输出 PNG 二进制流 -
缺少静态资源豁免：应在规则前加条件排除真实存在的文件和目录：
RewriteCond %{REQUEST_FILENAME} !-fRewriteCond %{REQUEST_FILENAME} !-d
更进一步可排除特定路径：RewriteCond %{REQUEST_URI} !^/assets/
%2F 或 %5C 导致 404：URL 编码斜杠被拒绝
含 %2F（即编码后的 /）的 URL 直接被 Apache 拦截，不进 mod_rewrite：
- 根本限制在 Apache 核心层：这是安全机制，默认禁止解码后的路径含多级目录结构，防止路径遍历攻击
-
必须改主配置：在
<virtualhost></virtualhost>块内添加AllowEncodedSlashes On（注意不能写在 .htaccess 中）；重启 Apache 生效 - 替代方案有限：前端多次 urlencode（如两次）可绕过，但 URL 变得极长且难维护，仅作临时调试用
