Azure DevOps流水线升级Node.js至20.x时ADF验证报错求助

问题场景 #

按照官方文档搭建Azure Data Factory CI/CD流水线后，将Node.js版本升级至20.x，相关配置如下：

流水线Node.js安装任务 #

- task: NodeTool@0
  inputs:
    versionSpec: '20.x'
  displayName: 'Install Node.js'

package.json依赖配置 #

"dependencies":{
        "@microsoft/azure-data-factory-utilities":"^1.0.0"
    }

验证阶段触发以下错误：

TypeError [ERR_INVALID_ARG_TYPE]: The "this" argument must be an instance of Performance. Received an instance of Object
    at now (node:internal/perf/performance:139:5)

解决方案 #

这个错误是由于@microsoft/azure-data-factory-utilities 1.x版本不兼容Node.js 18+的Performance API改动导致的，解决步骤如下：

1. 升级ADF工具包依赖版本
   修改package.json中的依赖版本，升级到至少^2.0.0（建议使用最新稳定版）：

   "dependencies":{
            "@microsoft/azure-data-factory-utilities":"^2.0.0"
        }
   

2. 更新依赖并重新运行流水线
   执行npm install更新本地依赖后，重新触发CI/CD流水线即可。

原因说明 #

旧版本的ADF工具包使用了不符合Node.js 18+规范的Performance API调用逻辑，新版本已修复该兼容性问题，适配了Node.js 18及以上版本的运行环境。

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