Bitbucket Pipelines自动创建PR遇阻：无pipelines用户密码

你的需求完全可行！别纠结bitbucket-pipelines这个用户的密码问题——Bitbucket不会提供这个内置服务账号的登录密码，它本来就是Pipelines运行时专用的，没法直接用密码调用API。不过咱们有更安全靠谱的方式来实现自动创建PR，下面一步步来：

第一步：创建专用的访问凭证 #

你需要先在Bitbucket里生成一个有足够权限的凭证，用来代替密码调用API：

• 如果是个人仓库，去你的个人设置里找「App passwords」，新建一个，勾选pull requests:write和repositories:read这两个核心权限（根据实际需求可补充其他权限）。
• 如果是团队/工作区的仓库，更推荐用Repository Access Token：进入仓库设置页面，找到「Access tokens」，新建一个token，给它分配Pull request write权限即可。
  创建好凭证后，把它存在Pipelines的环境变量里（比如命名为BITBUCKET_PR_TOKEN），记得勾选「Secured」选项，这样凭证不会明文显示在日志里。

第二步：编写Pipelines步骤调用API #

在bitbucket-pipelines.yml里添加一个发布阶段的步骤，用curl调用Bitbucket的Pull Request REST API即可。这里分两种凭证类型给出示例：

用App Password的配置示例 #

pipelines:
  branches:
    develop:
      - step:
          name: 自动创建develop到master的PR
          trigger: manual # 可改为自动触发，或保留手动按需执行
          script:
            - |
              curl -X POST "https://api.bitbucket.org/2.0/repositories/${BITBUCKET_WORKSPACE}/${BITBUCKET_REPO_SLUG}/pullrequests" \
                -u "${BITBUCKET_USERNAME}:${BITBUCKET_PR_TOKEN}" \
                -H "Content-Type: application/json" \
                -d '{
                  "title": "[自动创建] develop合并到master",
                  "source": {
                    "branch": {
                      "name": "develop"
                    }
                  },
                  "destination": {
                    "branch": {
                      "name": "master"
                    }
                  },
                  "description": "此PR由Bitbucket Pipelines自动创建，属于发布流程的一部分"
                }'

（注：BITBUCKET_USERNAME是你创建App Password的Bitbucket账号用户名，也要存在加密环境变量里）

用Repository Access Token的配置示例 #

pipelines:
  branches:
    develop:
      - step:
          name: 自动创建develop到master的PR
          trigger: manual
          script:
            - |
              curl -X POST "https://api.bitbucket.org/2.0/repositories/${BITBUCKET_WORKSPACE}/${BITBUCKET_REPO_SLUG}/pullrequests" \
                -u "token:${BITBUCKET_PR_TOKEN}" \
                -H "Content-Type: application/json" \
                -d '{
                  "title": "[自动创建] develop合并到master",
                  "source": {
                    "branch": {
                      "name": "develop"
                    }
                  },
                  "destination": {
                    "branch": {
                      "name": "master"
                    }
                  },
                  "description": "此PR由Bitbucket Pipelines自动创建，属于发布流程的一部分"
                }'

上面的${BITBUCKET_WORKSPACE}和${BITBUCKET_REPO_SLUG}是Pipelines自带的环境变量，会自动填充你的工作区和仓库名，不用手动写死。

第三步：避坑提示 #

如果调用API时遇到403错误，先检查这两点：

1. 凭证的权限是否勾选正确——至少要能读写Pull Request，以及访问目标仓库的权限；
2. 环境变量里的凭证值是否正确，有没有复制时多了空格或漏了字符。

另外补充两个小建议：

• 绝对不要把凭证硬编码在配置文件里，一定要用Pipelines的加密环境变量，避免泄露；
• 触发条件可以灵活调整：比如只有当develop分支打了发布标签时才自动触发，或者保留手动触发，避免每次develop提交都创建PR。

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