本文详解如何在 spring boot 应用中使用 jgit 实现双层身份控制：既通过 credentialsprovider 指定远程操作（clone/push）的认证凭据（如测试账户的 pat），又显式设置 commit 的 author 和 committer 信息，确保 git 提交记录真实反映测试账户身份。
本文详解如何在 spring boot 应用中使用 jgit 实现双层身份控制：既通过 credentialsprovider 指定远程操作（clone/push）的认证凭据（如测试账户的 pat），又显式设置 commit 的 author 和 committer 信息，确保 git 提交记录真实反映测试账户身份。
在 JGit 中，“谁执行了提交”与“谁被授权访问远程仓库”是两个独立的概念，需分别配置：
- 远程操作认证（Authentication）：由 CredentialsProvider 控制，用于 clone、push、pull 等网络请求，决定 GitHub 是否允许该操作（例如使用测试账户的 Personal Access Token）；
- 提交元数据（Commit Identity）：由 setAuthor() 和 setCommitter() 显式指定，决定 Git 历史中显示的 author 和 committer 字段（即 git log 中看到的姓名与邮箱），不会自动继承 CredentialsProvider 中的用户名。
因此，仅设置 UsernamePasswordCredentialsProvider 是不够的——它只影响 HTTP 认证头，不影响提交对象的签名信息。若未显式设置 author/committer，JGit 会回退到系统默认值（如本地 Git 配置中的 user.name/user.email，或环境变量），导致提交仍显示为你的个人账户。
✅ 正确做法如下（完整可运行示例）：
Pilot Digital Twin Setup
下载
部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……
String repoUrl = "https://github.com/user/repo.git";
String folderName = "/path/to/local/repo";
String testUsername = "test-account";
String testEmail = "test-account@example.com";
String patToken = "ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // 测试账户 PAT
// 1. 创建认证提供器（用于 clone/push 等网络操作）
CredentialsProvider credentialsProvider =
new UsernamePasswordCredentialsProvider(patToken, "");
try (Git git = Git.cloneRepository()
.setURI(repoUrl)
.setDirectory(new File(folderName))
.setCredentialsProvider(credentialsProvider)
.call()) {
// 2. 添加文件
git.add().addFilepattern(".").call();
// 3. 提交：必须显式设置 author 和 committer！
git.commit()
.setMessage("test commit from test account")
.setAuthor(testUsername, testEmail) // ← 关键：设置 author
.setCommitter(testUsername, testEmail) // ← 关键：设置 committer
.call();
// 4. 推送：复用 credentialsProvider 完成身份认证
git.push()
.setCredentialsProvider(credentialsProvider)
.call();
}⚠️ 注意事项：
- setAuthor() 和 setCommitter() 必须同时设置，否则未设置项将 fallback 到系统默认值；
- 邮箱地址需与 GitHub 测试账户关联的邮箱一致，否则提交将无法关联到该账户（GitHub 不会验证邮箱所有权，但 UI 上可能显示为“unverified”或不归属该账户）；
- PAT 权限需包含 repo（或至少 public_repo + write:packages 等必要 scope），且不能是已过期或被撤销的 token；
- 若使用 SSH URL（如 git@github.com:user/repo.git），则 CredentialsProvider 不生效，应改用 SshSessionFactory 配置密钥；HTTP(S) 场景下才适用 UsernamePasswordCredentialsProvider；
- Spring Boot 中建议将 PAT 存于 application.yml 并通过 @Value 注入，切勿硬编码。
总结：JGit 的提交身份完全由 commit 对象的 author/committer 字段决定，与网络认证解耦。要真正实现“以测试账户身份提交”，必须在 git.commit() 调用中明确调用 .setAuthor(...) 和 .setCommitter(...)，并配合 CredentialsProvider 完成远程操作鉴权——二者缺一不可。
