通过文件名/路径获取Bitbucket Server中文件的Commit ID

核心思路 #

更新文件所需的sourceCommitId，本质是目标分支的最新提交ID，或者该文件最后一次变更的提交ID。你之前调用提交列表接口无结果，大概率是参数格式或分支指定的问题。

可行方案 #

1. 直接拿分支最新提交ID（推荐） #

如果文件在默认分支（如main/master），调用分支信息接口：

curl -u 用户名:密码 "https://你的Bitbucket地址/rest/api/latest/projects/{projectKey}/repos/{repositorySlug}/branches?filterText=main"

返回结果中latestCommit.id字段就是你要的sourceCommitId。换其他分支的话，把filterText改成对应分支名即可。

2. 精准获取文件最后一次变更的提交 #

修正你之前的请求格式（去掉path参数的引号，指定分支更稳妥）：

curl -u 用户名:密码 "https://你的Bitbucket地址/rest/api/latest/projects/{projectKey}/repos/{repositorySlug}/commits?path=你的文件路径&until=main"

返回的提交列表里，第一个（最新的）提交的id就是目标ID。

3. 通过文件内容接口间接获取 #

调用文件原始内容接口，响应头里的X-Commit-Id就是当前文件所在的提交ID：

curl -u 用户名:密码 -I "https://你的Bitbucket地址/rest/api/latest/projects/{projectKey}/repos/{repositorySlug}/raw/你的文件路径?at=main"

（加-I只返回响应头，更快获取X-Commit-Id）

你参考的API文档翻译 #

你用的Bitbucket Server v8.1.1的「获取仓库提交列表」接口，关键参数翻译如下：

path（可选）：字符串，过滤提交列表，仅返回修改了指定路径（文件或目录，相对仓库根目录）的提交。
until（可选）：字符串，指定提交范围的结束点，可填分支名、标签名或提交ID，默认使用仓库默认分支。

注意事项 #

• 确保账号有仓库读取权限，否则接口会返回空结果或403错误
• 私有仓库需带有效身份验证（用户名+密码，或个人访问令牌）

内容的提问来源于stack exchange，提问作者Robbie Nathan