Team City：获取指定构建之前的上一个构建产物

我完全懂你这种头疼的感觉——Perforce变更列表不连续的特性，加上TeamCity Web UI里只能静态指定构建号的限制，确实没法直接实现“对比当前构建和上一个构建结果”的需求。不过用REST API的话，有两个更优雅的方案，不用手动反向遍历构建：

方案1：直接调用当前构建的previousBuild端点（最推荐） #

TeamCity的REST API提供了一个非常实用的端点，可以直接获取当前构建的同构建类型的上一个构建，完全不用关心Perforce变更列表是否连续。

具体操作： #

1. 在你的构建脚本中，利用TeamCity自带的环境变量BUILD_ID（当前构建的ID）和SERVER_URL（TeamCity服务器地址），调用以下API：

curl -u "${TEAMCITY_USER}:${TEAMCITY_PASSWORD}" "${SERVER_URL}/app/rest/builds/id:%BUILD_ID%/previousBuild"

2. 这个请求会返回上一个构建的完整信息，包括它的ID、revision、artifact路径等。你可以用jq或者其他工具提取需要的字段，比如上一个构建的artifact下载地址，或者构建号。

这个方案的优势是完全由TeamCity维护构建的顺序关系，不用自己处理revision的对比逻辑，既简单又可靠。

方案2：通过过滤构建列表获取指定revision之前的最新构建 #

如果因为TeamCity版本限制（比如旧版本不支持previousBuild端点），可以通过构建列表过滤来实现：

具体操作： #

调用/app/rest/builds端点，结合以下定位器参数：

• buildType:<你的构建类型ID>：限定在目标构建类型下查找
• revision:(before:<当前构建的Perforce变更列表>)：只找revision早于当前的构建
• status:SUCCESS（可选）：过滤成功的构建，避免对比失败的结果
• count:1：只返回第一个结果
• orderBy:startDate:desc：按构建启动时间倒序，确保拿到的是最新的前一个构建

示例curl命令：

curl -u "${TEAMCITY_USER}:${TEAMCITY_PASSWORD}" "${SERVER_URL}/app/rest/builds?locator=buildType:MyBuildType,status:SUCCESS,revision:(before:%BUILD_VCS_NUMBER%),count:1,orderBy:startDate:desc"

这里的BUILD_VCS_NUMBER是TeamCity的环境变量，会自动填充当前构建对应的Perforce变更列表号。

集成到构建配置的小技巧 #

• 把TeamCity的API用户名和密码存在项目的安全参数里，不要硬编码在脚本中
• 在构建步骤中先执行API调用脚本，把获取到的前一个构建ID/artifact路径存为环境变量，后续步骤直接引用这个变量来下载产物并对比

这样就能完美实现“自动对比当前构建与上一个构建结果”的需求，不用再纠结手动指定构建号的问题啦！

内容的提问来源于stack exchange，提问作者Ben Hymers