CircleCI构建失败：克隆仓库报错repository not found

一、修复镜像依赖问题 #

• 更换官方预安装git和SSH的镜像：选用CircleCI官方维护的基础镜像（如cimg/base:stable）或对应语言的专用镜像（如cimg/python:3.11），这类镜像默认包含完整的git与SSH环境，可避免fallback到原生客户端引发的兼容问题。
• 若需使用自定义镜像，在config.yml的初始化阶段手动安装依赖：

  steps:
    - run:
        name: 安装git和SSH依赖
        command: |
          # 适用于Debian/Ubuntu系列镜像
          apt-get update && apt-get install -y git openssh-client
          # 若为RHEL/CentOS系列镜像，替换为以下命令
          # yum install -y git openssh-clients -y
  

二、排查仓库访问权限与地址 #

• 验证仓库地址准确性：检查CircleCI项目配置中的仓库URL是否拼写无误，SSH地址需为git@<平台域名>:<账户>/<仓库名>.git格式，HTTPS地址需包含完整的仓库路径。
• 配置合法的访问凭证：
  • SSH方式：在CircleCI项目设置的「SSH Keys」中添加部署密钥，同时将公钥添加到代码托管平台（GitHub/GitLab等）的仓库权限设置里，确保密钥拥有仓库读取权限。
  • HTTPS方式：在CircleCI环境变量中配置对应平台的访问令牌（如GitHub的GITHUB_TOKEN），令牌需具备仓库读取权限。

三、确认项目关联状态 #

检查CircleCI控制台中的项目是否关联了正确的仓库，确保仓库所属的组织/账户已授权CircleCI访问，且仓库在代码托管平台上处于可访问状态（未被删除、设为私有但未授权等）。

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