如何在不删除Firebase站点的前提下将PWA站点设为离线状态
Firebase 站点临时离线(保留全量存量配置)实现方案
方案1:路由层全局重定向拦截
这个方案不会修改任何已部署的静态资源、PWA配置、云服务规则、历史部署记录,仅通过调整Hosting的路由规则实现全站点对外不可见:
- 拉取项目对应的
firebase.json配置文件,不下载已部署的静态资源目录内容 - 在
hosting配置块下,临时覆盖原有路由规则:把所有路径的请求统一返回503状态码,重定向到你历史部署版本中留存的极简离线提示页offline.html - 执行
firebase deploy --only hosting:config命令,仅推送路由配置的变更,不会覆盖已存储的站点内容 - 需要恢复站点公开访问时,把
firebase.json里的路由规则还原为原有配置重新部署即可,全程无内容丢失风险
方案2:CDN层访问权限校验拦截
这个方案完全不需要改动代码、配置文件或部署内容,纯控制台操作实现离线效果:
- 进入Firebase Hosting的域名访问设置页,对关联的
web.app默认域名、自定义域名开启“仅项目成员可访问”的拦截开关 - 所有外部匿名用户的请求会被直接拦截在CDN边缘节点,无法触达实际部署的PWA应用内容
- 恢复公开访问时,直接关闭拦截开关即可,无任何配置回滚成本
操作注意事项
- 全程避免执行清空托管存储、删除历史部署版本、解绑域名关联这类操作,这类动作才会破坏你的存量配置和内容
- 考虑到PWA会在用户本地留存Service Worker缓存,临时离线时要在重定向的离线提示页中加入简单的主动注销Service Worker逻辑,避免用户端本地缓存的旧站点内容绕过服务端拦截直接展示
- 不要通过删除Hosting默认站点的方式实现拦截,这类操作会触发域名关联解绑,恢复时需要重新完成域名所有权校验,增加不必要的操作成本
内容的提问来源于stack exchange,提问作者asv
相关产品推荐
相关产品推荐

