Git LFS文件已成功上传但仍触发‘文件过大’错误求助

以下是几种可能的原因和对应的解决步骤：

• 清理历史中的原始大文件记录
  如果在启用Git LFS之前，你已经用普通git add提交过这个大文件，仓库的历史记录里会保留原始文件的快照，即使后来用LFS追踪，推送时Git还是会检查历史里的文件大小。解决步骤：

  1. 撤销最近的提交：git reset HEAD~1
  2. 使用git filter-repo移除历史中的目标大文件：

     git filter-repo --path path/to/large/file --invert-paths
     

  3. 重新执行LFS相关操作：

     git lfs track "path/to/large/file"
     git add .gitattributes path/to/large/file
     git commit -m "Add large file via LFS"
     git push
     

• 确保.gitattributes文件被正确提交
  若只提交了大文件而忽略了.gitattributes，Git无法识别LFS追踪规则，会按普通文件处理。执行git add .gitattributes后再重新提交、推送。

• 验证LFS配置有效性
  执行git lfs env查看当前LFS配置，确认filter.lfs.process、filter.lfs.smudge等关键配置项存在且正常。如果配置异常，重新执行：

  git lfs install --local  # 仓库级安装，优先推荐
  

  或全局安装：git lfs install --global

• 确认文件已被LFS正确追踪
  执行git lfs ls-files，若输出中包含目标文件，说明追踪生效；若未出现，重新执行git lfs track "path/to/large/file"，再添加文件到提交。

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