apache mod_rewrite生效必须满足三条件：模块真实加载、allowoverride all授权、规则正确匹配。需用a2enmod或取消loadmodule注释启用模块，验证rewrite_module (shared)；修改directory配置放开.htaccess权限；编写最小可测规则并查trace日志定位问题。
Apache mod_rewrite 运维实战不是写一堆正则炫技，而是快速让规则跑通、稳住线上、排查无声故障。核心就三件事：模块真加载了、权限真放开了、规则真匹配上了——缺一不可。
确认 mod_rewrite 模块已启用并正在运行
光在配置里取消注释 LoadModule rewrite_module 不够，得验证它实际加载成功。
- Ubuntu/Debian 系统执行：
sudo a2enmod rewrite && sudo systemctl restart apache2 - CentOS/RHEL 系统检查
/etc/httpd/conf/httpd.conf中该行是否去掉了#，再重启服务 - 统一验证方式：
apache2ctl -M | grep rewrite（Ubuntu）或httpd -M | grep rewrite（CentOS），看到rewrite_module (shared)才算到位
授权 .htaccess 使用重写指令
很多规则写了却没反应，90% 是卡在这步：Apache 默认禁止目录级重写。
Apache 2.4.62
下载
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
- 找到对应站点的
<directory></directory>配置块（可能在apache2.conf、httpd.conf或虚拟主机文件中） - 把
AllowOverride None改成AllowOverride All - 确保
Options包含FollowSymLinks（旧版 Apache 必需，新版建议保留） - 改完必须重启 Apache，
.htaccess不会热加载
写一条能验证的最小规则
别一上来就写复杂路由，先用最简路径确认整个链路通畅。
- 在网站根目录新建或编辑
.htaccess，只保留两行：RewriteEngine OnRewriteRule ^test$ /index.php [L] - 访问
https://yoursite.com/test，应正常显示首页内容，地址栏仍是/test（说明是内部重写，非跳转） - 若 404，先检查
RewriteEngine On是否拼错；若跳转到首页但地址变了，可能是规则漏了[L]或被其他规则干扰
调试失败时看日志而不是猜
mod_rewrite 错误不报错，只沉默失效。靠日志才能定位卡在哪一步。
- Apache 2.4 推荐开启 trace 日志：
LogLevel alert rewrite:trace3（加在虚拟主机或主配置中） - 重启后访问触发规则的 URL，然后查
error_log，会看到每条规则是否匹配、条件是否成立、重写如何展开 - 常见线索：
strip per-dir prefix表示路径前缀被剥离（.htaccess规则匹配的是相对路径）；pass through表示未匹配继续往下走；initial redirect表示发生了外部跳转
