BitBucket开启2FA后，Android Gradle中Git命令失效求助

问题根源 #

开启BitBucket双因素认证（2FA）后，Git不再支持用账号密码进行HTTPS认证，而你Gradle脚本里直接执行git describe这类命令时，Git后台尝试认证却无法交互式输入2FA验证码，导致命令执行失败（返回码1），最终没法正常获取versionName和versionCode。

解决方案 #

方案1：切换为SSH密钥认证（推荐）

这是最稳定的方式，不用折腾令牌或密码：

• 生成SSH密钥对（没有的话执行这个命令）：ssh-keygen -t ed25519 -C "your-email@example.com"，一路回车即可完成生成
• 登录BitBucket，进入个人设置 > SSH密钥，把本地生成的公钥（默认路径是~/.ssh/id_ed25519.pub里的内容）添加进去
• 把仓库的远程URL从HTTPS格式（https://bitbucket.org/your-username/your-repo.git）改成SSH格式（git@bitbucket.org:your-username/your-repo.git）
  • 执行命令修改：git remote set-url origin git@bitbucket.org:your-username/your-repo.git
• 手动测试git describe --abbrev=0 --tags，如果能正常返回标签，那Gradle脚本里的命令也会正常工作了

方案2：使用BitBucket个人访问令牌（PAT）

如果坚持用HTTPS连接，可以用PAT替代密码：

• 登录BitBucket，进入个人设置 > 应用密码，创建一个新的应用密码：
  • 勾选必要权限：至少要选仓库 > 读权限
  • 保存生成的令牌（只显示一次，一定要记好）
• 配置Git凭证助手让它记住PAT：
  • 执行git config --global credential.helper store
  • 手动拉一次仓库（比如git pull），输入你的BitBucket用户名，然后把刚才生成的PAT作为密码输入
  • Git会把凭证存在本地，之后Gradle执行Git命令时会自动用这个凭证，不需要再交互

方案3：修复Gradle脚本的小问题

另外注意到你提供的evalVersionName函数有个bug——没有返回值！这会导致即使Git命令成功执行，versionName也始终是默认的"undefined"。修改后的函数要加上return：

project.ext.evalVersionName = {
    def p = Runtime.getRuntime().exec("git describe --abbrev=0 --tags")
    def result = p.waitFor()
    def versionName = "undefined"
    if (result == 0) {
        versionName = p.getInputStream().readLines().get(0)
    } else {
        // 打印错误信息，方便排查问题
        def errorMsg = p.getErrorStream().readLines().join("\n")
        project.logger.error("Failed to get versionName from Git: ${errorMsg}")
    }
    project.logger.debug("versionName: ${versionName}")
    return versionName // 必须加上这一行！
}

对应versionCode的evalVersionCode函数也可以参考这个逻辑，加上错误处理：

project.ext.evalVersionCode = {
    def p = Runtime.getRuntime().exec("git rev-list --count HEAD")
    def result = p.waitFor()
    def versionCode = 1 // 设置默认值
    if (result == 0) {
        versionCode = p.getInputStream().readLines().get(0).toInteger()
    } else {
        def errorMsg = p.getErrorStream().readLines().join("\n")
        project.logger.error("Failed to get versionCode from Git: ${errorMsg}")
    }
    project.logger.debug("versionCode: ${versionCode}")
    return versionCode
}

验证 #

修改完成后，执行./gradlew clean assembleDebug（或者你常用的Gradle构建任务），查看日志里的versionName和versionCode是否正确输出，同时确认没有认证相关的错误提示。

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