Gradle Kotlin DSL执行git pull任务失败求助

1. 检查Gradle Exec任务的命令参数拆分是否正确 #

Gradle的commandLine要求将命令拆分为独立参数，不能把完整命令作为单个字符串传入。错误的参数格式会导致Git无法解析指令，进而触发SSH相关错误。
正确的任务配置示例：

tasks.register<Exec>("makePull") {
    commandLine("git", "pull", "origin", "develop:develop")
    workingDir = file(".") // 明确指定项目根目录为工作目录
}

若之前将git pull origin develop:develop作为单个参数传入，Git会把整个字符串当作命令名，自然无法匹配到正确的SSH主机配置。

2. 验证Gradle运行环境的SSH环境变量 #

终端能正常执行是因为继承了当前Shell的SSH环境（比如SSH_AUTH_SOCK指向运行中的ssh-agent），但Gradle作为独立进程启动时，可能未继承这些关键变量，导致无法读取SSH密钥。
可以在任务中手动传递必要的环境变量，或确保Gradle在终端环境中运行：

tasks.register<Exec>("makePull") {
    commandLine("git", "pull", "origin", "develop:develop")
    // 从当前Shell环境复制SSH认证套接字变量
    environment("SSH_AUTH_SOCK", System.getenv("SSH_AUTH_SOCK"))
    workingDir = file(".")
}

也可尝试在终端中执行./gradlew makePull，而非直接通过IDE启动Gradle，确保环境变量继承完整。

3. 检查Gradle运行用户的SSH配置权限 #

如果Gradle以不同用户身份运行（比如IDE的后台服务用户），可能无法读取当前用户~/.ssh目录下的密钥文件，或因密钥文件权限过宽（如其他用户可读写）被Git拒绝使用。

• 确认~/.ssh/id_rsa（或对应密钥文件）权限为600，.ssh目录权限为700
• 若通过IDE运行Gradle，检查IDE是否以当前用户身份启动，必要时重启IDE确保权限生效。

4. 确认Git远程仓库配置与工作目录 #

在项目根目录执行git remote -v，验证origin的SSH地址配置正确（如git@github.com:xxx/xxx.git）。即便终端运行正常，Gradle的工作目录若未指向项目根目录，也会导致Git读取不到正确的远程配置，显式指定workingDir = file(".")可解决此问题。

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