如何在GitLab仓库的特定日期范围内删除Git LFS对象？

核心问题排查 #

你按官方文档操作后存储空间未降低，大概率是以下原因：

• 仅修改了代码历史，但未彻底清理对应的LFS对象
• 日期范围筛选逻辑错误，导致目标文件未被移除
• 未触发GitLab后台的存储回收流程

分步解决流程 #

1. 克隆裸仓库（安全修改历史） #

首先克隆仓库的裸版本，避免影响本地工作副本：

git clone --bare git@gitlab.com:<你的用户名>/<仓库名>.git
cd <仓库名>.git

2. 准确定位目标LFS文件的提交 #

先确认Git LFS追踪的文件类型，再筛选指定日期范围内的相关提交：

# 查看所有被LFS追踪的文件模式
git lfs track

# 筛选2024-01-01至2024-02-01期间修改了LFS追踪文件的提交（替换成你的日期）
git log --since="2024-01-01" --until="2024-02-01" --diff-filter=M --name-only | grep -f <(git lfs track | awk '{print $2}' | sed 's/\*//')

验证输出的文件是否是你要删除的目标，确保日期和文件范围正确。

3. 移除指定日期范围的LFS文件历史 #

使用git filter-repo（Git 2.22+推荐工具，替代旧的filter-branch）移除目标文件在指定日期内的历史记录：

# 示例：删除2024-01-01至2024-02-01期间所有.zip格式的LFS文件（替换成你的文件格式和日期）
git filter-repo --path-glob '*.zip' --since '2024-01-01' --until '2024-02-01' --invert-paths

• --path-glob：匹配要删除的文件类型
• --since/--until：限定日期范围
• --invert-paths：保留除目标内容外的所有历史，即删除指定范围内的目标文件

4. 清理本地LFS对象 #

删除本地仓库中无引用的LFS对象：

git lfs prune

5. 强制推送修改后的历史 #

因为修改了仓库历史，必须强制推送覆盖远程：

git push --force

⚠️ 重要：提前通知所有仓库协作者，让他们丢弃本地旧仓库，重新克隆新的仓库版本，避免历史冲突。

6. 触发GitLab存储回收 #

登录GitLab仓库页面，进入设置 > 仓库 > 清理存储，点击「立即清理」按钮。GitLab不会自动回收已删除的对象，必须手动触发此操作，存储空间通常会在几小时内更新。

注意事项 #

• 确保已安装git filter-repo，如果没有，可通过包管理器（如apt install git-filter-repo或brew install git-filter-repo）安装
• 操作前务必备份仓库，避免误删重要历史
• 如果清理后存储空间仍未更新，检查GitLab的「清理存储」是否执行成功，或等待12小时后再查看（部分情况下存在延迟）

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