documentroot 修改后不生效，关键在未通过语法检查、未用 restart 而非 reload、未同步更新 directory 权限块及虚拟主机配置，且需排除 selinux 干扰；必须验证状态码 200、路径映射一致、配置已启用。
DocumentRoot 修改后不生效，通常不是“改了没重启”，而是改完没验证、没同步关联配置，或重启方式不对。直接重启服务只是最后一步，关键在前面是否做对。
先确认修改已保存且语法正确
Apache 不会自动加载错误配置。必须先通过语法检查：
- Debian/Ubuntu 系统：运行 sudo apache2ctl -t 或 sudo apachectl configtest
- RHEL/CentOS 系统：运行 sudo httpd -t
- 输出必须是 Syntax OK；若报错（如路径不存在、指令拼错、引号不匹配），需先修复配置文件再继续
区分重启（restart）和重载（reload）
两者效果不同，选错会导致看似“不生效”：
- sudo systemctl restart apache2（Ubuntu/Debian）或 sudo systemctl restart httpd（RHEL/CentOS）：完全停止再启动进程，适用于 DocumentRoot、端口、模块等底层变更
- sudo systemctl reload apache2 或 sudo systemctl reload httpd：仅重载配置，不中断已有连接；但 DocumentRoot 变更必须用 restart，reload 不会更新根目录映射
- Windows/macOS 用户：使用 Apache 自带的 httpd -k restart 或控制面板服务重启
重启后必须验证三件事
光看服务状态 running 不代表 DocumentRoot 生效：
-
访问一个静态文件：比如直接请求
/favicon.ico或/index.html，用浏览器开发者工具 Network 标签查看返回状态码——应为 200，而非 403 或 404 -
确认文件真实位置与 URL 路径匹配：若 DocumentRoot 改为
/var/www/myapp/public，那么https://example.com/css/app.css必须对应服务器上/var/www/myapp/public/css/app.css -
检查 Directory 权限块是否同步更新：
<directory></directory>的路径必须和 DocumentRoot 完全一致，且含Require all granted（Apache 2.4+）
常见卡点：改了 DocumentRoot 却还是旧目录
这不是重启问题，而是配置被覆盖或未启用：
- 检查是否在
sites-enabled/下启用了正确的虚拟主机配置——a2ensite yoursite.conf后才生效，仅放sites-available/不起作用 - 确认没有多个
DocumentRoot指令冲突：全局 httpd.conf、虚拟主机配置、.htaccess 都可能影响，优先以最终匹配的<virtualhost></virtualhost>块为准 - SELinux 或 AppArmor 拦截：CentOS/RHEL 上运行 sudo setenforce 0 临时关闭 SELinux 测试；若页面立刻正常，说明需打标签：sudo semanage fcontext -a -t httpd_sys_content_t "/new/path(/.*)?"，再 sudo restorecon -Rv /new/path
