Linux下URL内嵌Git访问凭证报Authentication failed如何解决

通过HTTP协议克隆TFS/Azure平台托管的Git仓库时，使用内嵌账号密码的URL格式执行克隆，直接返回Authentication failed认证失败错误，相同操作逻辑在Windows环境下可正常执行。
使用的内嵌凭证URL格式如下：
https://username:password@corptfs.com/tfs/CorpCollection/MyProject

测试过程中确认两个可正常认证的场景：

• URL不携带任何凭证，仅填写仓库基础地址，在命令行交互提示中手动输入用户名和密码，认证可正常通过
• 使用仅内嵌用户名的URL格式https://username@corptfs.com/tfs/CorpCollection/MyProject，在交互提示中仅输入密码，认证可正常通过

• 跨平台URL编码逻辑差异：Windows环境下Git for Windows默认会自动对URL内嵌凭证段的特殊字符做URL编码，Linux、macOS等非Windows环境的默认Git配置不会触发该自动编码逻辑。如果密码中包含@、:、/、#、?等URL保留字符，明文拼接时会被Git解析为URL地址结构的一部分，导致实际传递给服务端的账号、密码字段截断错位，最终认证失败。
• 凭证助手拦截规则差异：非Windows环境下配置的Git credential helper（凭证助手）可能存在拦截URL内明文密码的规则，强制触发交互输入流程，导致URL中携带的密码根本未发送到TFS服务端。

1. 对密码做URL编码后拼接
   将密码中所有URL保留字符替换为对应的URL编码值（常见字符编码对照：@→%40、:→%3A、/→%2F、#→%23、?→%3F），再拼接到URL中即可。
   示例：原密码为p@ss:w/ord，编码后拼接的可正常使用的克隆URL为：
   https://username:p%40ss%3Aw%2Ford@corptfs.com/tfs/CorpCollection/MyProject
2. 临时禁用凭证助手排查拦截问题
   执行克隆命令时追加配置参数，临时跳过本地凭证助手规则，验证是否为凭证助手拦截导致的失败：
   git -c credential.helper= clone https://username:编码后的密码@corptfs.com/tfs/CorpCollection/MyProject
   如果该命令可正常克隆，说明本地凭证助手配置存在拦截规则，调整对应配置即可。
3. 安全注意事项：不建议长期在URL中明文存储账号密码，调试通过后建议通过Git凭证存储功能或系统密钥管理工具保存凭证，避免密码明文泄露。

内容的提问来源于stack exchange，提问作者Efi Weiss