GitLab拉取镜像失败：创建分支提示无效引用名

在将GitHub仓库镜像到GitLab并拉取镜像时，出现如下错误：

Error: Failed to create branch 'foo/bar/feature-xy': invalid reference name '<commit_sha>'.

可以按以下步骤排查解决：

• 检查分支命名合规性：Git分支名不允许包含空格、@、*、\这类特殊字符，也不能以.开头或结尾。仔细确认foo/bar/feature-xy是否存在违规字符，甚至是肉眼难以察觉的不可见字符。
• 验证提交哈希的有效性：确保<commit_sha>是完整有效的Git提交哈希（通常40位，短哈希至少7位），复制粘贴时别带多余空格或符号。
• 手动创建分支同步：如果自动镜像工具出问题，直接在GitLab仓库手动执行命令：

  git fetch origin
  git checkout -b foo/bar/feature-xy <commit_sha>
  git push origin foo/bar/feature-xy
  

• 排查镜像工具配置：如果用的是GitLab自带镜像功能或第三方脚本，检查配置里的分支过滤、SHA处理逻辑，看是不是误把SHA当成分支名处理，或者分支路径转义出了问题。
• 清理本地Git缓存：要是本地操作引发的问题，先清理缓存再重新同步：

  git gc --prune=now
  git fetch --prune
  

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