CI/CD流水线Git推送报错src refspec不匹配，本地脚本正常

问题根源 #

本地运行脚本正常，但CI流水线报错src refspec upstream-branch does not match any，本质是CI环境的临时仓库里没有upstream-branch这个本地分支。本地环境因为之前操作过，可能已经存在该分支或当前分支就是它，但CI每次都是全新拉取代码，分支状态和本地完全不同。

修复方案 #

方案1：直接推送当前HEAD到远程分支（推荐） #

修改push命令，跳过本地分支名称的依赖，直接把当前代码推送到远程的upstream-branch：

git push -f upstream HEAD:upstream-branch

不管CI环境里的本地分支叫什么（比如main、master或流水线指定的分支），这个命令都能把当前提交推送到目标远程分支，彻底规避分支名称不匹配的问题。

方案2：先创建本地分支再操作 #

如果要保留原merge逻辑，需要先从远程拉取并创建本地upstream-branch分支，再执行合并：

git remote add upstream 'https://example.com/foobar.git'
git fetch upstream
# 创建并切换到本地upstream-branch分支，关联远程分支
git checkout -b upstream-branch upstream/upstream-branch
# 合并你的本地分支（替换成CI中实际使用的分支名，比如main）
git merge --allow-unrelated-histories --strategy-option ours main
git push -f upstream upstream-branch
git remote remove upstream

方案3：检查CI环境配置 #

• 确认CI拉取代码时是完整克隆，不要用浅克隆（--depth 1参数），浅克隆会丢失分支引用信息，导致fetch后无法识别远程分支。
• 顺带检查CI的仓库权限，确保用于推送的账号/token有上游仓库的写入权限（虽然当前报错不是权限问题，但权限异常偶尔会有类似表现）。

内容的提问来源于stack exchange，提问作者Mr.Mountain