Go POST 请求重定向后为什么变成 GET

接口明明用的是 POST，服务端日志却显示最后一次请求成了 GET，最常见的原因不是 Go 把方法“改坏了”，而是服务端返回了 301、302 或 303，http.Client 按默认重定向策略创建了一个没有请求体的 GET。

在 Go 中，301/302/303 会让后续请求改用 GET；要保留 POST 方法和请求体，应让服务端返回 307/308，并确保客户端的 Request.GetBody 可用，或者先关闭自动跟随再自行处理 Location。

一、先看重定向响应，而不是只看最终页面

假设客户端向 /orders 发起表单 POST，旧接口返回 302 Location: /orders/result。Go 会继续访问 /orders/result，但这一次的请求方法已经是 GET，原来的表单数据也不会放进请求体。于是目标 handler 看到的是“没有订单字段的 GET”，很容易被误判为参数丢失。

排查时不要只打印最终的 resp.StatusCode。临时设置 CheckRedirect，观察回调参数里的“即将发送的请求”和已经走过的请求链：

client := &http.Client{
	CheckRedirect: func(req *http.Request, via []*http.Request) error {
		// req 是下一跳；via 的最后一项是刚刚收到 3xx 的请求。
		log.Printf("redirect: method=%s url=%s hops=%d", req.Method, req.URL, len(via))
		return nil // 继续使用默认的自动跟随行为
	},
}

req, err := http.NewRequest(http.MethodPost, endpoint, strings.NewReader("name=demo"))
if err != nil {
	return err
}
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
resp, err := client.Do(req)
if err != nil {
	return err
}
defer resp.Body.Close() // 读取完响应后释放连接资源

二、301/302/303 与 307/308 不是同一种语义

Go 标准库为了保持兼容性，对 301、302、303 的非 GET/HEAD 请求采用 GET 继续访问；这就是 POST 变 GET 的直接原因。307 和 308 则要求保持原方法，客户端只有在能重新得到请求体时才会继续。

因此，不能只把服务端的 302 换成 307 就结束。对于一次扣库存、创建订单或上传文件的请求，还要考虑重试是否会造成重复写入；目标接口应使用幂等键或业务去重。

三、需要保留 POST 时，服务端和客户端要配合

服务端若只是“处理成功后让浏览器打开结果页”，使用 303 更清晰；若新地址仍是同一个写入接口，才选择 307 或 308：

func moveOrder(w http.ResponseWriter, r *http.Request) {
	// 307 明确要求客户端用原方法访问新地址。
	http.Redirect(w, r, "/orders-v2", http.StatusTemporaryRedirect)
}

func stopAtRedirect(req *http.Request, via []*http.Request) error {
	// 不发送下一跳，调用方可以读取 Location 并决定是否重试。
	return http.ErrUseLastResponse
}

客户端把这个策略放进 http.Client{CheckRedirect: stopAtRedirect} 后，收到 3xx 时会返回最近一次响应；记得关闭响应体。若要让 307/308 自动重发，优先用 http.NewRequest 配合 strings.Reader、bytes.Reader 等标准库可重放输入，它们会为常见 body 设置 GetBody。

四、请求体丢失或重复提交的排查清单

• 服务端日志同时记录 r.Method、路径、状态码和 Location，确认是谁发出了 3xx。
• 客户端在 CheckRedirect 中记录 req.Method，不要用最终页面的业务状态倒推原始请求。
• 307/308 场景检查 req.GetBody 是否为空；流式 body 没有重放能力时，应停止跟随并重新构造请求。
• 写操作设置幂等键，避免网络重试或 307/308 重发让订单、扣款、上传记录重复落库。

相关问题

为什么 POST 后返回 303 反而是正确的？

如果 POST 已经完成写入，303 让客户端用 GET 打开结果页，可以避免刷新页面再次提交，这正是常见的提交后跳转模式。

只想拿到 302，不想让 Go 自动跳转怎么办？

给 Client 设置 CheckRedirect，并返回 http.ErrUseLastResponse；随后读取响应头里的 Location，由业务代码决定下一步。

307/308 一定能保留请求体吗？

不一定。Go 需要 Request.GetBody 创建新的 body；对于不可重放的流式输入，客户端可能停在原始 3xx 响应，而不是盲目发送空 body。

判断这类问题时，先确认状态码，再确认请求体是否可重放，最后才决定改服务端状态还是接管客户端重定向。官方说明可参考 net/http Client.Do 和 Go 标准库 client.go。