Azure Pipeline Node版本不匹配问题求助：运行时退出码3

退出码3在Node.js相关的Azure Pipeline中，大多指向文件/模块未找到或脚本执行时的路径、依赖异常，结合Node版本配置场景，可按以下步骤排查：

• 对齐Node版本
  确保Pipeline配置的Node版本和本地开发环境一致。如果版本差异过大，会导致依赖安装或脚本运行不兼容。可通过NodeTool@0任务锁定稳定版本：

  - task: NodeTool@0
    inputs:
      versionSpec: '18.x' # 替换为你本地使用的版本
    displayName: 'Install Node.js'
  

• 确保依赖安装完整
  依赖安装不完整是触发退出码3的常见原因。添加缓存步骤提升安装效率，同时强制终止并暴露安装错误：

  - task: Cache@2
    inputs:
      key: 'npm | "$(Agent.OS)" | package-lock.json'
      path: $(npm_config_cache)
    displayName: 'Cache npm dependencies'
  
  - script: npm install
    displayName: 'Install dependencies'
    continueOnError: false
  

• 校验脚本命令与路径
  检查Pipeline中执行的命令（如npm run build）是否在package.json的scripts字段中存在，同时确认脚本涉及的文件路径在Pipeline工作目录下可访问，避免相对路径错误。

• 提取完整错误日志
  退出码3只是终止状态，必须查看Pipeline的完整运行日志，找到具体报错信息（比如Cannot find module或File not found），这是精准定位问题的核心。在Azure DevOps的Pipeline详情页展开所有步骤日志，定位触发退出的具体命令输出。

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