Bitbucket API创建PR请求出现504网关超时问题求助

近期确实有不少Bitbucket免费版用户反馈遇到了相同问题：通过UI可以正常创建Pull Request，但调用官方API发起请求时会返回504网关超时错误。

可能的原因 #

• Bitbucket免费版对API请求的资源优先级低于UI操作，在平台资源紧张或高峰时段，API请求更容易被限流或超时
• 该问题属于平台侧临时资源分配异常，并非请求本身格式错误（已通过UI操作验证）

临时解决方案 #

• 增加重试机制：采用指数退避策略多次发起请求，避开临时的资源拥堵
• 错峰请求：避开工作日的上午9-11点、下午2-4点等流量高峰时段发起API调用
• 确认请求头：确保请求携带Content-Type: application/json头，虽然UI正常大概率已设置，但可再次验证
• 简化请求体：当前请求体已是创建PR的最简结构，无需额外修改

测试用示例命令 #

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://api.bitbucket.org/2.0/repositories/{workspace}/{repo-slug}/pullrequests \
  -d '{
    "title": "Staging merge to Release Candidate",
    "source": {
      "branch": {
        "name": "staging"
      }
    },
    "destination": {
      "branch": {
        "name": "release-candidate"
      }
    }
  }'

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