DocumentRoot 与代理配置可共存但职责分明：DocumentRoot 处理未被 ProxyPass 捕获的请求，ProxyPass 优先匹配并转发，二者按顺序生效而非叠加；需启用代理模块、路径统一结尾斜杠、避免路径冲突，并注意 HTTPS 下 Header 传递。
Apache 的 DocumentRoot 和代理配置（如反向代理）属于两种不同用途的机制，不能混用，但可以共存于同一服务器——关键在于明确分工：DocumentRoot 管本地静态/PHP 文件服务，代理配置管外部或后端服务转发。配错会导致 PHP 不执行、路径 404、或代理失效。
DocumentRoot 不参与代理逻辑
DocumentRoot 只对当前 <VirtualHost> 中未被代理规则捕获的请求生效。一旦某路径匹配了 ProxyPass，Apache 就不再检查 DocumentRoot 下的文件，而是直接转发请求。
比如：
<VirtualHost *:80>
ServerName app.example.com
DocumentRoot "/var/www/app/public"
# 这条规则优先匹配 /api/ 开头的请求 → 转发，不走 DocumentRoot
ProxyPass /api/ http://127.0.0.1:3000/
ProxyPassReverse /api/ http://127.0.0.1:3000/
# 其他请求（如 /、/assets/logo.png、/index.php）才由 DocumentRoot 处理
</VirtualHost>✅ 正确理解：
DocumentRoot是“兜底路径”，代理是“主动拦截”。二者按匹配顺序生效，不是叠加关系。
代理与 DocumentRoot 共存时的常见配置要点
-
确保代理模块已启用
检查httpd.conf或apache2.conf中以下行已取消注释：LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so
-
ProxyPass 路径必须以
/结尾（或保持前后一致）
错误写法（易导致路径拼接错误）：ProxyPass /api http://backend:8000/api # 缺少结尾斜杠
正确写法：
ProxyPass /api/ http://backend:8000/api/ ProxyPassReverse /api/ http://backend:8000/api/
-
DocumentRoot 目录仍需常规 PHP 支持（如果要运行本地 PHP）
即使用了代理，只要还有.php文件需 Apache 自己解析（比如首页index.php），就得保证：-
LoadModule php_module已加载 -
AddType application/x-httpd-php .php已设置 - 对应
<Directory>块含Require all granted和AllowOverride All
-
-
避免 DocumentRoot 与代理路径冲突
比如DocumentRoot "/var/www/app"且配置了ProxyPass /app/ ...，但同时又放了/var/www/app/app/目录——Apache 可能先尝试读取本地文件，再 fallback 到代理，造成行为不可预期。建议：- 代理路径尽量用语义前缀（如
/api/,/auth/,/admin/） -
DocumentRoot下只放前端入口、静态资源、PHP 入口脚本（如index.php）
- 代理路径尽量用语义前缀（如
实际场景示例：单域名，前后端分离部署
假设你有一个 Vue 前端放在 /var/www/client/，后端 API 在 http://localhost:8080：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<VirtualHost *:80>
ServerName myapp.local
DocumentRoot "/var/www/client" # 前端静态文件根目录
# 所有 /api/ 请求转给后端
ProxyPass /api/ http://localhost:8080/api/
ProxyPassReverse /api/ http://localhost:8080/api/
# 可选：SPA 路由 fallback（前端路由）
<Directory "/var/www/client">
Require all granted
AllowOverride All
# .htaccess 中加 RewriteRule ^(.*)$ /index.html [L]
</Directory>
</VirtualHost>此时：
- 访问
myapp.local/→ 读取/var/www/client/index.html - 访问
myapp.local/api/users→ 转发到http://localhost:8080/api/users -
DocumentRoot不影响代理，代理也不覆盖DocumentRoot权限配置
特别注意 HTTPS + 代理时的 Header 传递
若后端需要真实客户端 IP 或 Host，记得加：
ProxyPreserveHost On RequestHeader set X-Forwarded-Proto "https" RequestHeader set X-Forwarded-Port "443"
否则后端可能拿不到原始协议或域名，尤其影响 Laravel、Symfony 等框架的 URL 生成。
不复杂但容易忽略。
