gitlab-protocols配置不生效是因为仅作用于无协议前缀的GitLab域名请求，且需Composer 2.2+、全局设置、数组格式（如["https"]），若URL已含https://或git@则完全忽略该配置。
gitlab-protocols 配置不生效？先确认 Composer 版本和作用域
Composer 2.2+ 才支持 gitlab-protocols 这个配置项，低于该版本会直接忽略它。它只影响「未显式指定协议的 GitLab 域名请求」，比如你在 repositories 里写的是 "url": "gitlab.example.com/group/pkg.git"（缺协议），Composer 才会查这个配置；如果写了 https:// 或 git@，它就完全不参与决策。
该配置是全局级的，必须用 composer config -g 设置，不能写在项目级 composer.json 里：
composer config -g gitlab-protocols '["https"]'
注意：gitlab-protocols 是数组，不是字符串；值只能是 "https" 或 "ssh"，不能混写或加空格。
为什么设了 gitlab-protocols 还走 SSH？
最常见原因是 URL 本身已带协议前缀。Composer 不会重写你明确写的协议，哪怕和 gitlab-protocols 冲突。例如：
-
"url": "git@gitlab.example.com:group/pkg.git"→ 强制走 SSH，无视配置 -
"url": "https://gitlab.example.com/group/pkg.git"→ 强制走 HTTPS，无视配置 -
"url": "gitlab.example.com/group/pkg.git"→ 才会读gitlab-protocols并选第一个可用协议
企业内网禁 SSH 时，别依赖这个配置去“纠正” URL，而是直接在 repositories 中统一写死 https:// 开头的地址——更可控、更易审计。
HTTPS 协议下认证失败：oauth2 用户名和域名必须严格匹配
即使 gitlab-protocols 指向 HTTPS，auth.json 里的域名也必须和仓库 URL 的 host 完全一致，包括端口（如 :8443）和子路径（如 /gitlab）。否则 Composer 会跳过认证，报 401 Unauthorized 或 Could not fetch。
用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
auth.json 正确写法示例（Linux/macOS）：
{
"http-basic": {
"gitlab.example.com": {
"username": "oauth2",
"password": "glpat-xxxxxxxxxxxxxxxxxxxx"
}
}
}
关键点：
-
username必须是oauth2，不是你的 GitLab 账号名 - host 键名不能带
https://或路径，只留域名或域名+端口 - 文件权限必须是
600（chmod 600 ~/.composer/auth.json）
CI/CD 环境中别依赖 gitlab-protocols，改用 COMPOSER_AUTH
GitLab CI、GitHub Actions 等环境通常不允许修改全局 auth.json，且 gitlab-protocols 在容器中容易因缓存失效。此时应绕过协议配置，直接注入凭证：
export COMPOSER_AUTH='{"http-basic":{"gitlab.example.com":{"username":"oauth2","password":"'$GITLAB_TOKEN'"}}}'
注意：
-
COMPOSER_AUTH是 JSON 字符串，需正确转义双引号 - 变量
$GITLAB_TOKEN应来自 CI secret，不能硬编码 - 该方式优先级高于
auth.json和gitlab-protocols，适合临时覆盖
真正容易被忽略的是：GitLab 实例若启用了自签名证书或内部 CA，secure-http: false 必须在项目级 composer.json 的 config 段显式关闭，否则 HTTPS 请求会因证书校验失败而中断——这个设置不会被 gitlab-protocols 影响，也常被遗漏。
