Jenkins Blue Ocean配置Bitbucket Cloud流水线能否用App password认证

连接兼容性结论 #

Bitbucket Cloud切换为App Password强制认证机制后，稳定版Jenkins Blue Ocean（配套Bitbucket集成插件版本2.2.0及以上）完全支持正常连接Bitbucket Cloud，不存在官方层面的功能故障。

凭证认证失败常见原因 #

尝试全量凭证组合仍连接失败，基本是踩了以下几个高频坑：

• 认证用户名填写错误：Bitbucket Cloud App Password认证接口不接受邮箱作为用户名传参，也不支持个人资料页的显示名作为用户名，正确的用户名是Bitbucket账户的唯一ID，也就是仓库访问地址中bitbucket.org/后、仓库名前的那段全小写字符串，90%以上的连接失败都是这个原因导致的。
• App Password权限勾选不符合插件校验规则：即使创建时勾选了全权限，旧版Blue Ocean的校验逻辑无法识别泛化的全选授权，必须手动单独勾选Repositories: Read/Write、Webhooks: Read/Write、Account: Read三个细分权限，才能通过插件的权限校验。
• 误用账号登录密码：Bitbucket Cloud已经全面封禁了账号登录密码的API调用权限，所有API场景下填登录密码都会直接返回401认证失败，不存在任何绕过可能。

快速排障步骤 #

1. 登录Bitbucket Cloud个人设置页，进入App Password管理界面，重新生成专用App Password，手动勾选上述三个细分权限，生成后立刻复制保存，关闭页面后无法再次查看。
2. 回到Jenkins Blue Ocean新建流水线页面，Bitbucket Cloud认证项的用户名填写Bitbucket小写账户ID，密码字段填写刚生成的App Password，不要填写邮箱、不要填账号登录密码。
3. 如果仍提示连接失败，先将Jenkins插件管理中的Bitbucket Plugin升级到最新稳定版，重启Jenkins后再重试，2.0版本以下的Bitbucket插件未适配新的App Password校验规则，会出现凭证正确也认证失败的问题。

迁移建议 #

完全不需要因为这个连接问题将代码迁移到GitHub：

• 按上述步骤配置完成后，Blue Ocean和Bitbucket Cloud的集成支持自动创建webhook、分支触发、PR状态回写等全量功能，和GitHub集成体验没有本质差异。
• 如果不想反复调试App Password配置，也可以直接配置SSH密钥作为代码拉取凭证，绕开HTTP层的App Password认证逻辑，一样可以正常在Blue Ocean中运行Docker流水线。

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