如何在Azure DevOps托管管道中设置dotnet build使用的Node版本？

问题描述 #

使用Azure DevOps微软托管构建代理（windows-latest）时，已通过UseNode@1任务指定使用Node.js 18.17.0，且脚本node --version输出符合预期，但DotNetCoreCLI@2的build步骤却始终使用代理自带的Node.js 16.20.0，导致设置NODE_OPTIONS: '--openssl-legacy-provider'时出现错误：

C:\agents\3.224.1\externals\node16\bin\node.exe: --openssl-legacy-provider is not allowed in NODE_OPTIONS
##[error]Exit code 9 returned from process: file name 'C:\agents\3.224.1\externals\node16\bin\node.exe', arguments '"D:\a\_tasks\DotNetCoreCLI_5541a522-603c-47ad-91fc-a4b1d163081b\2.221.0\dotnetcore.js"'.

原因分析 #

DotNetCoreCLI@2任务本身依赖代理内置的Node.js来运行其JavaScript逻辑，这个Node路径是任务硬编码的，不会读取系统PATH中配置的全局Node版本。因此即使你通过UseNode@1切换了全局Node，任务内部依然会调用代理自带的Node 16.20.0，进而触发不兼容--openssl-legacy-provider参数的报错。

解决方案 #

方案一：覆盖任务的Node执行路径 #

通过设置NODE_EXE环境变量，强制DotNetCoreCLI@2任务使用你指定的Node版本：

1. 在UseNode@1之后添加脚本，获取当前生效的Node路径并设置为管道变量：

- script: echo "##vso[task.setvariable variable=NODE_EXE]$(where node | findstr /v node_modules)"
  displayName: "获取并设置Node路径变量"

2. 在DotNetCoreCLI@2的build任务中，添加NODE_EXE环境变量引用：

- task: DotNetCoreCLI@2
  displayName: 'dotnet build'
  env:
    NODE_EXE: '$(NODE_EXE)'
    NODE_OPTIONS: '--openssl-legacy-provider'
  inputs:
    command: 'build'
    projects: '${{ parameters.relativeWebProjectPath }}'
    arguments: '--configuration ${{ parameters.buildConfiguration }} --no-restore --verbosity diagnostic'

方案二：移除全局NODE_OPTIONS，改为项目内配置 #

如果你的--openssl-legacy-provider是为项目构建（比如前端打包）设置的，可将该参数移至项目内部的构建脚本中，避免影响DotNetCoreCLI任务本身的Node进程：

• 例如在webpack配置文件中添加：

module.exports = {
  // ...其他配置
  plugins: [
    // ...其他插件
  ]
};

• 或者在项目的package.json的scripts中指定：

{
  "scripts": {
    "build": "NODE_OPTIONS='--openssl-legacy-provider' webpack --mode production"
  }
}

方案三：直接用脚本执行dotnet命令 #

放弃使用DotNetCoreCLI@2任务，改用script任务直接执行dotnet build命令，这样会完全使用PATH中配置的Node版本：

- script: dotnet build ${{ parameters.relativeWebProjectPath }} --configuration ${{ parameters.buildConfiguration }} --no-restore --verbosity diagnostic
  displayName: 'dotnet build'
  env:
    NODE_OPTIONS: '--openssl-legacy-provider'

验证 #

修改后重新运行管道，dotnet build步骤会使用你指定的Node 18.17.0，--openssl-legacy-provider参数也能正常生效。

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