Ubuntu下Apache启用.htaccess时出现500内部服务器错误

DevOps 小满

2026-5-27

排查Ubuntu Apache2下.htaccess不生效的问题

你已经完成了基础配置步骤，但可能还有几个容易忽略的细节导致.htaccess没生效，我来帮你逐一排查：

确认网站根目录的AllowOverride配置
Ubuntu默认的网站根目录是/var/www/html，而非/var/www！很多人会误改apache2.conf里的<Directory /var/www/>段，但实际生效的是<Directory /var/www/html/>的配置。你需要打开/etc/apache2/apache2.conf，找到针对/var/www/html的目录配置段，确保AllowOverride All已经设置。
验证mod_rewrite模块是否真的加载
运行a2enmod rewrite后，一定要重启Apache服务：
```
sudo systemctl restart apache2
```
然后用以下命令确认模块是否成功加载：
```
apache2ctl -M | grep rewrite
```
如果输出包含rewrite_module (shared)，说明模块已生效；如果没有，检查重启时的错误日志（/var/log/apache2/error.log）看有没有加载失败的原因。
检查.htaccess文件的权限和位置
- 确保.htaccess文件放在你的网站根目录（比如/var/www/html），而非其他子目录。
- 给文件设置正确的权限，让Apache能读取：
```
sudo chmod 644 /var/www/html/.htaccess
sudo chown www-data:www-data /var/www/html/.htaccess
```
测试.htaccess是否真正生效
在.htaccess里添加一条测试规则：
```
RewriteRule ^ - [F]
```
然后访问你的网站，如果出现403 Forbidden，说明.htaccess已经在起作用了；如果页面正常显示，说明Apache还是没加载这个文件，回到前面的步骤排查配置。
检查虚拟主机配置是否覆盖了全局设置
打开你的虚拟主机配置文件（比如/etc/apache2/sites-available/000-default.conf），看看里面有没有<Directory>段，如果有，确保其中的AllowOverride设置为All，避免覆盖apache2.conf的配置。
清除浏览器缓存
有时候浏览器会缓存旧的页面内容，导致你误以为配置没生效，按Ctrl+F5强制刷新页面再测试。