必须用errordocument 404 /404.html配置路径（以/开头、相对documentroot），并确保返回真实404状态码——纯html默认返回200，需改用php脚本调用http_response_code(404)或禁用apache多语言错误页模块，同时文件体积≥512字节。
直接用 ErrorDocument 404 /404.html 就能启用自定义 404 页面，但想真正“友好”，得兼顾状态码正确、路径可靠、页面可用这三点。纯静态 HTML 默认返回 200 状态码，搜索引擎和前端逻辑会误判——这不是界面美观问题，而是基础通信错误。
路径必须以斜杠开头，且相对于 DocumentRoot
Apache 要求路径是网站根目录（DocumentRoot）下的相对路径，不是文件系统绝对路径，也不是 URL。
- ✅ 正确写法：
ErrorDocument 404 /404.html→ 对应/var/www/html/404.html（Linux）或C:/xampp/htdocs/404.html（Windows） - ❌ 常见错误：
ErrorDocument 404 /var/www/html/404.html（被当重定向 URL 处理，易循环） - ❌ 常见错误：
ErrorDocument 404 404.html（漏掉开头/，Apache 当作相对 URI，多数情况失效）
确保返回真正的 404 状态码
Apache 默认把自定义错误页当普通响应发出去，状态码仍是 200。用户看到“页面不存在”文字，但 HTTP 响应头却是 200 OK，这对 SEO 和前端判断是致命误导。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 推荐做法：用 PHP 脚本代替纯 HTML，例如
/404.php，开头加<?php http_response_code(404); ?> - 配置同步改为：
ErrorDocument 404 /404.php - 不建议用外部 URL（如
http://yoursite.com/404.html），它会触发 302 重定向，状态码变成 200，还暴露服务器结构
注意 XAMPP/phpEnv 等集成环境的特殊限制
这类环境默认启用了多语言错误页模块（httpd-multilang-errordoc.conf），它会预先定义所有错误页，把你写的 ErrorDocument 覆盖掉。
- 解决方法一：在
httpd.conf中找到Include conf/extra/httpd-multilang-errordoc.conf这一行，在它之后再写你的ErrorDocument - 解决方法二：直接注释掉那行
Include（加#开头），彻底禁用多语言页 - 额外要求：404 文件体积必须 ≥512 字节，否则 Apache 会静默忽略你的配置（IE 兼容性遗留规则，XAMPP 仍沿用）
验证是否真正生效
别只看页面显示内容，重点检查 HTTP 状态码是否为 404。
- 浏览器开发者工具 → Network 标签 → 访问一个不存在的路径（如
/nonexistent）→ 查看响应头中Status是否为404 Not Found - 命令行快速验证：
curl -I http://localhost/nonexistent，第一行应输出HTTP/1.1 404 Not Found - 如果返回
200 OK，说明状态码没设对；如果返回默认 Apache 错误页，说明路径不对或文件不存在/无读取权限
