Apache启动失败或报Invalid module name，大概率是LoadModule rewrite_module modules/mod_rewrite.so写错，需确保仅保留唯一未注释行且模块名不含.so后缀；同时AllowOverride必须设为All并置于正确Directory块内，RewriteEngine On不可遗漏，.htaccess文件名须为纯.htaccess且UTF-8无BOM编码。
确认 mod_rewrite 模块已加载且未被重复声明
Apache 启动失败或报 Invalid module name，大概率是 LoadModule rewrite_module modules/mod_rewrite.so 这行写错了。XAMPP 默认带这个模块，但默认被注释；手动添加时容易多写一个 .so（比如写成 rewrite_module.so），或复制粘贴出两个相同 LoadModule 行——Apache 会拒绝启动。
操作建议：
- 打开
C:\xampp\apache\conf\httpd.conf（Windows）或对应路径 - 搜索
rewrite_module，只保留**唯一一行**未注释的：LoadModule rewrite_module modules/mod_rewrite.so - 注意：模块名不含扩展名，
.so是文件后缀，不是模块名一部分 - 改完后，在命令行执行
httpd -t验证语法，返回Syntax OK才继续
AllowOverride 必须设为 All，且位置要对
即使模块加载成功，.htaccess 里的 RewriteEngine On 依然无效，说明 Apache 拒绝读取该文件——根本原因是 AllowOverride None 还在生效。
常见陷阱：
- 全局
<Directory "C:/xampp/htdocs">块里改了AllowOverride All，但你项目实际放在htdocs/myapp，而虚拟主机配置里又套了一层<Directory>，里面仍是None，那外层设置就白改 - 用了
<VirtualHost>却把AllowOverride All写在外部<Directory>里，规则不会继承过去 - 路径大小写错误（Windows 不敏感，但某些配置解析器会卡住）
验证方法：在 htdocs 下放一个仅含 garbage_text 的 .htaccess，访问任意页面。若返回 500，说明文件被读取；若无反应，AllowOverride 仍为 None。
重写规则必须显式开启引擎并注意 RewriteBase
RewriteEngine On 不是可选的默认行为，漏写就会整个 .htaccess 重写逻辑静默失效，浏览器只显示 404 或原始 PHP 路径。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
如果你的项目不在 htdocs 根目录（例如在 htdocs/blog），而规则里用 ^test$ 匹配，Apache 实际匹配的是完整 URI 路径（即 /blog/test），此时不加 RewriteBase /blog/，$1 捕获和跳转路径都会错位。
典型结构示例（放在 htdocs/blog/.htaccess）：
RewriteEngine On
RewriteBase /blog/
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?route=$1 [L,QSA]
注意：[QSA] 保留原查询参数，[L] 防止后续规则干扰，这两项在 Laravel、CodeIgniter 等框架中几乎是标配。
调试必须看 error.log，别信浏览器 500 页面
浏览器只告诉你“服务器内部错误”，真正线索全在日志里。XAMPP 的 Apache 错误日志路径是 C:\xampp\apache\logs\error.log（Windows），打开后搜索关键词：rewrite、htaccess、Invalid command 'RewriteEngine'。
高频线索解读：
-
Invalid command 'RewriteEngine'→ 模块没加载，或LoadModule行有语法错误 -
Request exceeded the limit of 10 internal redirects→ 规则形成死循环，检查RewriteCond是否漏掉!-f/!-d判断 -
File does not exist: C:/xampp/htdocs/test→ 规则没生效，请求直接落到物理路径，说明RewriteEngine未开启或AllowOverride未生效
最后提醒：Windows 下 .htaccess 文件名必须是纯 .htaccess（无任何后缀），编码必须是 UTF-8 无 BOM；用记事本另存为时选“ANSI”或“UTF-8（无签名）”，否则 Apache 会因不可见字符报错。
