Azure Pipelines中pnpm强制使用Node16而非Node20的问题排查

我在Azure Pipelines中使用pnpm已有一段时间，近期尝试升级至Node 20，但明明已安装Node 20，pnpm却始终使用Node 16.20。我尝试过通过npm和corepack两种方式安装pnpm，结果一致。

疑问：为何pnpm会使用Node 16.20？如何配置使其使用Node 20.10？

我的流水线配置 #

variables:
  pnpm_config_cache: $(Pipeline.Workspace)/.pnpm-store

steps:
  - task: UseNode@1
    inputs: 
      version: '20.x'

  - task: Cache@2
    inputs:
      key: 'pnpm | "$(Agent.OS)" | pnpm-lock.yaml'
      path: $(pnpm_config_cache)
    displayName: Cache pnpm

  - script: |
      node -v
      pnpm -v
      corepack enable
      corepack prepare pnpm@latest-8 --activate
      pnpm config set store-dir $(pnpm_config_cache)
      pnpm env list
      pnpm env use --global 20
      node -v
      pnpm -v
    displayName: "Setup pnpm"

  - script: |
      node -v
      pnpm -v
      pnpm install
      pnpm run build
    displayName: "pnpm install and build"

构建输出 #

Found tool in cache: node 20.10.0 x64
Prepending PATH environment variable with directory: /opt/hostedtoolcache/node/20.10.0/x64/bin
Finishing: Install NodeJs

....

v20.10.0
/home/vsts/work/_temp/d066a5a6-70e7-46d2-8509-9bd3c85af27b.sh: line 2: pnpm: command not found
Preparing pnpm@latest-8 for immediate activation...
v20.10.0
8.12.1
Fetching Node.js 16.20.0 ...
  16.20.0
ERR_PNPM_CANNOT_MANAGE_NODE Unable to manage Node.js because pnpm was not installed using the standalone installation script

If you want to manage Node.js with pnpm, you need to remove any Node.js that was installed by other tools, then install pnpm using one of the standalone scripts that are provided on the installation page: https://pnpm.io/installation
v20.10.0
8.12.1

.... (pnpm install step)

v20.10.0
8.12.1
WARN Unsupported engine: wanted: {"node":">= 20.10 < 22"} (current: {"node":"16.20.0","pnpm":"8.12.1"})

原因分析 #

• pnpm管理Node的权限限制：错误提示明确说明，通过corepack安装的pnpm无法管理由外部工具（这里是UseNode@1任务）安装的Node版本。只有通过pnpm独立脚本安装的pnpm，才能使用pnpm env命令管理Node版本。
• 环境变量优先级冲突：虽然UseNode@1已将Node 20加入PATH，但pnpm内部会默认调用自己管理的Node版本（这里是缓存的16.20），导致执行pnpm命令时跳过了PATH中的Node 20。

解决配置方案 #

方案一：改用pnpm独立脚本安装，由pnpm管理Node版本 #

移除UseNode@1任务，直接让pnpm安装并指定Node 20版本：

variables:
  pnpm_config_cache: $(Pipeline.Workspace)/.pnpm-store

steps:
  - task: Cache@2
    inputs:
      key: 'pnpm | "$(Agent.OS)" | pnpm-lock.yaml'
      path: $(pnpm_config_cache)
    displayName: Cache pnpm

  - script: |
      # 安装pnpm独立版本
      curl -fsSL https://get.pnpm.io/install.sh | sh -
      # 刷新环境变量确保pnpm可用
      source $HOME/.bashrc
      # 配置pnpm存储目录
      pnpm config set store-dir $(pnpm_config_cache)
      # 指定使用Node 20.10版本
      pnpm env use --global 20.10
      node -v
      pnpm -v
    displayName: "Setup pnpm and Node 20"

  - script: |
      node -v
      pnpm -v
      pnpm install
      pnpm run build
    displayName: "pnpm install and build"

方案二：保留UseNode@1，避免pnpm自动切换Node版本 #

如果不想移除UseNode@1，只需跳过pnpm env相关命令，确保pnpm使用PATH中已有的Node 20：

variables:
  pnpm_config_cache: $(Pipeline.Workspace)/.pnpm-store

steps:
  - task: UseNode@1
    inputs: 
      version: '20.x'

  - task: Cache@2
    inputs:
      key: 'pnpm | "$(Agent.OS)" | pnpm-lock.yaml'
      path: $(pnpm_config_cache)
    displayName: Cache pnpm

  - script: |
      node -v
      # 启用corepack并激活pnpm
      corepack enable
      corepack prepare pnpm@latest-8 --activate
      pnpm config set store-dir $(pnpm_config_cache)
      # 移除pnpm env相关命令，避免触发版本切换
      node -v
      pnpm -v
    displayName: "Setup pnpm"

  - script: |
      node -v
      pnpm -v
      pnpm install
      pnpm run build
    displayName: "pnpm install and build"

说明：方案二的核心是放弃使用pnpm env use命令，因为corepack安装的pnpm没有权限管理外部安装的Node。只要确保PATH中Node 20的优先级最高，pnpm就会默认使用这个版本。

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