documentroot 修改后未生效，主因是配置未被加载、多处定义冲突或缺少对应 directory 权限配置；需检查加载顺序、定位所有 documentroot 定义、确保修改启用的 vhost 文件、重载服务，并同步配置 directory 块、权限、selinux 上下文及符号链接选项。
DocumentRoot 路径改完重启 Apache 却没生效？
直接修改 DocumentRoot 后，访问网站仍是旧内容，大概率是 Apache 没读到新配置，或存在多处定义冲突。Apache 会按加载顺序取最后一个生效的 DocumentRoot，常见于 vhost 文件、httpd.conf、apache2.conf 甚至 .htaccess（虽不直接影响根目录，但可能干扰路径解析）。
实操建议：
- 用
apachectl -t -D DUMP_INCLUDES查看实际加载的配置文件顺序 - 用
grep -r "DocumentRoot" /etc/apache2/（Debian/Ubuntu）或/etc/httpd/（RHEL/CentOS）定位所有定义位置 - 确认修改的是当前启用的虚拟主机配置（如
/etc/apache2/sites-enabled/000-default.conf），而非仅sites-available下未链接的文件 - 改完必须运行
sudo systemctl reload apache2（或httpd），restart更稳妥，但reload失败时不会中断服务
迁移后页面 403 Forbidden？权限和 SELinux 是关键
新目录路径即使语法正确，Apache 进程（通常是 www-data 或 apache 用户）也必须有执行（x）权限才能进入目录、读取（r）权限才能打开文件。常见错误是只给了 755 目录但忘了父级路径——比如迁到 /data/www/example.com，则 /data、/data/www 都需对 Apache 用户可执行。
SELinux 环境下（如 CentOS/RHEL 默认开启）还需额外处理：
- 用
ls -Z /new/document/root检查上下文，正常应为httpd_sys_content_t - 若不是，运行
sudo semanage fcontext -a -t httpd_sys_content_t "/new/document/root(/.*)?"，再sudo restorecon -Rv /new/document/root - 临时关闭 SELinux 测试是否为根源：
sudo setenforce 0（仅调试，勿长期关闭）
Alias 和 <directory></directory> 必须同步更新
DocumentRoot 只指定根路径，但 Apache 不会自动赋予该路径访问权限。如果新路径不在默认允许范围内（如 /var/www），必须显式声明 <directory></directory> 块，并包含 Require all granted（Apache 2.4+）或 Allow from all（2.2）。漏掉这步，无论路径多正确都会返回 403。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
示例片段（必须成对出现）：
DocumentRoot "/srv/example-site"
<directory>
Require all granted
AllowOverride All
</directory>
注意：AllowOverride All 若不需要 .htaccess 功能，建议设为 None 提升性能与安全性。
符号链接目标目录需开启 FollowSymLinks
若新 DocumentRoot 是个符号链接（如 /var/www -> /mnt/nas/webroot），Apache 默认拒绝跟随，报 403。必须在对应 <directory></directory> 块中显式启用：
- 添加
Options FollowSymLinks（或Options +FollowSymLinks） - 确保链接目标目录本身也受
<directory></directory>控制，且权限/SELinux 正确 - 避免循环链接，
apachectl configtest无法检测，但会导致 500 错误
迁移本质不是改一个路径，而是让 Apache 进程能“抵达、进入、读取”那个路径——每层目录的权限、每个配置块的作用域、每种安全机制的放行条件，缺一不可。
