Apache启用`mod_dir`模块默认首页索引功能排查-Apache-PHP中文网

问题通常不在模块是否加载，而在于mod_dir能否在请求路径上正确触发、找到文件并获得执行权限；需检查directoryindex作用域、文件名大小写、读取权限及selinux上下文等环节。

apache 启用 mod_dir 后默认首页仍不显示，问题通常不在模块是否“加载”，而在于它能否在请求路径上正确触发、找到文件、并获得执行权限。关键不是“有没有 mod_dir”，而是“它在哪儿生效、找什么、能不能读到”。

mod_dir 是 Apache 的基础模块（Base 状态），2.4+ 版本默认编译进核心，一般无需手动加载。但以下情况会导致它失效：

配置中存在 DirectoryCheckHandler On，且该目录已被其他 handler（如 SetHandler application/x-httpd-php）接管——此时 mod_dir 主动退让，跳过默认索引逻辑
URL 请求末尾没有斜杠（例如访问 /blog 而非 /blog/），且 DirectorySlash Off 被设为关闭，导致不触发重定向也不查 DirectoryIndex
使用了 Alias 或 Redirect 指令，使请求实际未落入目标 <directory></directory> 块作用域内

DirectoryIndex 只在它所在的配置块覆盖的路径下起作用。常见错位包括：

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

在主配置顶层写了 DirectoryIndex index.php，但虚拟主机里又定义了 <virtualhost></virtualhost>，而该 <virtualhost></virtualhost> 内没配 <directory></directory> 块或未显式继承/重写 DirectoryIndex
想对子目录 /api/ 单独设首页，却只在根 <directory></directory> 中配置，未新增 <directory></directory> 块
依赖 .htaccess，但对应目录的 AllowOverride 未包含 Indexes（如只设了 AllowOverride AuthConfig），导致 .htaccess 中的 DirectoryIndex 被忽略

即使配置全对，mod_dir 也只会按顺序尝试访问每个候选文件。任一环节中断即失败：

文件名大小写不符：Linux 下 Index.html ≠ index.html，配置写 DirectoryIndex index.html 但实际只有 Index.html，就会跳过
文件存在但无读权限：Apache 进程用户（www-data 或 apache）对文件缺少 r 权限，或对父目录缺少 x 权限（无法进入目录）
SELinux 或 AppArmor 拦截：RHEL/CentOS 上 ls -Z /path/to/index.html 显示上下文不是 httpd_sys_content_t，需用 chcon 修正
PHP 文件未解析：配置了 DirectoryIndex index.php，但 libphp.so 未加载或 AddType application/x-httpd-php .php 缺失，结果返回 PHP 源码或 500 错误，而非渲染后页面

用最简方式验证核心逻辑是否通：

临时停用所有其他模块：a2dismod php8.3 autoindex rewrite（Debian）或注释掉 LoadModule 行（RHEL），仅留 mod_dir 和基础模块

在站点配置中明确写：

<directory><br>  Options -Indexes<br>  DirectoryIndex index.html<br>  Require all granted<br></directory>

确保 /var/www/html/index.html 存在、644 权限、属主正确，然后访问 http://localhost/（注意结尾斜杠）
若此时仍失败，直接查 error_log —— 日志里会明确写 “File does not exist”、“Permission denied” 或 “AH00127: Cannot find a directory index file”