Apache 中 DirectoryIndex 指令指定的文件不存在时如何返回自定义 404

可以，DirectoryIndex失效触发的404是标准HTTP 404，受ErrorDocument 404控制；需确保指令存在且路径正确、Options -Indexes禁用目录索引、AllowOverride All允许.htaccess生效。

当 Apache 的 DirectoryIndex 指令指定的默认文件（如 index.html、index.php）在目录中全部不存在时，Apache 默认会列出该目录下的文件（如果 Options +Indexes 启用），或直接返回 404 Not Found（如果 Options -Indexes 且无匹配索引文件）。但关键点在于：这个 404 是否能走你配置的自定义错误页？

答案是：可以，但前提是你的 ErrorDocument 404 配置已生效，且触发的是真正的 HTTP 404 状态。

下面分情况说明和操作要点：

DirectoryIndex 失效触发的 404 是标准 404，支持自定义页面

Apache 在请求一个目录（如 /blog/）时，会按 DirectoryIndex 列表顺序查找文件（例如 DirectoryIndex index.html index.php）。

若所有指定文件都不存在，且目录不允许索引（即 Options -Indexes），Apache 就会返回状态码 404 Not Found —— 这和访问 /nonexistent.html 的 404 是同一类错误，完全受 ErrorDocument 404 控制。

✅ 正确配置后，用户访问 /blog/（而该目录下既无 index.html 也无 index.php）就会显示你的 /errors/404.html。

确保自定义 404 生效的三个必要条件

1. ErrorDocument 404 指令必须存在且路径正确

   例如：

   ErrorDocument 404 /errors/404.html

   路径 /errors/404.html 必须相对于 根目录（DocumentRoot），且该 HTML 文件真实存在、可被 Apache 读取。

2. 目录不允许自动索引（禁用 Indexes）

   在 <Directory> 或 .htaccess 中确保：

   Options -Indexes

   否则 Apache 会显示目录列表（状态码 200），根本不会触发 404。

3. .htaccess 或主配置允许覆盖（仅限 .htaccess 方式）

   若通过 .htaccess 设置 ErrorDocument，需确认对应 <Directory> 块中已启用：

   AllowOverride All

   否则指令会被忽略。

常见陷阱：为什么有时不跳转到自定义 404？

1. 自定义页面路径写错（如 /404.html 实际放在 /public/404.html，但配置写成 /404.html）
2. 页面返回了 200 状态码（检查你的 404.html 是否含 <?php http_response_code(404); ?> 或类似逻辑 —— 不需要，Apache 自动设状态码，加反而可能出错）
3. AllowOverride None 导致 .htaccess 中的 ErrorDocument 未生效
4. Options +Indexes 开启，目录被列出来（此时状态是 200，不是 404）

验证是否真正返回 404 状态码

用 curl 测试：

curl -I http://yoursite.com/empty-directory/

应看到：

HTTP/1.1 404 Not Found

而不是 200 OK 或 302 Found。

如果返回 200，说明 Apache 显示了目录列表；如果返回 302，说明你误用了重定向（比如写了 ErrorDocument 404 http://site.com/404.html，带域名会导致 302）。

不复杂但容易忽略。