Git Credential Manager 身份验证失败问题分析与解决方案

问题背景

在使用 Git Credential Manager (GCM) 进行 Git 操作时，部分 Windows 用户遇到了身份验证失败的问题。具体表现为执行 git pull 等命令时出现"fatal: User canceled authentication"错误，并提示输入用户名和密码。

问题现象

受影响用户在执行 Git 操作时观察到以下行为：

1. 命令执行失败，提示"用户取消了身份验证"
2. 系统回退到基础认证方式，要求手动输入凭据
3. 该问题间歇性出现，影响多个开发者

根本原因分析

经过深入调查，发现问题与 Microsoft 身份验证库(MSAL)的代理(broker)流程有关。具体表现为：

1. 在提升权限的管理员Shell中运行时，MSAL 4.61.x版本存在缺陷
2. 当尝试通过代理交互式获取令牌时，会立即提前退出
3. 抛出带有"用户取消了身份验证"消息的MsalClientException

临时解决方案

在官方修复发布前，用户可采用以下临时解决方案：

1. 在Git配置中禁用代理认证：

   git config --global credential.msauthUseBroker false
   

2. 使用非提升权限的Shell执行Git操作

永久解决方案

该问题已在以下版本中得到修复：

1. MSAL 4.64.0及更高版本
2. Git Credential Manager v2.6.0(包含MSAL 4.65.0)
3. Git for Windows v2.47.0及后续版本

建议用户升级到上述版本以彻底解决问题。

技术细节

该问题特别影响以下环境组合：

• Windows 10/11操作系统
• 使用Azure DevOps作为Git托管服务
• 在管理员权限终端中执行Git操作
• 使用HTTPS格式的远程仓库URL

问题发生时，身份验证流程会意外终止，导致GCM无法正确获取访问令牌，从而回退到基础认证方式。

最佳实践建议

1. 保持Git Credential Manager和Git客户端为最新版本
2. 在非必要情况下，避免在管理员终端中执行Git操作
3. 定期清理认证缓存，可使用专用工具如AzureAuth预热代理缓存
4. 对于关键开发环境，考虑配置备用认证方式

通过以上措施，开发者可以确保Git操作的身份验证流程稳定可靠。