执行git push --tags失败（子模块问题）：如何定位异常标签？

安全阿岳

2026-8-3

定位导致git push --tags报错的异常标签

问题分析

报错提示子模块packages/jpl存在远程找不到的变更，单个标签推送正常但批量推送失败，说明某个标签指向的提交中，子模块packages/jpl的引用SHA不存在于该子模块的远程仓库。

快捷定位方法

直接批量检查子模块SHA有效性

无需逐个推送，通过以下命令快速找出异常标签：

先获取子模块packages/jpl的远程仓库地址：

subremote=$(git config --file .gitmodules submodule.packages/jpl.url)

遍历所有标签，检查对应子模块SHA是否存在于远程：

git for-each-ref --format='%(refname:short) %(objectname)' refs/tags | while read tag commit; do
  # 提取当前标签提交中，子模块packages/jpl的SHA值
  subsha=$(git ls-tree -d $commit packages/jpl | awk '{print $3}')
  # 检查该SHA是否在子模块远程仓库存在
  if ! git ls-remote "$subremote" "$subsha" >/dev/null 2>&1; then
    echo "异常标签：$tag（对应子模块SHA $subsha 未在远程仓库找到）"
  fi
done

执行后会直接输出所有触发报错的标签，比逐个推送效率高得多。

分步排查（可选）

如果需要保留中间结果，可以先导出所有标签与子模块SHA的对应关系：

git for-each-ref --format='%(refname:short) %(objectname)' refs/tags | while read tag commit; do
  subsha=$(git ls-tree -d $commit packages/jpl | awk '{print $3}')
  echo "$tag $subsha"
done > tag-submodule-shas.txt

再逐一检查文件中的SHA：

subremote=$(git config --file .gitmodules submodule.packages/jpl.url)
while read tag subsha; do
  if ! git ls-remote "$subremote" "$subsha" >/dev/null 2>&1; then
    echo "异常标签：$tag"
  fi
done < tag-submodule-shas.txt