DirectoryIndex 指令必须写在影响目标目录的配置作用域内，如块或允许AllowOverride Indexes的.htaccess文件中；多个值空格分隔、大小写敏感，修改后需重载配置才生效。

DirectoryIndex 指令写在哪？位置不对就完全不生效

Apache 的 DirectoryIndex 指令必须出现在能影响目标目录的配置作用域里，不是写哪儿都管用。常见错误是只在主配置文件 httpd.conf 顶层写了一次，但虚拟主机或子目录有更细粒度的配置覆盖了它。

• 如果你配的是某个站点，默认首页行为由对应 块里的配置决定，优先级高于全局
• 在网站根目录下放 .htaccess 文件也能生效，但前提是该目录的 AllowOverride 包含 Indexes（或设为 All），否则 Apache 直接忽略
• 多个 DirectoryIndex 指令可以共存，后出现的会追加到列表末尾（不是覆盖），所以要注意加载顺序

多个文件名怎么写？空格分隔，但不能有引号

DirectoryIndex 后面跟的是空格分隔的文件名列表，Apache 从左到右依次查找，找到第一个存在的就返回。别加引号，也别用逗号或换行。

• 正确：DirectoryIndex index.html index.php default.htm
• 错误：DirectoryIndex "index.html" "index.php"（引号会被当字面量处理，导致找不到文件）
• 错误：DirectoryIndex index.html, index.php（逗号变成文件名一部分，实际去查 index.html, 这个带逗号的文件）

注意：如果列表里写了不存在的文件（比如 index.xhtml），Apache 会继续往后找；但如果所有都不存在，且没开 Options +Indexes，就会返回 403 Forbidden。

为什么改了不生效？检查三个关键点

改完配置不生效，大概率卡在这三处：

• 配置文件没重载：sudo apachectl graceful 或 sudo systemctl reload apache2（Linux）必须执行，改完不 reload 等于没改
• 文件权限或 SELinux 限制：确保 Apache 进程对指定首页文件有读取权限，尤其在 CentOS/RHEL 上 SELinux 可能拦截访问，可用 ls -Z index.html 查上下文
• 路径匹配错误：如果你在 块里写 DirectoryIndex，它只对这个路径生效；而请求 URL 是 /blog/，就得在对应 里单独配

和 PHP 的 auto_prepend_file 冲突吗？不冲突，但逻辑不同

DirectoryIndex 纯属静态文件路由层的事，它决定“哪个文件被当作入口加载”。而 auto_prepend_file 是 PHP 解析器层面的机制，发生在文件内容真正执行前。

• 如果 DirectoryIndex index.php，Apache 找到 index.php 并交给 PHP 模块处理，这时 PHP 才会按自己的配置去执行 auto_prepend_file
• 它们不在同一层，不会互相屏蔽，但要注意：如果 index.php 本身内容为空或 exit，那 auto_prepend_file 虽然执行了，你也看不到效果

文件名大小写敏感、扩展名是否启用 mod_php、甚至 .htaccess 是否被允许——这些细节一旦漏掉一个，DirectoryIndex 就像没写一样。