调用TFS2018 Build API时遭遇405 Method Not Allowed错误

我之前帮不少开发者排查过TFS API的405问题，结合你给出的响应信息，咱们从几个最常见的原因和解决方向来梳理：

1. 先确认HTTP请求方法是否匹配API要求 #

TFS的Build API对不同操作有明确的HTTP方法规定，这是触发405的最常见原因：

• 创建构建必须用POST请求，对应端点是/_apis/build/builds?api-version=4.1
• 获取构建列表/详情要用GET请求
• 终止构建则需要用POST请求到/_apis/build/builds/{buildId}?api-version=4.1&status=2

如果你的请求方法和API要求不匹配（比如用GET去调用创建构建的接口），服务器直接就会返回405错误。

2. 检查API端点路径和版本是否正确 #

TFS2018对应的REST API版本是4.1（注意：5.0及以上版本是Azure DevOps Server的，TFS2018不支持）。确保你的请求URL格式完全正确，示例如下：

http://<你的TFS服务器地址>:8080/tfs/<集合名称>/<项目名称>/_apis/build/builds?api-version=4.1

要是路径里漏了集合/项目，或者api-version填错了，服务器可能无法识别该路径对应的合法方法，也会抛出405。

3. 验证请求的Content-Type头 #

如果是发送POST/PUT类型的请求，必须在请求头里设置Content-Type: application/json。要是没设置或者设置成了其他类型（比如multipart/form-data），服务器无法正确解析请求内容，也可能返回405错误。

4. 顺带排查权限与认证方式 #

虽然405主要是方法不允许，但偶尔也会有认证问题伪装成这个错误的情况。确保你使用的认证方式（NTLM、个人访问令牌PAT）拥有足够的权限——比如队列构建、读取/编辑构建定义的权限。

给你贴个正确的POST创建构建的curl请求示例，你可以对照着检查自己的请求：

curl -X POST \
  http://tfs-server:8080/tfs/DefaultCollection/MyProject/_apis/build/builds?api-version=4.1 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Basic <Base64编码的凭据或PAT>' \
  -d '{
    "definition": {
      "id": 123
    },
    "sourceBranch": "refs/heads/main"
  }'

你可以先从HTTP方法和API路径这两点入手排查，这两个是最容易踩坑的地方。

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