在團隊協作開發過程中，開發者經常會遇到嘗試推送（push）包含大檔案的Git倉庫時出現操作失敗的情況。典型的錯誤訊息包括：

error: RPC failed; HTTP 400 curl 22 The requested URL returned error: 400 send-pack: unexpected disconnect while reading sideband packet fatal: the remote end hung up unexpectedly

這類問題不僅影響開發效率，還可能導致團隊協作中斷。本文將系統性地分析問題根源，並提供多種實用解決方案。

問題根源分析

1. 伺服器端限制

大多數Git服務平台（GitHub、GitLab、Gitee等）對單次推送的檔案大小和整體傳輸量設有明確限制：

• GitHub: 單檔案限制通常為100MB
• GitLab: 預設單檔案限制為10MB（可調整）
• Gitee: 單檔案限制通常為50MB

2. 網路傳輸限制

• HTTP/HTTPS協議的POST緩衝區限制
• 網路不穩定導致大檔案傳輸中斷
• 客戶端記憶體不足

3. Git設計限制

Git最初設計主要針對文本檔案，對二進制大檔案支援不夠完善。

解決方案詳解

方案一：使用Git LFS（大檔案儲存）

Git LFS（Large File Storage）是官方推薦的解決方案，專門用於管理大檔案。

安裝與設定步驟：

安裝Git LFS

git lfs install

指定要追蹤的大檔案類型

git lfs track “.psd” git lfs track “.zip” git lfs track “.mp4” git lfs track “.pdf”

檢視已追蹤的檔案模式

git lfs track

提交設定檔案

git add .gitattributes git add . git commit -m “feat: 新增Git LFS支援，優化大檔案管理”

正常推送

git push origin main

適用場景：

• 頻繁需要版本控制的大型二進制檔案
• 設計資源、影片、音訊檔案
• 資料集和文件檔案

方案二：調整Git緩衝區設定

對於中等大小的檔案，可以通過調整緩衝區設定解決問題：

設定全域緩衝區大小為500MB

git config –global http.postBuffer 524288000

針對特定倉庫設定

git config http.postBuffer 524288000

啟用壓縮傳輸

git config –global core.compression 9

重新嘗試推送

git push

參數說明：

• http.postBuffer: 設定HTTP傳輸緩衝區大小
• core.compression: 設定壓縮等級（0-9）

方案三：從Git歷史中移除大檔案

如果大檔案已意外提交到歷史記錄中，需要徹底清除：

使用BFG工具清理歷史（推薦）

java -jar bfg.jar –strip-blobs-bigger-than 100M your-repo.git

或使用git filter-branch

git filter-branch –force –index-filter
‘git rm –cached –ignore-unmatch 大檔案名稱’
–prune-empty –tag-name-filter cat – –all

清理後強制推送

git push –force –all git push –force –tags

方案四：分割大檔案

對於極大的檔案，考慮分割處理：

分割檔案（每個分割檔100MB）

split -b 100m large-file.zip large-file-part.

新增所有分割檔

git add large-file-part.*

提交並推送

git commit -m “feat: 新增分割後的大檔案” git push

方案五：使用替代儲存方案

對於非程式碼相關的大檔案，建議使用專門的儲存服務：

• AWS S3: 適合靜態檔案儲存
• Google Drive/Dropbox: 團隊共享檔案
• NPM/Artifactory: 程式依賴包管理

最佳實踐建議

1. 預防性措施

設定pre-commit hook檢查檔案大小

#!/bin/sh

.git/hooks/pre-commit

maximum_size=52428800 # 50MB for file in $(git diff –cached –name-only); do file_size=$(ls -l $file | awk ‘{print $5}’) if [ $file_size -gt $maximum_size ]; then echo “錯誤: $file 超過大小限制（50MB）” echo “請使用Git LFS或移除該檔案” exit 1 fi done

2. 團隊協作規範

• 在專案文件中明確大檔案處理流程
• 使用.gitattributes統一管理LFS規則
• 定期清理歷史記錄中的大檔案

疑難排解流程

當遇到Git推送大檔案失敗時，建議按照以下流程進行排查：

• 首先檢查錯誤訊息類型
• 識別問題是網路相關還是檔案大小相關
• 根據具體情況選擇合適的解決方案
• 優先嘗試調整緩衝區設定，如無效再使用Git LFS

結論

處理Git大檔案推送問題需要根據具體情況選擇合適的解決方案。對於長期專案，建議優先採用Git LFS建立標準化的大檔案管理流程。對於臨時性問題，調整緩衝區設定或清理歷史記錄可能是更快捷的解決方式。

通過實施本文介紹的解決方案和最佳實踐，團隊可以顯著減少因大檔案導致的協作障礙，提升開發效率。