记一个gitea推送失败的问题
内容提要
该文章记录了Gitea推送失败的问题及解决方法。推送时请求体约2.95 MiB，超过Git默认1 MiB的http.postBuffer，导致使用chunked传输，而Traefik/Gitea链路未正确处理，引发错误。通过调大postBuffer至16 MiB并指定HTTP/1.1解决。作者分享了配置方法，并感慨排查问题的乐趣。
延伸解读
问题根源：HTTP缓冲区与分块传输
推送失败的直接原因是请求体约2.95 MiB，超过Git默认的1 MiB缓冲区。Git转而使用HTTP/1.1的chunked传输，但Traefik和Gitea的链路未能正确处理，导致响应为空，Git无法收到receive-pack的sideband结果，最终报错。这提醒我们，当推送大仓库时，默认配置可能成为瓶颈。
解决方案的适用边界
作者通过调大postBuffer至16 MiB并指定HTTP/1.1解决了问题。但Git官方文档指出，增大postBuffer仅用于禁用chunked传输，适用于代理或服务器不兼容HTTP标准的情况，并非通用解决方案。盲目调大可能显著增加内存占用，即使小推送也会分配完整缓冲区。因此，应谨慎使用，仅在确认链路不支持chunked时调整。
配置方法：文件与命令
配置可通过直接编辑.git/config文件（如Hexo的.deploy_git/.git/config）或使用git config命令完成。两种方式等效，但命令方式更便于脚本化。配置项包括http.postBuffer和http.version，后者强制使用HTTP/1.1，避免chunked传输。
Q&A
Gitea推送失败报错“unexpected disconnect while reading sideband packet”是什么原因？
推送的请求体约2.95 MiB，超过了Git默认的1 MiB的http.postBuffer，导致Git改用chunked分块传输，而Traefik/Gitea链路没有正确处理该请求，返回HTTP 200但响应体为0，Git收不到receive-pack的sideband结果，从而报错。
如何解决Gitea推送失败的问题？
调大Git的http.postBuffer至16 MiB，并指定HTTP/1.1版本。具体配置为：http.postBuffer = 16777216，http.version = HTTP/1.1。
Git的http.postBuffer默认值是多少？
Git的http.postBuffer默认值是1 MiB，对于大多数请求来说已经足够。
如何配置Git的http.postBuffer和http.version？
可以直接编辑.git/config文件，在[http]段下添加postBuffer和version配置；也可以使用git config命令：git config http.postBuffer 16777216 和 git config http.version HTTP/1.1。
为什么调大http.postBuffer可以解决推送问题？
调大http.postBuffer后，请求体不再超过缓冲区大小，Git就不会使用chunked传输编码，从而避免了Traefik/Gitea链路对chunked处理不当的问题。
调大http.postBuffer有什么副作用？
调大http.postBuffer会显著增加内存占用，因为即使实际推送的数据很小，Git也会分配完整大小的缓冲区。
