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
相关产品推荐
相关产品推荐

