DocumentRoot 必须与 <Directory> 路径完全一致，包括斜杠方向、末尾无多余斜杠、大小写及特殊字符；需同步修改两者、手动创建目录并放置默认文件、重启 Apache 且排查虚拟主机覆盖。
DocumentRoot 和 路径必须完全一致
改根目录不是只改 DocumentRoot 一行就完事。Apache 启动时会校验 <directory></directory> 块中的路径是否与 DocumentRoot 完全匹配，哪怕多一个空格、斜杠方向不一致（如 D:\myweb vs D:/myweb），都会导致 403 Forbidden 或配置加载失败。
实操建议：
- 统一用正斜杠
/，例如DocumentRoot "D:/myweb"和<directory></directory> - 路径末尾不要加斜杠（
"D:/myweb/"是错的） - 大小写敏感：Windows 下通常不敏感，但若你启用了
FollowSymLinks或挂载了 Linux 子系统卷，可能出问题，保持大小写一致最稳妥 - 路径中不能含中文、空格、括号等特殊字符——哪怕文件夹能创建成功，PHP 加载或 Apache 解析时也容易静默失败
新目录必须手动创建且含可访问文件
Apache 不会帮你建文件夹，也不会提示“目录不存在”。你改完配置重启后访问 http://localhost/，如果看到 404 或空白页，第一反应不该是查配置，而是去资源管理器里确认 D:/myweb 这个路径是否真实存在、是否为空、里面有没有 index.html 或 index.php。
常见错误现象：
- 新建了
D:/myweb，但忘了放任何文件 → 显示 403（因 Apache 默认禁用目录索引） - 放了
test.php，但没放index.*→ 访问http://localhost/仍 404，必须输完整路径http://localhost/test.php才能打开 - 把文件夹建在 OneDrive/iCloud 同步目录下 → PHP 文件偶尔加载失败、
require报错、页面响应延迟，因为同步客户端锁住了文件
改完必须重启 Apache，不能只刷新页面
很多人改完 httpd.conf 保存后直接浏览器按 F5，发现没变化，就开始怀疑路径写错、权限不对、甚至重装 XAMPP。其实 Apache 的配置是进程启动时一次性加载的，运行中修改配置文件不会自动生效。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
正确操作：
- 在 XAMPP Control Panel 中，先点
StopApache，再点Start（不是Restart按钮，它有时不触发完整重载） - 命令行方式（推荐验证用）：
C:\xampp\apache\bin\httpd.exe -t可检查配置语法是否正确；若返回Syntax OK再重启 - 如果 Control Panel 显示 Apache 启动失败，点
Logs → Apache error.log查具体报错，90% 是路径拼写错误或权限拒绝
虚拟主机配置可能覆盖主 DocumentRoot
如果你之前设过 local.dev 或其他域名指向某个项目，很可能在 C:\xampp\apache\conf\extra\httpd-vhosts.conf 里启用了 VirtualHost。此时即使主配置改了 DocumentRoot，http://localhost/ 仍走默认虚拟主机逻辑，而该虚拟主机的 DocumentRoot 可能还指向旧路径。
排查方法：
- 打开
httpd-vhosts.conf，看是否有未注释的<VirtualHost *:80>块 - 检查其中的
DocumentRoot和ServerName localhost是否共存——如果存在，它会接管所有对localhost的请求 - 临时把整个
httpd-vhosts.conf文件重命名为httpd-vhosts.conf.bak，再重启 Apache 测试是否回归主配置行为
真正复杂的地方在于：你可能以为只改了一个地方，其实有两套配置在竞争；而错误日志里不会明说“你被虚拟主机劫持了”，只会报路径找不到或权限不足。动手前先确认自己到底在改哪一层路由逻辑。
