如何在Apache2中实现本地资源优先、404时反向代理的配置？

先启用必要模块 #

Apache需要以下模块支持该功能，以Debian/Ubuntu系统为例，执行命令启用：

a2enmod rewrite proxy proxy_http proxy_html
systemctl restart apache2

完整VirtualHost配置 #

将以下内容写入站点配置文件（如/etc/apache2/sites-available/your-site.conf），根据实际路径和PHP环境调整：

<VirtualHost *:80>
    ServerName your-domain.com
    DocumentRoot /var/www/html_apache

    # PHP处理配置（以php-fpm为例，若用mod_php可替换为对应配置）
    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php8.2-fpm.sock|fcgi://localhost/"
    </FilesMatch>

    RewriteEngine On

    # 优先处理本地存在的文件/目录，直接返回并终止后续规则
    RewriteCond %{REQUEST_FILENAME} -f [OR]
    RewriteCond %{REQUEST_FILENAME} -d
    RewriteRule ^ - [L]

    # 本地资源不存在时，反向代理到后端服务
    RewriteRule ^(.*)$ http://localhost:8080/$1 [P,L]
    ProxyPassReverse / http://localhost:8080/

    # 拦截后端返回的404，使用本地错误页
    ProxyErrorOverride On
    ErrorDocument 404 /404.html

    # 保留原始请求的主机头给后端服务
    ProxyPreserveHost On
</VirtualHost>

你之前的配置失败原因 #

1. 第一个配置：RewriteCond手动拼接了DocumentRoot路径，%{REQUEST_FILENAME}本身已包含完整本地路径，重复拼接导致PHP文件存在性判断错误，无法处理PHP脚本。
2. 第二个配置：路径范围限制为/[a-z]+/，无法覆盖全局请求，且ProxyPassReverse未指定完整后端地址，用法不规范。
3. 第三个配置：同时使用RewriteRule [P]和ProxyPass指令，Apache优先执行ProxyPass，重写规则被忽略，无法实现本地优先逻辑。
4. 第四个配置：仅检查文件是否存在（!-f），未考虑目录情况，同样存在ProxyPass与重写规则冲突的问题。

补充注意事项 #

• 确保DocumentRoot目录（如/var/www/html_apache）权限正确，Apache运行用户（通常为www-data）拥有读取权限。
• 若后端需要客户端真实IP，可添加RequestHeader set X-Forwarded-For %{REMOTE_ADDR}e。
• 修改配置后执行apache2ctl configtest检查语法，重启Apache生效。

内容的提问来源于stack exchange，提问作者user3476571