Mac Ventura下Apache2的.htaccess重写规则失效问题

DevOps 小满

2026-6-30

解决Mac环境下.htaccess重写规则导致的404错误

核心问题排查与修复步骤

修正RewriteCond语法错误：你当前的规则中，RewriteCond的变量和条件标识之间缺少空格，这会导致条件判断失效。正确的规则应该是：
```
# Turn mod_rewrite on
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule ^([a-zA-Z0-9]+)/?$ display.php?username=$1
```
注意%{REQUEST_FILENAME}和!-f/!-d之间必须有空格，否则Apache无法正确解析条件。
确认站点目录配置：检查Apache的站点配置文件（通常在/usr/local/etc/httpd/extra/httpd-vhosts.conf或自定义配置文件），确保：
- DocumentRoot设置为/usr/local/var/www/example
- 对应<Directory "/usr/local/var/www/example">块中，同时包含AllowOverride All和Require all granted，示例：
```
<Directory "/usr/local/var/www/example">
    AllowOverride All
    Require all granted
</Directory>
```
修改后重启Apache生效。
验证.htaccess文件位置：确保.htaccess文件直接放在/usr/local/var/www/example目录下，而非子目录，否则重写规则不会作用于整个站点。
测试基础重写逻辑：先使用简单规则验证重写是否生效，比如替换原有RewriteRule为：
```
RewriteRule ^test$ display.php?username=test
```
访问http://localhost/example/test，如果能正常显示用户名test，说明正则表达式或原有规则的匹配逻辑可能存在问题，再逐步恢复原规则调试。
查看Apache错误日志：如果问题仍存在，查看Apache错误日志（路径通常为/usr/local/var/log/httpd/error_log），日志会明确提示404错误的具体原因（比如文件不存在、重写规则未触发等），帮助定位问题。
确认mod_rewrite已启用：执行命令apachectl -M | grep rewrite，如果输出包含rewrite_module (shared)，说明模块已启用；若未输出，需在Apache配置文件中取消注释LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so，然后重启Apache。