Cloudbuild执行yarn install拉取GitHub私有包时报无法读取用户名错误

常见根因排查方向 #

虽然你已确认stats-module与其他私有包权限一致，但以下容易忽略的场景会导致仅新增包触发报错：

• CI的包缓存机制：已安装过的3个私有包会命中CI的yarn缓存，构建时不会重新发起GitHub拉取请求，只有新增的stats-module需要实时拉取，实际是CI环境全局的GitHub拉取凭证配置缺失。你可以清空CI的yarn缓存后重新构建，若原有3个包也报相同错误即可验证该问题。
• 元信息拉取逻辑差异：不管用tag还是SHA引用git依赖，部分yarn版本拉取新包时会先调用GitHub API获取仓库元信息，该请求若未携带配置的凭证就会触发权限报错。
• 路径大小写不匹配：检查package.json中stats-module的仓库路径大小写是否与GitHub上实际路径完全一致，git本身大小写不敏感，但CI的凭证匹配逻辑大多大小写敏感，路径不一致会导致凭证无法正常携带。

可落地解决方法 #

• 配置全局git凭证自动注入：在CI执行yarn install前，提前执行如下命令（需提前在CI环境变量中配置有权限的GitHub个人访问token，变量名示例为GH_TOKEN）：

git config --global url."https://${GH_TOKEN}@github.com/".insteadOf "https://github.com/"

该规则会自动给所有GitHub HTTPS请求注入凭证，避免触发用户名输入提示。

• 更换为SSH格式依赖引用：将所有私有git依赖的引用格式改为SSH，示例：git+ssh://git@github.com/MyCorp/stats-module#v0.0.2，同时给CI配置对应仓库的SSH deploy key，该方案稳定性高于HTTPS协议。
• Yarn v2+版本专属配置：若使用Yarn 2及以上版本，可在.yarnrc.yml中直接配置githubToken字段，值为CI环境的GitHub访问token即可。

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