切换至HTTP后TeamCity 'SSH with pull request' 错误仍未消失

问题背景 #

TeamCity的Pull Request功能不支持通过SSH密钥认证拉取PR信息，必须使用访问令牌（access token）。即使将VCS克隆协议切换为HTTP/HTTPS后，若系统残留旧的SSH认证配置，仍会触发以下报错：

Failure to obtain pull request provider;
Exception: jetbrains.buildServer.pullRequests.PullRequestRetrievalException: Using SSH key authentication method to extract pull request information is impossible. Please provide an access token

解决步骤 #

• 检查并修正VCS根的认证配置

  1. 进入对应项目的VCS设置页面，找到关联的VCS根
  2. 确认当前协议为HTTP/HTTPS，且认证方式已设置为访问令牌（彻底移除SSH密钥相关配置）
  3. 排查是否存在其他关联的VCS根仍使用SSH认证，一并修正

• 清理PR相关缓存

  1. 进入TeamCity后台的「Administration」→「Diagnostics」→「Caches」
  2. 定位到Pull Request相关缓存项（如pullRequests前缀的缓存），执行清理操作
  3. 重启TeamCity服务，确保配置变更完全生效

• 验证PR配置有效性

  1. 进入VCS根的「Pull Requests」设置页
  2. 确认PR提供者（如GitHub、GitLab）的认证方式已切换为HTTP+访问令牌
  3. 点击「Test Connection」验证连接是否正常，确认PR信息可正常拉取

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