XAMPP中Apache的404页面不生效，90%是因为ErrorDocument被httpd-multilang-errordoc.conf覆盖、.htaccess未启用（mod_rewrite未加载或AllowOverride为None），或自定义404.html文件大小不足512字节。
直接说结论：XAMPP 中 Apache 的 404 页面不生效，90% 是因为 ErrorDocument 被 httpd-multilang-errordoc.conf 覆盖、.htaccess 未启用，或自定义页面文件大小不足 512 字节。不是配置写错了，而是 Apache 没读到你写的那行。
为什么改了 ErrorDocument 404 /404.html 却没反应
根本原因不是语法错，而是 Apache 配置加载顺序和模块冲突。XAMPP 默认启用了多语言错误文档模块：Include conf/extra/httpd-multilang-errordoc.conf，这个文件里已经定义了 ErrorDocument 404，会覆盖你在 httpd.conf 顶部或虚拟主机里写的同名指令。
- 打开
C:/xampp/apache/conf/extra/httpd-multilang-errordoc.conf，你会看到类似ErrorDocument 404 /error/HTTP_NOT_FOUND.html.var的行 —— 这才是实际生效的配置 - 如果你在
httpd.conf里取消注释#ErrorDocument 404 /404.html，但没把它放在Include行之后，它会被后加载的httpd-multilang-errordoc.conf覆盖 - 用浏览器开发者工具的 Network 面板看响应状态码：如果返回的是 200 而不是 404，说明你用了绝对 URL（如
ErrorDocument 404 http://localhost/404.html），这会让 Apache 当作重定向处理，彻底丢失 404 状态
.htaccess 方式为何有时失效
这个方法灵活，但依赖两个前提：mod_rewrite 模块已启用，且对应目录的 AllowOverride 设置为 All。XAMPP 默认是 None，所以即使你放了 .htaccess，Apache 也直接忽略它。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 检查
httpd.conf中是否已取消注释：LoadModule rewrite_module modules/mod_rewrite.so - 找到你的项目所在目录的
<Directory>块（比如<Directory "C:/xampp/htdocs/myproject">），确认里面有AllowOverride All（不是None）和Require all granted -
.htaccess必须放在请求路径所对应的物理目录下；若访问http://localhost/blog/post/123，而 404 发生在post/123，那么.htaccess要放在htdocs/blog/目录，且内容写成ErrorDocument 404 /blog/404.html（路径以 DocumentRoot 为根）
404 页面本身必须满足的硬性条件
哪怕配置全对，页面仍不显示，大概率卡在文件细节上。这不是兼容性问题，是 Apache 内置的强制策略。
-
404.html文件大小必须 ≥ 512 字节 —— IE 和 Edge 会直接屏蔽小于该尺寸的自定义页，返回默认错误；用echo "A".str_repeat("x", 512) > 404.html快速达标 - 文件路径必须能被 Apache 读取：确保它放在
DocumentRoot下（比如C:/xampp/htdocs/404.html），且无中文、空格、特殊符号路径 - 不要用 PHP 动态生成 404 页面并期望它自动返回 404 状态码 ——
ErrorDocument只负责跳转，PHP 脚本内部仍需手动输出http_response_code(404)，否则搜索引擎看到的是 200
多项目共存时如何隔离 404 页面
在 htdocs 下有多个子项目（如 /shop、/api）时，不能只靠一个全局 404.html。每个项目需要独立控制，.htaccess 是唯一安全方案。
- 在
htdocs/shop/.htaccess中写：ErrorDocument 404 /shop/404.html；在htdocs/api/.htaccess中写：ErrorDocument 404 /api/404.html - 对应页面分别放在
htdocs/shop/404.html和htdocs/api/404.html，各自可不同风格、不同逻辑 - 切记：每个子目录的
<Directory>块都必须单独配置AllowOverride All，不能只改根目录的 - 重启 Apache 后，用 curl 测试真实行为：
curl -I http://localhost/shop/nonexistent，确认响应头含HTTP/1.1 404 Not Found和Content-Type: text/html
最容易被忽略的一点：所有修改（无论是 httpd.conf、httpd-vhosts.conf 还是 .htaccess）之后，必须通过 XAMPP Control Panel 完整停止再启动 Apache —— “Restart” 按钮有时只重载部分配置，旧规则仍在内存中残留。
