自定义Git Server的receive-pack与upload-pack响应错误排查

核心问题分析 #

你实现的简易Git服务器目前卡在Git HTTP协议的规范响应格式上，Git CLI对协议的长度前缀、内容结构有严格要求，不符合规范就会抛出协议错误。下面针对两个接口分别给出可运行的修正逻辑：

一、修复git-upload-pack（clone/fetch）的响应逻辑 #

fatal: protocol error: bad pack header 说明你没有按照Git协议要求发送正确的前缀和响应结构。Git HTTP协议中，服务端需要先返回带长度前缀的服务声明，再处理客户端的请求并返回pack数据。

修正后的handleRequest示例（针对upload-pack） #

import (
	"net/http"
	"os"
	"os/exec"
)

func handleRequest(w http.ResponseWriter, r *http.Request) {
	if r.URL.Path == "/git/asd.git/git-upload-pack" {
		// 1. 发送Git协议的服务声明前缀
		w.Header().Set("Content-Type", "application/x-git-upload-pack-advertisement")
		// 长度前缀为4位十六进制，对应内容长度+4（前缀本身长度）
		_, _ = w.Write([]byte("001e# service=git-upload-pack\n"))
		_, _ = w.Write([]byte("0000")) // 空包结束标记

		// 2. 处理POST请求（客户端发起fetch/clone的实际数据请求）
		if r.Method == http.MethodPost {
			// 确保asd.git是合法的Git裸仓库
			cmd := exec.Command("git", "upload-pack", "--stateless-rpc", "./asd.git")
			cmd.Stdin = r.Body
			cmd.Stdout = w
			cmd.Stderr = os.Stderr
			_ = cmd.Run()
		}
		return
	}

	// 处理根路径GET请求（可选，返回仓库基础信息）
	w.WriteHeader(http.StatusOK)
	_, _ = w.Write([]byte("Simple Git Server"))
}

关键要点 #

• 必须先发送001e# service=git-upload-pack\n和0000作为初始响应，这是Git协议强制要求的服务通告格式。
• 借助git upload-pack --stateless-rpc命令处理pack数据生成，避免手动解析复杂的Git pack格式。
• 确保./asd.git是裸仓库（通过git init --bare asd.git创建）。

二、修复git-receive-pack（push）的响应逻辑 #

error: failed to push some refs to <REMOTE> 通常是因为服务端未正确返回push结果响应，或未处理客户端发送的pack数据。

修正后的handleReceiveRequest示例 #

import (
	"net/http"
	"os"
	"os/exec"
)

func handleReceiveRequest(w http.ResponseWriter, r *http.Request) {
	w.Header().Set("Content-Type", "application/x-git-receive-pack-result")
	
	// 1. 发送服务声明前缀
	_, _ = w.Write([]byte("001f# service=git-receive-pack\n"))
	_, _ = w.Write([]byte("0000"))

	// 2. 使用git命令处理push请求的核心逻辑
	cmd := exec.Command("git", "receive-pack", "--stateless-rpc", "./asd.git")
	cmd.Stdin = r.Body
	cmd.Stdout = w
	cmd.Stderr = os.Stderr
	err := cmd.Run()
	if err != nil {
		http.Error(w, err.Error(), http.StatusInternalServerError)
		return
	}

	// 3. 发送协议结束标记，保证响应完整性
	_, _ = w.Write([]byte("0000"))
}

关键要点 #

• 同样需要先发送服务声明前缀，符合Git协议的初始响应规范。
• 用git receive-pack --stateless-rpc处理push的核心流程：解析refs、接收pack、更新仓库。
• 确保裸仓库有正确的读写权限（运行Go进程的用户需要能写入仓库目录），否则会因权限问题导致push失败。

测试验证步骤 #

1. 创建裸仓库：mkdir -p asd.git && cd asd.git && git init --bare && cd ..
2. 启动Go服务器，确保代码中仓库路径指向正确的裸仓库。
3. 测试clone：git clone http://localhost:8080/git/asd.git
4. 测试push：在克隆的仓库中添加文件、提交，执行git push origin main

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