SSR 挂了降级 CSR 没生效 502 白屏 5 秒 开关怎么验

SSR 服务发版重启,30 秒内所有请求 502。前端写了降级逻辑,window.onerror 里拉 CSR 空壳,实际一点没生效,用户白屏 5 秒后跳到错误页。

第一反应是降级脚本没打包进去,翻构建产物,代码在。再抓包,502 响应体是 nginx 的错误页,前端 JS 根本没机会执行,onerror 挂在 window 上也没用,页面都没加载完。

试着把 error_page 挂到 server 层,nginx 对 upstream 返回的 502 默认不拦截,要开 proxy_intercept_errors on。加上之后 502 变成了 200 的空壳,但壳里没有数据,页面还是白,只是不报错了。

最后在空壳里放降级页。nginx 返回一个预渲染的静态 HTML,里面带 app.js 和 csr 标记,前端启动读这个标记,跳过 hydration 直接走客户端渲染。同时给 SSR 加健康检查,连续 3 次失败由负载均衡摘掉实例,恢复后自动挂回。

proxy_intercept_errors on;
error_page 502 503 504 =200 /csr-shell.html;
location = /csr-shell.html {
    internal;
}
# 降级后白屏 5 秒 -> 1.2 秒

演练时手动 kill 掉 SSR 进程,用户侧白屏从 5 秒降到 1.2 秒,失败请求比例从 100% 到 0,降级页能正常浏览和加购,只是首屏慢 600ms。

要验证降级真的走了,看两处:nginx 日志里 502 的数量,以及前端上报的 render_mode 是不是 csr。第一次演练只有 40% 的请求降级,查出来是 CDN 缓存了 502 响应 60 秒,在缓存规则里排除 5xx 才恢复。降级开关也别只靠健康检查,加一个配置中心的强制开关,出问题能一键切。

您可以还会对下面的文章感兴趣: