ng deploy部署Firebase后index.html变为index.original.html导致404

核心冲突逻辑 #

问题本质是*@angular/fire的部署逻辑与Angular Universal（SSR/SSG）*构建产物的适配机制出现错配，此前手动部署流程因为不触发该插件的自动重命名逻辑，所以不会出现这类问题，完整的触发链路如下：

• 执行带SSR配置的Angular构建时，项目会在dist目录的静态资源根路径生成可直接被静态服务返回的index.html（通常是预渲染完成的静态页面），同时在独立的server目录生成服务端渲染的运行时代码。
• 调用ng deploy时，Firebase部署插件默认按纯客户端渲染（CSR）项目的逻辑执行操作：为了避免静态托管直接返回硬编码的index.html打断SPA路由兜底规则，插件会把静态根路径下的原index.html重命名为index.original.html。
• 插件未识别到当前项目启用了Angular Universal模式，既没有同步生成对应的SSR云函数部署产物，也没有更新firebase.json的路由重写规则——最终静态资源目录下没有可直接命中的入口文件，所有路由请求在静态匹配阶段找不到对应资源，就会返回404错误。

常见前置触发条件 #

• 在angular.json的deploy配置段，未给*@angular/fire*插件开启SSR模式标识，导致插件全程按CSR项目逻辑处理
• 部署前未执行完整的SSR构建流程，只完成了纯客户端构建，本身就缺失服务端渲染的代码产物
• 手动配置firebase.json时，静态资源目录与SSR重写规则不匹配，导致请求未正确转发到服务端渲染逻辑

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