Apache的rewrite_module未启用、AllowOverride未设为All、重写规则错误、使用宝塔伪静态更可靠，以及多Directory块中AllowOverride需统一配置，是.htaccess不生效的五大主因。
Apache 的 rewrite_module 没启用，.htaccess 就完全不生效
宝塔面板默认安装 Apache 时，rewrite_module 多数情况下是禁用状态——这不是 Bug，是安全策略。只要模块没加载，无论 .htaccess 写得多规范，Apache 都会直接忽略重写规则，连报错都不会有，表现为“URL 重写完全没反应”。
实操建议：
- 登录宝塔面板 → 左侧「软件商店」→ 找到已安装的 Apache → 点击「设置」→「配置修改」→ 在「Apache 配置文件」中确认是否存在
LoadModule rewrite_module modules/mod_rewrite.so这一行（通常在文件开头附近）；若被注释（行首有#），删掉即可 - 更稳妥的方式是进终端执行：
httpd -M | grep rewrite，输出含rewrite_module (shared)才算真正启用 - 改完必须重启 Apache：
systemctl restart httpd或在宝塔面板里点「重启」，仅重载配置（reload）可能不生效
.htaccess 不起作用？检查对应站点的 AllowOverride 配置
即使 rewrite_module 已启用，.htaccess 仍可能被 Apache 主动屏蔽——关键在虚拟主机配置里的 AllowOverride 指令。宝塔默认为 None，意味着完全禁止读取 .htaccess。
实操建议：
- 在宝塔面板中打开该站点 → 「配置文件」→ 找到
<directory></directory>块（路径以你实际站点为准） - 确认其中包含
AllowOverride All（不是None或FileInfo）；若只有AllowOverride None，改成All并保存 - 如果该
<directory></directory>块不存在，需手动添加完整块（注意路径和引号），否则 Apache 启动会报错 - 改完必须重启 Apache，
AllowOverride不支持热重载
重写规则本身写错，但 Apache 不报错，只静默失败
Apache 对 .htaccess 中语法错误的容忍度很高：规则写错、正则漏转义、条件顺序颠倒，多数时候只是跳过执行，浏览器返回 404 或原 URL，不会抛出明显提示。
Apache Tika Content Extraction Hub
下载
通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。
实操建议：
- 最简验证法：在
.htaccess中先写一条强制跳转：RewriteRule ^test$ /index.php [R=302,L]，访问/test看是否跳转；成功再逐步加复杂逻辑 - 开启重写日志（仅调试用）：在站点配置中加两行：
RewriteLogLevel 3和RewriteLog "/www/wwwlogs/rewrite.log"（注意路径可写），然后查日志定位哪条规则没匹配上 - 避免常见坑：
RewriteCond必须紧贴其后的RewriteRule，中间不能插其他指令；%{REQUEST_URI}开头带斜杠，而^匹配的是去掉域名后的路径部分
宝塔面板的「伪静态」功能比手写 .htaccess 更可靠
很多用户反复调试 .htaccess 失败，其实是因为宝塔提供了更底层、更可控的伪静态入口——它直接把规则写进虚拟主机配置，绕过了 AllowOverride 和 .htaccess 解析链路，稳定性高得多。
实操建议：
- 站点 → 「伪静态」→ 选择对应程序类型（如 ThinkPHP、Laravel、WordPress），或粘贴规则到「自定义」框 → 保存 → 重启 Apache
- 此时规则实际写入的是
/www/server/panel/vhost/apache/xxx.conf中的<ifmodule mod_rewrite.c></ifmodule>块，无需担心.htaccess权限或路径问题 - 如果用了宝塔的「网站监控报表」或「防篡改」功能，它们可能自动锁定
.htaccess文件，导致手动修改被覆盖——这种场景下，必须用「伪静态」入口
最常被忽略的一点：Apache 配置里如果有多个 <directory></directory> 块（比如宝塔自动生成的 SSL 块和主块），AllowOverride 必须在所有相关块中都设为 All，否则 HTTPS 访问时规则照样失效。
