执行helm dependency build时提示requirements.lock与requirements.yaml不同步问题求助

你遇到的问题是执行helm dependency build <Chart name>时，Helm检测到requirements.lock和requirements.yaml内容不一致，抛出了Error: requirements.lock is out of sync with requirements.yaml错误。你的两个文件内容如下：

requirements.yaml：

dependencies:
  - name: redis
    version: 0.1.2
    repository: http://helm-charts.repo:8800/

requirements.lock：

dependencies:
  - name: redis
    repository: http://helm-charts.repo:8800/
    version: 0.1.2
    digest: sha256: <some alpha numeric value>
    generated: <>

快速解决步骤 #

Helm的lock文件是用来固定依赖的精确版本和校验信息的，当它和yaml文件出现不一致时，最直接的修复方式是重新生成lock文件：

1. 删除现有的requirements.lock文件
   在你的Chart目录下执行：

   rm requirements.lock
   

2. 重新执行依赖构建命令
   再次运行：

   helm dependency build <Chart name>
   

   这时候Helm会重新拉取依赖，生成和当前requirements.yaml完全匹配的requirements.lock文件，新的lock文件会包含正确的digest和generated时间戳。

3. 验证同步状态
   你可以用以下命令检查依赖是否同步：

   helm dependency update <Chart name>
   

   如果没有报错，说明两个文件已经同步完成。

为什么会出现这个问题？ #

通常这种情况的原因包括：

• 手动修改过requirements.lock文件（比如调整了字段顺序、修改了digest值）
• requirements.yaml被修改后，没有重新执行helm dependency build或helm dependency update来更新lock文件
• 依赖仓库中的对应版本包发生了变化，导致lock文件中的digest校验失败

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