如何在httpd/apache代理场景下将上游CDN的404改写为200并返回index.html

该需求完全可以实现，通过Apache内置模块组合配置即可完成，无需修改上游存储桶、CDN逻辑，也符合零 downtime 要求，具体操作步骤如下：

步骤1：启用必要Apache模块 #

执行以下命令开启所需模块：

# Debian/Ubuntu 系统
a2enmod proxy proxy_http headers rewrite
# 配置校验后重载服务
apachectl configtest && systemctl reload apache2

# CentOS/RHEL 系统
httpd -M | grep -E 'proxy|proxy_http|headers|rewrite' # 检查是否已启用，未启用则修改配置文件加载对应模块
httpd -t && systemctl reload httpd

步骤2：修改虚拟主机配置 #

在你的站点虚拟主机配置中添加如下内容，需根据实际场景替换CDN地址、站点域名：

<VirtualHost *:443>
    ServerName www.mysite.com
    # 此处补充你的SSL证书相关配置
    
    # 代理规则：将/app路径下所有请求转发到Cloud CDN
    ProxyPass /app/ https://替换为你的Cloud CDN域名/
    ProxyPassReverse /app/ https://替换为你的Cloud CDN域名/
    # 开启代理错误覆写，允许Apache接管上游返回的错误
    ProxyErrorOverride On

    # 指定404错误的响应内容为首页，内部跳转无3xx重定向
    ErrorDocument 404 /app/index.html

    # 核心配置：将原404响应的状态码修改为200
    Header always set Status "200 OK" "expr=%{REQUEST_STATUS} == 404"

    # 可选优化：仅页面路由404转200，静态资源异常保留404状态码
    <IfModule mod_rewrite.c>
        RewriteEngine On
        # 匹配所有静态资源后缀
        RewriteCond %{REQUEST_URI} \.(js|css|png|jpg|jpeg|gif|svg|ico|woff|woff2|ttf|eot)$ [NC]
        RewriteRule .* - [E=KEEP_404:1]
        # 静态资源404时恢复原状态码
        Header always set Status "404 Not Found" "expr=%{ENV:KEEP_404} == 1 && %{REQUEST_STATUS} == 404"
    </IfModule>
</VirtualHost>

如果你的站点使用HTTP协议，仅需将配置放到80端口的虚拟主机段即可，核心逻辑无需修改。

步骤3：配置生效与验证 #

• 执行配置校验命令确认语法正确：apachectl configtest（CentOS/RHEL用httpd -t）
• 重载Apache服务使配置生效：systemctl reload apache2（CentOS/RHEL用systemctl reload httpd）
• 验证效果：访问www.mysite.com/app/任意不存在的路径，可看到响应状态码为200，返回内容为index.html内容；访问存在的静态资源、页面路由均正常返回。

该架构下代码更新仅需上传文件到Google Storage Bucket后刷新CDN缓存即可，无需重启Apache或容器，完全满足零停机要求。

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