Cloudflare Pages网站构建失败求助：npm ci依赖同步异常

问题背景 #

通过GitHub推送代码到Cloudflare托管网站，近期构建/重新部署持续失败。已尝试删除node_modules和package-lock.json，重新执行npm i --package-lock-only、npm install、npm ci，问题未解决。核心错误如下：

执行npm ci时提示package.json与package-lock.json不同步，lock文件中的@babel/core@7.9.0无法满足package.json中@babel/core@7.25.7的要求，且lock文件缺失多个依赖包，构建命令退出码为1。

解决方案 #

1. 彻底重新生成匹配的package-lock.json #

这是解决版本不匹配问题的核心步骤：

• 删除本地的node_modules文件夹和package-lock.json文件
• 执行npm install，让npm根据当前package.json的依赖版本重新生成完全匹配的package-lock.json
• 将新生成的package-lock.json提交并推送到GitHub仓库

2. 调整Cloudflare构建命令 #

如果npm ci持续报错，可尝试替换构建命令：

• 原命令如果是npm ci && npm run build，改为npm install && npm run build

  注：npm install会自动处理依赖版本匹配，无需严格依赖lock文件，虽然速度略慢，但能规避版本不匹配问题

3. 检查package.json的依赖版本范围 #

确认@babel/core在package.json中的版本定义：

• 如果是带范围的版本（如^7.25.7），之前的lock文件可能拉取了旧版兼容版本，重新生成lock文件后会更新到符合范围的最新版
• 若需要固定版本，直接写死7.25.7而非范围号，避免版本漂移

4. 清理Cloudflare构建缓存 #

Cloudflare可能缓存了旧的依赖数据：

• 登录Cloudflare仪表板，进入项目的构建配置页面
• 找到构建缓存选项，清理缓存后重新触发部署

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