GIT push 大文件提示 413-Go服务器开发

好的，这是一个非常常见的问题。当您 git push 大文件时遇到 HTTP 413 错误，原因和解决方案与普通 Web 请求的 413 略有不同。

核心原因： 您的 Git 远程仓库（如 GitLab, Gitee, 或自建的 GitWeb服务（Nginx/Apache））所在的服务器，其 Web 服务器（通常是 Nginx）设置了 client_max_body_size，并且您推送的数据包超过了这个限制。

整个流程是：git push -> HTTP(S) 请求 -> Web 服务器（Nginx）-> Git 后端服务。错误发生在 Nginx 这一层。

以下是针对不同情况的详细解决方案：

方案一：如果远程仓库是您自己搭建的（你有服务器权限）

这是最根本的解决方法，需要修改服务器上 Nginx（或Apache）的配置。

1. 修改 Nginx 配置 (最常见)

找到您的 Git 服务的 Nginx 配置文件。例如，对于 GitLab，文件通常位于 /etc/nginx/conf.d/gitlab.conf 或 /etc/nginx/sites-enabled/gitlab。
在处理 Git HTTP 请求的 location 块中，增加或修改 client_max_body_size：

# 示例：GitLab 的典型配置
server {
    listen 80;
    server_name your-git-domain.com;

    # 这行是关键！设置允许的最大客户端请求体大小。0表示无限制。
    client_max_body_size 0; # 或者设置为一个足够大的值，如 100m, 512m, 1024m

    location / {
        proxy_pass http://gitlab-workhorse;
        # ... other configurations ...
    }
}

保存文件后，重新加载 Nginx 配置使其生效：

sudo nginx -s reload
# 或者
sudo systemctl reload nginx

2. （不常用）修改 Apache配置 如果使用的是 Apache，找到配置文件并修改 LimitRequestBody：

<VirtualHost *:80>
    ServerName your-git-domain.com
    # ...

    # 设置最大请求体大小，单位是字节
    LimitRequestBody 1073741824 # 1GB

    # ...
</VirtualHost>

重启 Apache 服务。

###方案二：如果使用的是第三方 Git服务（如 GitLab.com, Gitee.com）

你无法修改服务器配置，但通常这些平台本身就支持大文件，只是默认限制较小或有特殊要求。

**1. 使用 Git LFS (Large File Storage) - 【强烈推荐】** 这是管理Git中大文件的标准且最佳的做法。LFS会将大文件存储在单独的地方，而在仓库中只保留指针文件，从而避免推送大量数据。

安装 Git LFS:

  # macOS (Homebrew)
  brew install git-lfs


  # Ubuntu/Debian
  sudo apt-get install git-lfs


  # Windows (Chocolatey)
  choco install git-lfs

在项目仓库中启用 LFS:

  cd /your/repository/directory
  git lfs install

指定要用 LFS跟踪的文件类型（例如跟踪所有 .psd文件和超过50MB的文件）:

  git lfs track "*.psd"
  git lfs track "*.zip"
  # 或者根据大小追踪 (需要较新版本)
  # git lfs track --size=50M

确保 .gitattributes文件被提交:

  git add .gitattributes
  git commit -m "Start tracking large files with LFS"

像往常一样添加和提交你的大文件，然后推送。LFS会自动处理它们。
```
  git add huge_file.psd
  git commit -m "Add huge design file"
  git push origin main
```

2. 【临时补救措施】拆分提交 如果只是一个意外的大文件，并且你不想用LFS：

使用 git reset HEAD^回退到上一次提交。
将大文件从工作区删除或添加到 .gitignore。
再次提交并推送。
之后再用其他方式（如scp, sftp, oss）传输这个大文件。

###方案三：检查其他中间件

有时除了主要的Web服务器，还可能存在反向代理、负载均衡器或WAF（Web应用防火墙），它们也可能有各自的请求大小限制。如果有权限，需要一并检查这些中间件的配置。

###总结与操作顺序

No	Scenario	Recommended Solution
✅	Self-hosted Git Server	Modify `client_max_body_size` in Nginx/Apache config on the server.
✅	Third-party Git Service (GitLab/Gitee)	Use Git LFS. This is the modern and correct way to handle large files.
⚠️	One-time accident, quick fix	Reset the commit, remove the large file, and push again.