Azure构建流水线升级Yarn 1.22.x至3.8.3时遇锁文件错误

问题场景 #

在Azure DevOps构建流水线中将Yarn从1.22.x版本升级至3.8.3，使用的流水线YAML配置如下：

- task: NodeTool@0
        inputs:
            versionSpec: '16.x'
            checkLatest: true   
      script: corepack enable && yarn set version 3.8.3 && yarn install --network-timeout=1000000 --frozen-lockfile 
        displayName: Install dependencies
      - pwsh: |
            # yarn nx reset # Resets cache and nx daemon
            yarn nx run-many --target=build --configuration production --projects="my-app"
        displayName: Build

运行流水线时出现错误：

本次安装会修改锁文件，这是明确禁止的。

问题原因 #

Yarn 3.x采用的lockfile格式（yarn.lock v2）与Yarn 1.x的格式完全不兼容。当在流水线中切换到Yarn 3.8.3后，执行yarn install --frozen-lockfile时，新版本Yarn需要更新旧的lockfile来适配新格式，但--frozen-lockfile参数强制禁止修改锁文件，因此触发冲突报错。

解决方案 #

1. 本地完成Yarn版本升级与lockfile更新

   • 在本地开发环境执行：corepack enable && yarn set version 3.8.3
   • 运行yarn install生成适配Yarn 3.x的新lockfile
   • 将更新后的yarn.lock以及自动生成的.yarnrc.yml文件提交到代码仓库

2. 调整流水线安装命令
   如果已经提交了新的lockfile，可保留--frozen-lockfile参数；若未提交，先移除该参数，待本地更新完成后再添加。调整后的流水线脚本示例：

   - task: NodeTool@0
     inputs:
         versionSpec: '16.x'
         checkLatest: true   
   - script: corepack enable && yarn set version 3.8.3 && yarn install --network-timeout=1000000 --frozen-lockfile
     displayName: Install dependencies
   - pwsh: |
         yarn nx reset # Resets cache and nx daemon
         yarn nx run-many --target=build --configuration production --projects="my-app"
     displayName: Build
   

3. Nx缓存清理（可选）
   升级Yarn后，Nx的缓存可能出现兼容性问题，建议取消流水线中yarn nx reset的注释，执行缓存与守护进程重置，避免构建异常。

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