Angular 4+ Firebase VSO Azure CI构建失败：元数据版本不匹配求助

这种本地构建正常但CI失败的情况，大概率是依赖环境不一致或者CI缓存了旧依赖导致的，给你几个针对性的解决步骤：

1. 确认依赖版本兼容性 #

Angular的元数据版本和框架版本强绑定：

• Angular 4.x 对应元数据版本3
• Angular 5.x+ 对应元数据版本4

报错里说"期望3但找到4"，说明你的angularfire2版本适配Angular5+，但CI环境里的@angular/core可能是4.x版本，或者反过来。先检查本地package.json：

• 确保angularfire2和@angular/core的版本是官方兼容的（比如angularfire2 5.x对应@angular 5.x，angularfire2 4.x对应@angular 4.x）
• 把依赖版本从带^或~的模糊版本改成精确版本，比如"angularfire2": "5.0.0-rc.11"而不是"angularfire2": "^5.0.0-rc.11"，避免CI安装时自动升级到不兼容的版本

2. 清理CI构建缓存 #

VSO的构建代理可能缓存了之前的node_modules，导致旧依赖没有被更新。你可以在构建步骤里添加前置命令：
如果是Linux/macOS代理：

rm -rf node_modules package-lock.json
npm cache clean --force

如果是Windows代理：

Remove-Item -Recurse -Force node_modules, package-lock.json
npm cache clean --force

然后再执行npm install和ng build --prod，确保CI环境安装的是全新的、和本地一致的依赖。

3. 同步本地依赖锁文件到仓库 #

本地执行以下操作，确保lock文件和当前依赖完全匹配：

rm -rf node_modules package-lock.json
npm install

然后把更新后的package-lock.json提交到Git仓库，这样CI执行npm install时会严格按照lock文件安装和本地一模一样的依赖版本，避免版本差异。

4. 检查CI的Node.js版本 #

有时候Node.js版本差异也会导致依赖安装或构建问题。确认CI构建代理使用的Node.js版本和本地一致（比如本地用Node 10，CI也配置成Node 10）。在Azure DevOps的构建任务里，你可以添加一个「Node.js工具安装器」任务，指定和本地相同的Node版本。

5. 验证CI构建命令和本地一致 #

确保CI里的构建命令和本地完全相同：本地用ng build --prod，CI里也不要加额外参数，比如不要用npm run build如果你的package.json里的build命令有差异。

按这些步骤排查下来，基本能解决元数据版本不匹配的问题。

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