Firebase Hosting结合CLI与REST API的版本维护及用户自定义文件部署问题

问题1解答 #

普通登录用户无法直接获取Hosting API的访问令牌，该令牌属于项目级高权限凭证，直接下发给普通用户会导致整个站点内容被篡改的风险。
推荐的实现方式是走后端代理流程：用户上传压缩包后，先提交到你的后端服务，后端完成用户身份校验、文件合法性扫描之后，使用项目服务账号的权限调用Hosting API完成部署，全程不需要向用户暴露任何Hosting相关的权限凭证。

问题2解答 #

有两种常用实现方案：

• 自行维护文件元数据库：每次部署（不管是CLI更新还是用户上传）都将所有文件的路径、哈希值、所属用户、更新时间等信息同步存储到数据库中，需要调用部署API时直接从数据库拉取全量文件列表即可，这种方案性能最好，也方便做业务层面的文件管理。
• 调用Hosting API拉取当前生效版本的文件列表：通过API获取站点当前活跃的部署版本信息，版本详情中会返回所有已存在文件的路径和对应哈希值，提取这部分数据即可得到完整的已有文件列表。

问题3解答 #

默认的CLI部署逻辑是全量覆盖，会删除线上存在但本地部署目录不存在的所有文件，要实现合并更新可以用以下方案：

• 执行CLI部署命令时添加--merge参数，完整命令为firebase deploy --only hosting:merge，加了这个参数后CLI会自动将本地要部署的文件和线上已有的文件做合并，不会删除线上存在但本地没有的文件，完全可以满足不覆盖用户上传内容的需求。
• 也可以自行实现合并逻辑：每次部署前先拉取全量文件列表，过滤保留所有用户上传的文件记录，再叠加本次要更新的官方应用文件，生成新的部署列表后再调用API或者CLI执行部署，这种方式可控性更高。
  另外建议将所有用户上传的内容统一放在固定路径前缀下（比如/user-content/），既可以避免用户上传路径和官方应用路径冲突，也方便后续做权限控制和批量管理。

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