jgit 提交时默认使用系统环境或 git 全局配置的用户信息，仅设置 credentialsprovider 无法影响提交元数据；必须显式调用 setauthor() 和 setcommitter() 指定测试账号的姓名与邮箱，才能确保 commit 记录归属目标账户。
jgit 提交时默认使用系统环境或 git 全局配置的用户信息，仅设置 credentialsprovider 无法影响提交元数据；必须显式调用 setauthor() 和 setcommitter() 指定测试账号的姓名与邮箱，才能确保 commit 记录归属目标账户。
在 Spring Boot 应用中使用 JGit 执行 Git 操作时，若希望所有提交（commit）均以“测试账号”身份呈现（例如用于自动化流水线、审计隔离或多租户场景），需同时满足两个条件：
- 网络凭证认证：通过 CredentialsProvider 提供 Personal Access Token（PAT）完成 HTTPS 推送鉴权；
- 提交者元数据声明：显式设置 author 和 committer 字段，覆盖默认本地 Git 配置。
⚠️ 注意：CredentialsProvider 仅用于远程仓库的 HTTP/S 或 SSH 认证（如 clone/push/fetch），不影响 commit 对象内部的 author/committer 字段。后者由 Git 协议规范决定，必须在 git.commit() 调用中明确指定。
✅ 正确写法示例
String testUsername = "test-account";
String testEmail = "test-account@example.com";
String patToken = "ghp_..."; // 测试账号的 GitHub PAT
CredentialsProvider credentialsProvider =
new UsernamePasswordCredentialsProvider(patToken, "");
try (Git git = Git.cloneRepository()
.setURI("https://github.com/user/repo.git")
.setDirectory(new File(folderName))
.setCredentialsProvider(credentialsProvider)
.call()) {
// 添加文件
git.add().addFilepattern(".").call();
// 关键：显式设置 author 和 committer（两者通常相同）
git.commit()
.setMessage("test commit from test account")
.setAuthor(testUsername, testEmail)
.setCommitter(testUsername, testEmail)
.call();
// 推送时仍需 credentialsProvider 进行身份验证
git.push()
.setCredentialsProvider(credentialsProvider)
.call();
}
? 补充说明
- setAuthor() 表示谁编写了修改内容，setCommitter() 表示谁执行了提交操作；CI/CD 场景中二者通常一致；
- 邮箱地址需与 GitHub 测试账号已验证的邮箱匹配，否则提交不会关联到该账户头像和贡献统计；
- 若使用 git.commit().setAllUsers(...)，JGit 会自动同步 author/committer，但为清晰性和可维护性，建议分别显式设置；
- 不要依赖 System.setProperty("git.user.name", ...) 等 JVM 级设置——JGit 不读取这些系统属性，它们对 JGit 无效。
? 总结
| 组件 | 作用 | 是否必需 |
|---|---|---|
| CredentialsProvider | 控制远程操作（clone/push）的身份认证 | ✅ 必需（HTTPS 场景） |
| setAuthor() / setCommitter() | 控制 commit 对象中的元数据（显示在 GitHub 提交历史中） | ✅ 必需（实现“以测试账号提交”） |
只有二者协同配置，才能真正实现：提交记录显示为 test-account，且推送操作经 test-account 的 PAT 验证通过。
