Apache多端口下ErrorDocument不生效的典型表现是：仅在httpd.conf全局配置中设置ErrorDocument 404 /404.html，但访问Listen新增端口（如8081、8082）时仍显示默认错误页；根本原因是ErrorDocument指令不具备跨VirtualHost继承性，必须在每个块内显式声明，且路径须相对于该主机的DocumentRoot。
Apache多端口下ErrorDocument不生效的典型表现
你在 httpd.conf 里加了 ErrorDocument 404 /404.html，又用 Listen 8081 和 Listen 8082 开了两个端口，结果访问 http://localhost:8081/xxx 还是默认 Apache 错误页——不是配置没加载，而是 ErrorDocument 指令作用域没覆盖到新端口对应的虚拟主机。
必须在块内重复声明ErrorDocument
Apache 的 ErrorDocument 是**上下文敏感指令**：全局配置里的设置不会自动继承到每个 <virtualhost></virtualhost>，尤其当端口不同、DocumentRoot 不同时，必须显式为每个端口配一套。
- 只在主配置里写一次
ErrorDocument 404 /404.html，对<virtualhost></virtualhost>无效 - 每个
<virtualhost></virtualhost>块里都要单独写，路径需相对于该VirtualHost的DocumentRoot - 如果两个端口指向不同目录（比如
/xampp/htdocs/siteA和/xampp/htdocs/siteB），那/404.html实际路径也不同，不能共用一个文件
示例：
<VirtualHost *:8081>
DocumentRoot "/xampp/htdocs/siteA"
ErrorDocument 404 /404-siteA.html
</VirtualHost>
<VirtualHost *:8082>
DocumentRoot "/xampp/htdocs/siteB"
ErrorDocument 404 /404-siteB.html
</VirtualHost>
路径写法错误：/开头 vs 无斜杠 vs 协议绝对路径
ErrorDocument 后面的路径解析规则容易被忽略：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
ErrorDocument 404 /404.html→ 解析为服务器根路径（即DocumentRoot下）的/404.html，文件必须放在对应DocumentRoot目录里 -
ErrorDocument 404 404.html（无斜杠）→ 视为相对当前请求 URL 路径，极易 404 套娃，不推荐 -
ErrorDocument 404 http://localhost:8081/404.html→ 会触发 302 重定向，暴露端口且可能跨域失败，生产环境禁用
验证方法：把自定义 HTML 文件放进对应 DocumentRoot，用浏览器直接访问 http://localhost:8081/404.html 确保能打开，再测 404 触发。
重启后仍不生效？检查AllowOverride和.htaccess干扰
如果你在某个项目目录下还放了 .htaccess，它可能覆盖掉 <virtualhost></virtualhost> 里的 ErrorDocument 设置——前提是 AllowOverride 没被设成 None。
- 确认对应
<directory></directory>块中AllowOverride至少包含FileInfo（或直接设为all） - 临时重命名项目下的
.htaccess，看ErrorDocument是否恢复生效 - XAMPP 默认的
httpd.conf中，<directory></directory>块里常设AllowOverride All，但自定义VirtualHost的DocumentRoot对应的<directory></directory>块可能没同步更新
真正麻烦的点在于：端口、虚拟主机、目录权限、.htaccess 四层嵌套，任一环节断链都会让错误页“静默失效”。调试时建议先删光所有 .htaccess，只留 <virtualhost></virtualhost> + 显式 ErrorDocument，跑通后再逐层加回。
