errordocument遵循“就近生效”原则，可在、或.htaccess中配置，但不可用于块；路径必须为以/开头的uri，优先级由高到低为.htaccess > > > 主配置。
在 Apache 的 <virtualhost></virtualhost> 配置中，ErrorDocument 指令不是全局继承后不可变的，而是遵循“就近生效”原则：更具体作用域的配置会覆盖更宽泛作用域的同名指令。也就是说，子目录（<directory></directory>）或路径（<location></location>）块里定义的 ErrorDocument，可以覆盖 <virtualhost></virtualhost> 顶层或主配置中设置的同状态码错误页。
但关键在于：ErrorDocument 本身不支持直接写在 <directory></directory> 块里——这是常见误区。
✅ 正确覆盖方式：用 <location></location> 或 .htaccess（需允许）
Apache 官方文档明确说明：
ErrorDocument是服务器级、虚拟主机级和目录级（仅限.htaccess） 可用的指令，但不能出现在<directory></directory>容器中。
所以真正能“覆盖”的路径级方式只有两种：
1. 在 <location></location> 块中定义（推荐用于 URI 路径）
适用于想为某个 URL 路径（如 /admin/）单独指定错误页：
<virtualhost>
ServerName example.com
DocumentRoot /var/www/example
# 全局 404 页面
ErrorDocument 404 /errors/404-global.html
# 仅为 /admin/ 下的请求启用不同 404
<location>
ErrorDocument 404 /errors/404-admin.html
</location></virtualhost>
✅ 生效逻辑：当请求是 https://example.com/admin/missing 触发 404 时，Apache 会优先使用 <location></location> 内的 ErrorDocument；其他路径仍走全局设定。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
⚠️ 注意：
-
<location></location>匹配的是URL 路径（URI），不是文件系统路径； - 它必须在
<virtualhost></virtualhost>内，不能放在<directory></directory>里； - 不支持嵌套
<location></location>覆盖（Apache 按照匹配顺序取第一个成功项）。
2. 在 .htaccess 文件中定义（需 AllowOverride 开启）
如果目录支持 .htaccess（即对应 <directory></directory> 中设置了 AllowOverride FileInfo 或 All），可在该目录下放 .htaccess：
# /var/www/example/admin/.htaccess ErrorDocument 404 /errors/404-admin.html
✅ 生效逻辑：Apache 在处理请求时，若路径落入该目录且 AllowOverride FileInfo 已启用，就会读取并应用该 .htaccess 中的 ErrorDocument，覆盖上层配置。
⚠️ 注意：
- 主配置中必须有对应
<directory></directory>块，且含AllowOverride FileInfo（或All）； -
.htaccess中的路径是相对于网站根目录的 URI（如/errors/...），不是文件系统路径； - 性能略低（每次请求解析），生产环境建议尽量用
<location></location>或<virtualhost></virtualhost>内置配置。
❌ 常见错误写法（不会生效）
# 错误：ErrorDocument 不允许出现在 <directory> 中
<directory>
ErrorDocument 404 /errors/404-admin.html # ← Apache 启动会报错：Invalid command
Require all granted
</directory></directory>
Apache 会直接拒绝加载配置，报类似错误：Invalid command 'ErrorDocument', perhaps misspelled or defined by a module not included in the server configuration
? 补充：覆盖优先级顺序（从高到低）
| 作用域 | 是否支持 ErrorDocument | 说明 |
|---|---|---|
.htaccess（路径内） |
✅（需 AllowOverride FileInfo） |
最细粒度，但依赖解析开销 |
<location></location> |
✅ | 匹配 URI，推荐用于路径级定制 |
<virtualhost></virtualhost> 顶层 |
✅ | 默认生效范围，常作兜底 |
主配置文件（apache2.conf/httpd.conf） |
✅ | 全局默认，易被下层覆盖 |
⚠️ 所有
ErrorDocument的路径都必须是以/开头的 URI（如/errors/404.html），不能是文件系统路径（如/var/www/...）或外部 URL（除非加default或协议前缀，但行为受限）。
✅ 小结操作要点
- 想按 URL 路径区分错误页 → 用
<location></location>块 - 想按目录物理结构区分，且允许动态覆盖 → 开
AllowOverride FileInfo+.htaccess - 别往
<directory></directory>里写ErrorDocument，Apache 不认 - 所有自定义错误页路径必须是网站可访问的 URI，提前确认该页面真实存在且可被 Apache 读取
不复杂但容易忽略细节。
