servername 决定虚拟主机匹配，errordocument 必须置于匹配成功的 virtualhost 块内才生效；错误页路径相对于该主机 documentroot，且需满足文件存在、权限正确、大小超256字节等条件。
ServerName 本身不直接参与错误页面配置，但它决定了虚拟主机的匹配逻辑——只有请求 Host 头与 ServerName 或 ServerAlias 完全匹配，该虚拟主机才会被选中；而 ErrorDocument 指令必须写在这个匹配成功的虚拟主机块内（或全局配置中），错误页面才对这个站点生效。
ServerName 必须先配对、再挂错误页
错误页面不是靠 ServerName “触发”的，而是靠它把请求正确路由到对应虚拟主机后，该主机内部的 ErrorDocument 设置才起作用。如果 ServerName 写错、缺失或未匹配，请求可能落到默认虚拟主机甚至报错，你写的自定义 404 就不会显示。
- 确保每个
<virtualhost></virtualhost>块里都有且仅有一个合法 ServerName（如example.com） - 把
ErrorDocument指令放在同一个<virtualhost></virtualhost>块内，而不是丢在 httpd.conf 顶部或别的地方 - 开发时用 localhost 或 IP 访问，ServerName 必须带端口（如
localhost:8080），否则 Host 头不匹配，错误页不生效
错误页面路径要和 ServerName 所属站点一致
Apache 查找错误页面时，路径是相对于该虚拟主机的 DocumentRoot 的。ServerName 确定了哪个 DocumentRoot 被启用，也就限定了错误页的根路径范围。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 假设
DocumentRoot "/var/www/example"，那么ErrorDocument 404 /errors/404.html实际查找的是/var/www/example/errors/404.html - 不能写成
ErrorDocument 404 /var/www/other/errors/404.html—— 这是绝对路径，Apache 不允许跨 DocumentRoot 访问 - 如果用 .htaccess 设置，路径同样以当前目录为基准，需确保该文件位于 DocumentRoot 或其子目录下
常见搭配失效原因
明明写了 ServerName 和 ErrorDocument，但还是显示默认错误页？多半是下面这几个环节断了链：
-
ServerName 格式错误：写了多个域名、加了引号、含协议（
http://）或端口（非开发场景下一般不写端口）、用了通配符——这些都会导致 Apache 启动失败或匹配跳过 -
监听与 VirtualHost 不匹配：比如
Listen 8080，但<virtualhost></virtualhost>—— 端口对不上，整个块被忽略，ErrorDocument 自然无效 - 错误页文件太小：Apache 要求自定义 HTML 错误页至少 256 字节，否则某些浏览器会屏蔽显示（可加几行注释或空格凑够）
- 权限或路径不存在：检查文件是否存在、是否可被 Apache 用户（如 www-data）读取，路径拼写是否大小写一致（Linux 区分大小写）
一个能跑通的最小示例
以本地开发为例（XAMPP / Linux + Apache 2.4）：
<virtualhost>
ServerName localhost:8080
DocumentRoot "/var/www/myapp"
<directory>
Require all granted
</directory>
ErrorDocument 404 /errors/404.html
ErrorDocument 500 /errors/500.html
</virtualhost>
同时确保：
– /var/www/myapp/errors/404.html 存在且内容超过 256 字节
– Apache 已加载 httpd-vhosts.conf，且 Listen 8080 已启用
– 浏览器访问 http://localhost:8080/xxx（一个不存在的路径）
