合并含LFS对象的Git子模块到主仓库时遇LFS对象缺失问题

问题分析 #

合并子模块到主仓库过程中，git filter-repo迁移子模块文件时可能破坏了LFS对象的追踪关联，导致本地提交引用了不存在的LFS对象，推送时触发错误。

解决方案步骤 #

1. 定位缺失对象的引用来源 #

• 查找哪个提交引用了该LFS对象：

  git log --all --grep="65cbf95fd1c7984cc8aca10ef81901e59e5bd42e05d177d1f7b6c95237a20b49"
  

• 检查仓库中是否存在悬空的LFS引用：

  git fsck --full --unreachable
  

• 查看子模块仓库filter-repo后的LFS状态：

  git lfs migrate info --everything
  

2. 重新处理子模块仓库（核心修复步骤） #

如果是filter-repo过程中丢失了LFS关联，重新执行迁移：

• 克隆干净的子模块仓库，拉取所有LFS对象：

  git clone <submodule-repo-url>
  cd <submodule-repo>
  git lfs fetch --all
  

• 将所有文件迁移到submodule目录，确保LFS追踪保留：

  git filter-repo --to-subdirectory-filter submodule
  

• 验证迁移后的LFS状态，确认所有图片都在追踪列表中：

  git lfs ls-files
  

3. 重新合并到主仓库 #

• 在主仓库的submodule-merge分支中，移除旧的子模块远程：

  git remote remove submodule-origin
  

• 添加重新处理后的子模块仓库远程：

  git remote add submodule-origin /path/to/processed-submodule-repo
  

• 拉取并合并代码：

  git fetch submodule-origin main
  git merge submodule-origin/main --allow-unrelated-histories
  

• 提交后检查LFS状态：

  git lfs status
  

4. 手动补全缺失对象（备用方案） #

如果上述步骤无效，尝试手动推送缺失的LFS对象：

• 在子模块仓库中搜索包含该对象的提交：

  git log --all --objects | grep 65cbf95f
  

• 拉取对应提交的LFS对象：

  git lfs pull --include="sub_image.jpg" <找到的提交哈希>
  

• 将对象复制到主仓库的LFS存储目录（路径格式为.git/lfs/objects/前两位/中间两位/剩余部分），例如：

  cp /path/to/submodule-repo/.git/lfs/objects/65/cb/65cbf95fd1c7984cc8aca10ef81901e59e5bd42e05d177d1f7b6c95237a20b49 /path/to/main-repo/.git/lfs/objects/65/cb/
  

• 强制推送该对象到远程：

  git lfs push --object-id origin 65cbf95fd1c7984cc8aca10ef81901e59e5bd42e05d177d1f7b6c95237a20b49
  

5. 最终推送验证 #

• 确保本地所有LFS对象完整：

  git lfs fetch --all
  

• 推送分支到远程：

  git push origin submodule-merge
  

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