GitLab项目导出未完成链接即过期 大仓库导出及瘦身方案咨询

一、导出文件无法下载问题处理 #

• 先确认导出任务状态：进入项目的导出任务管理页查看任务进度，若状态为「运行中」不要重复触发导出任务，避免重复排队导致耗时进一步拉长；若状态显示「失败」，可查看失败原因，若提示存储空间不足，可先申请临时扩容项目存储空间后重新触发导出。
• 针对超时失效问题：如果确认是导出耗时超过24小时导致链接失效，私有部署版本可联系GitLab管理员直接从后台服务器导出临时生成的打包文件，无需等待前端下载链接生成；SaaS版本可提交平台工单，申请协助延长下载链接有效期或直接获取导出文件。
• 临时提速技巧：导出前可先删除当前分支中无需保留的大文件（已确认无用途的tar包等），减少打包扫描的文件体积，缩短导出耗时。

二、仓库体积缩减实操方案 #

• 本地清理历史大文件：先拉取仓库裸仓到本地，执行git filter-repo --path-glob '*.tar' --invert-paths命令，批量删除所有历史提交记录中的tar格式文件，操作完成后本地仓库体积会大幅下降。注意该操作会改写所有涉及大文件的提交哈希，操作前需做好仓库备份，所有协作者后续需重新拉取新仓库，禁止推送旧分支内容。
• 同步清理服务端冗余数据：将清理后的本地裸仓强制推送回远程仓库后，联系GitLab管理员手动触发仓库垃圾回收、清理悬空对象，服务端存储的仓库体积才会正式缩减。
• 长期防护配置：在仓库根目录的.gitignore文件中添加*.tar规则，禁止提交tar格式的制品包到代码仓，大体积二进制文件统一存储到专用制品仓库，避免后续再次出现仓库体积异常膨胀的问题。

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