You need to enable JavaScript to run this app. Azure DevOps自建代理执行Gradle管道报'sh': Not a directory错误
优惠活动
大模型
产品
解决方案
定价
更多

Azure DevOps自建代理执行Gradle管道报'sh': Not a directory错误

问题场景

计划在Azure DevOps自建代理上完成Gradle项目的构建流程,已完成管道配置后触发执行,出现异常:在代理服务器上手动执行gradlew包装器脚本可正常运行、无报错,但通过管道触发执行时直接失败。

管道配置定义
trigger:
 - azure-pipelines

pool:
 name: Default

steps:

 - task: Gradle@2
   inputs:
   workingDirectory: ''
   gradleWrapperFile: 'gradlew'
   gradleOptions: '-Xmx3072m'
   javaHomeOption: 'JDKVERSION'
   jdkVersionOption: 1.8
   jdkArchitectureOption: x64
   jdkUserInputPath: '/usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java'
   publishJUnitResults: false
   testResultsFiles: '**/TEST-*.xml'
   tasks: 'build'
管道执行报错日志
Error: The process '/azp/agent/_work/1/s/gradlew' failed with exit code 126
at ExecState._setResult (/azp/agent/_work/_tasks/Gradle_8d8eebd8-2b94-4c97-85af-839254cc6da4/2.176.0/node_modules/azure-pipelines-task-lib/toolrunner.js:816:25)
at ExecState.CheckComplete (/azp/agent/_work/_tasks/Gradle_8d8eebd8-2b94-4c97-85af-839254cc6da4/2.176.0/node_modules/azure-pipelines-task-lib/toolrunner.js:799:18)
at ChildProcess.<anonymous> (/azp/agent/_work/_tasks/Gradle_8d8eebd8-2b94-4c97-85af-839254cc6da4/2.176.0/node_modules/azure-pipelines-task-lib/toolrunner.js:721:19)
at emitTwo (events.js:106:13)
at ChildProcess.emit (events.js:191:7)
at maybeClose (internal/child_process.js:920:16)
at Socket.<anonymous> (internal/child_process.js:351:11)
at emitOne (events.js:96:13)
at Socket.emit (events.js:188:7)
at Pipe._handle.close [as _onclose] (net.js:509:12)

SYSTEMVSSCONNECTION exists true
   /azp/agent/_work/1/s/gradlew build
   /usr/bin/env: 'sh': Not a directory
   ##[error]Error: The process '/azp/agent/_work/1/s/gradlew' failed with exit code 126
核心根因定位
  • Linux系统下执行退出码126的含义为:当前环境无法调用目标可执行文件,一般是权限不足、解释器路径配置错误导致
  • 日志中/usr/bin/env: 'sh': Not a directory是本次故障的直接诱因:gradlew脚本首行shebang声明为#!/usr/bin/env sh,执行时会通过env命令从系统PATH变量中查找sh解释器的路径。管道运行时的自建代理服务环境,和手动登录的终端环境使用的是两套完全独立的PATH配置:手动登录的终端加载用户级PATH配置可正常找到sh路径,但后台运行的代理服务的PATH配置存在错误——将一个指向sh的普通文件的路径(而非sh所在的目录)加入了PATH搜索路径,导致env解析sh路径时,把普通文件当成目录处理,最终报错。
  • 管道配置中还有一处潜在配置错误:jdkUserInputPath填写的是java可执行文件的完整路径,而非JDK的根目录,在解决当前报错后会触发后续的JDK识别失败问题。
可落地修复步骤
  • 重启自建代理服务前,在服务的环境配置中明确修正PATH变量,将sh所在的系统目录(一般为/bin、/usr/bin)放到PATH搜索路径的最前端,移除之前错误的文件路径项,确保服务运行环境可以正常解析sh的位置。
  • 可在Gradle构建步骤前插入命令行任务做定位验证,执行echo $PATH和which sh两条命令,直接查看管道运行环境下的PATH配置、sh路径解析结果,快速定位错误的路径项。
  • 修正Gradle任务的JDK配置:将jdkUserInputPath的值从/usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java修改为/usr/lib/jvm/java-8-openjdk-amd64,匹配JDK根目录的要求。
  • 在执行Gradle任务前插入权限修正步骤,执行chmod +x gradlew,确保代码签出后gradlew脚本具备可执行权限,避免权限类126报错。

内容的提问来源于stack exchange,提问作者Dokksen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 19:54:08