Apache2.4 FallbackResource配置问题：不存在的PHP文件返回404

阿华AIGC实验室

2026-5-28

解决Apache下不存在的.php文件不触发FallbackResource的问题

这个问题的核心原因是Apache的PHP模块（libapache2-mod-php）会优先处理.php后缀的请求：当你请求一个不存在的.php文件时，PHP模块会直接检测到文件不存在并返回404响应，完全跳过了FallbackResource的规则——因为模块级别的请求处理优先级高于FallbackResource这类通用路由规则。

下面给你两种可行的解决方案，根据你的需求选择：

方案一：用mod_rewrite替代FallbackResource（推荐）

mod_rewrite的规则优先级更高，可以覆盖PHP模块的默认行为，确保所有不存在的请求（无论后缀）都转发到start.php处理。

操作步骤：

启用mod_rewrite模块：
```
sudo a2enmod rewrite
```

修改你的/etc/apache2/sites-available/000-default.conf配置，把原有的FallbackResource替换为rewrite规则：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /code/wwwroot

    <Directory /code/wwwroot>
        Options Indexes FollowSymLinks
        AllowOverride None
        RewriteEngine On
        # 检查请求的文件/目录是否存在，不存在则转发到start.php
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule ^(.*)$ /start.php [L]
    </Directory>

    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

重启Apache生效：
```
sudo systemctl restart apache2
```

这个方案的优势是：内部跳转不会改变URL，且start.php可以自由控制返回的HTTP状态码（比如200或404）。

方案二：用ErrorDocument统一处理404

如果你希望Apache返回标准的404状态码，但内容由start.php生成，可以配置ErrorDocument：

在你的VirtualHost配置中添加一行：

ErrorDocument 404 /start.php

修改后的完整配置：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /code/wwwroot
    ErrorDocument 404 /start.php

    <Directory /code/wwwroot>
        Options Indexes FollowSymLinks
        AllowOverride None
        FallbackResource /start.php
    </Directory>

    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

注意：这种方式下，Apache会先返回404状态码，再调用start.php输出内容，适合需要保留404状态码的场景。