GitLab仓库镜像GitHub失败：LFS管理大文件推送报错求助

一、修复GitLab默认镜像功能 #

核心问题 #

GitLab默认镜像功能默认不会同步LFS对象，导致GitHub收到的是大文件本体而非LFS指针，触发GitHub的文件大小限制。

解决步骤 #

1. 进入GitLab目标项目的「设置」→「仓库」→「镜像仓库」
2. 找到已配置的GitHub镜像条目，点击「编辑」按钮
3. 勾选**「Mirror LFS objects」**选项，保存设置
4. 手动触发一次镜像同步（点击镜像条目旁的「同步」按钮）

额外排查点 #

• 确认GitHub仓库已启用Git LFS（GitHub当前默认支持，无需额外配置，旧仓库可手动执行git lfs install初始化）
• 检查本地.gitattributes的路径规则是否准确，比如path/*.pptx是否与实际文件路径完全匹配（注意大小写、相对路径）

如果上述操作后仍失败，可手动同步LFS对象：

1. 本地克隆GitLab仓库，确保已安装Git LFS并执行git lfs install
2. 拉取所有LFS对象：git lfs fetch --all
3. 添加GitHub作为远程仓库：git remote add github https://github.com/username/repo.git
4. 推送LFS对象到GitHub：git lfs push github --all
5. 推送代码分支：git push github master

二、用GitLab CI/CD实现实时同步 #

如果默认镜像功能无法使用，可通过CI/CD流水线实现代码和LFS对象的自动同步：

1. 创建CI/CD配置文件 #

在仓库根目录新建.gitlab-ci.yml，内容如下：

sync-to-github:
  image: alpine/git:latest
  before_script:
    - apk add git-lfs
    - git lfs install --skip-repo
    - git config --global user.name "GitLab CI Bot"
    - git config --global user.email "ci-bot@your-domain.com"
    # 配置GitHub远程仓库，使用CI变量存储令牌
    - git remote add github https://${GITHUB_TOKEN}@github.com/username/repo.git
  script:
    - git lfs fetch --all origin
    - git lfs push github --all
    - git push github --all --tags
  only:
    - master  # 按需指定需要同步的分支
    - tags    # 同步标签

2. 配置CI变量 #

1. 进入GitLab项目的「设置」→「CI/CD」→「变量」
2. 添加名为GITHUB_TOKEN的变量，值为GitHub的个人访问令牌（需具备仓库推送权限）
3. 勾选「保护变量」和「掩码变量」，避免令牌泄露

3. 验证流水线 #

提交.gitlab-ci.yml到GitLab后，流水线会自动触发，同步代码和LFS对象到GitHub。后续分支推送或标签创建时，流水线会自动执行同步。

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