Gitlab CI Deploy Token无法推送至仓库，认证失败问题求助

常见原因及排查步骤 #

1. 确认Deploy Token权限与操作匹配 #

即便勾选了所有权限，也要针对性核对：

• 若需推送代码，必须启用write_repository权限（不能是只读权限）
• 若涉及拉取私有依赖，需确认read_registry或对应仓库的读取权限已开启

2. 检查CI中Git地址的认证格式 #

Deploy Token仅支持HTTPS地址，需将凭证嵌入URL：

git clone https://<deploy-token-用户名>:<deploy-token-密码>@gitlab.com/你的群组/你的仓库.git

注意：如果密码包含@、!这类特殊字符，要做URL编码（比如@转成%40）

3. 验证CI变量配置 #

• 确保在项目的Settings > CI/CD > Variables中添加了DEPLOY_TOKEN_USER和DEPLOY_TOKEN_PASS变量，若分支非受保护分支，不要勾选Protect variable
• 勾选变量的Mask variable选项，避免密码在日志中泄露

4. 核对Git仓库URL正确性 #

检查CI脚本里的仓库地址是否和项目的HTTPS地址完全一致，比如是否多/少了路径，或是域名错误（比如误用gitlab.io而非gitlab.com）

5. 确认Deploy Token绑定的项目 #

生成Deploy Token时要选当前操作的GitLab项目，若用群组级Token，需确保项目已继承群组权限

6. 排查自托管Runner的网络问题 #

如果是自己部署的Runner，检查是否能正常访问GitLab服务器，有没有防火墙或代理拦截了HTTPS请求，导致认证请求无法发送

快速调试命令 #

在CI脚本中添加以下命令，获取更具体的错误信息：

# 配置Git凭证并测试连接
git config --global credential.helper store
echo "https://${DEPLOY_TOKEN_USER}:${DEPLOY_TOKEN_PASS}@gitlab.com" > ~/.git-credentials
git ls-remote https://gitlab.com/你的群组/你的仓库.git

git ls-remote的输出会直接暴露认证失败的具体原因，帮助快速定位问题

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