Ruby on Rails执行bundle lock报Cannot write lockfile while frozen错误如何解决

报错原因 #

该报错是因为当前Bundler处于*冻结（frozen）*模式，该模式下禁止任何对Gemfile.lock文件的修改操作。
常见触发冻结模式的场景有三个：

• 当前操作环境是生产环境，生产环境Bundler默认开启冻结配置，避免意外修改依赖版本
• 你此前执行过bundle install --frozen手动开启了冻结
• 项目本地.bundle/config配置文件中提前设置了BUNDLE_FROZEN: true参数

如果需要调整依赖平台配置，本地开发环境可先执行bundle config unset frozen临时关闭冻结，调整完成后再按需开启；如果是生产环境，禁止直接在生产端修改lockfile，所有依赖调整都要在开发/测试环境完成后，将更新后的Gemfile和Gemfile.lock同步到生产端再执行部署。

Gemfile.lock的作用 #

lockfile即项目根目录下的Gemfile.lock文件，核心作用有三个：

• 固定依赖版本：Gemfile中通常定义的是依赖的版本范围，lockfile会记录所有一级依赖、间接依赖的实际安装精确版本，保证所有团队成员、所有部署环境安装的依赖完全一致，避免出现跨环境的版本兼容问题。
• 匹配部署平台：记录依赖对应的适配平台信息，你执行的bundle lock --add-platform命令就是在lockfile中添加目标部署平台标识，拉取依赖时会匹配对应平台的版本，避免跨平台部署时出现原生扩展编译失败的问题。
• 提升安装效率：Bundler可直接读取lockfile中的版本树信息，不需要每次执行安装时重新计算依赖匹配关系，大幅提升bundle install的执行速度。

frozen状态的含义 #

frozen是Bundler提供的安全保护机制，开启后有两个核心规则：

1. 严格校验Gemfile和Gemfile.lock的一致性，两者内容不匹配时直接报错退出，不会自动更新lockfile
2. 禁止任何对Gemfile.lock的写入修改操作
   该状态默认在生产环境、CI/CD流水线等对依赖稳定性要求高的场景开启，目的是保证依赖版本完全可控，避免部署、构建过程中意外变更依赖版本引入线上故障。

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