Go http.Redirect 怎样用自定义状态码控制跳转行为

在 Go 的 HTTP 处理器里，跳转地址只是问题的一半，真正决定调用方如何理解这次跳转的是状态码。http.Redirect 的第四个参数就是这个选择：它会写入 Location，再按请求方法补充必要的短响应。把 301、302、303、307、308 混用，最容易出现的现象就是 POST 后被改成 GET，或者临时地址被缓存成永久地址。

官方文档：https://pkg.go.dev/net/http#Redirect

简单记忆：创建或提交成功后想回到查询页，用 303；希望后续请求保留原方法和请求体，用 307 或 308；只有资源确实永久迁移时才用 301。302 适合兼容性要求较高的普通临时跳转，但不要把它当成“方法保持”保证。

先把跳转需求拆成三个参数

调用 http.Redirect(w, r, target, code) 时，可以把问题拆成三个互不替代的决定：

• target：响应里的 Location，表示客户端应该尝试访问的地址。
• code：告诉客户端这是永久迁移、普通临时跳转、提交后读取，还是需要保持原方法。
• r.Method：原请求是 GET、POST 还是其他方法，它会影响客户端收到 3xx 后怎样组织下一次请求。

因此，想“换一个跳转地址”不等于只替换字符串。服务端先确定资源是否永久迁移，再确定原请求能否安全地变成 GET，最后才选择对应的常量。

五类常用状态码应该怎么选

Go 客户端文档明确区分了这组语义：301、302、303 通常会让后续请求变成 GET（原请求为 HEAD 时保持 HEAD），307、308 则在请求体可重建时保持原方法和请求体。服务端的 http.Redirect 负责发出状态和位置，最终是否自动跟随由客户端策略决定。

用 http.Redirect 统一写响应

下面是一个提交订单后跳到详情页的最小处理器。它使用 303，表达“写操作完成，接下来读取结果”的意图。

package main

import (
    "net/http"
)

func createOrder(w http.ResponseWriter, r *http.Request) {
    // 只允许写操作进入创建逻辑，避免 GET 被误当成提交。
    if r.Method != http.MethodPost {
        http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
        return
    }

    // 这里用固定编号代表已经完成的业务写入，示例重点是跳转契约。
    orderID := "42"
    target := "/orders/" + orderID

    // 303 明确告诉客户端：提交完成后用 GET 读取结果页。
    http.Redirect(w, r, target, http.StatusSeeOther)
}

不要在调用前先写正文或调用 WriteHeader。一旦响应头已经发送，再调用 http.Redirect 就无法可靠地改变状态码和 Location。同一个分支也只调用一次跳转函数。

需要保留方法时使用 307 或 308

如果目标接口仍然需要接收原来的 POST 请求体，就不要用 302 或 303 伪装成方法保持。临时故障切换可用 307，永久迁移才考虑 308：

func moveUpload(w http.ResponseWriter, r *http.Request) {
    // 上传请求必须保留 POST 和请求体，不能改成结果页式跳转。
    if r.Method != http.MethodPost {
        http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
        return
    }

    // 307 表示临时迁移，客户端是否重放请求仍由它自己的策略决定。
    http.Redirect(w, r, "https://upload.example.test/v2", http.StatusTemporaryRedirect)
}

这里的“保留”不是服务端把请求体复制到新地址，而是响应状态码向客户端表达原方法语义。重放可能带来重复写入，所以支付、扣库存等操作还应配合幂等键或服务端去重。

检查路径、错误码和重复写响应

实际排查时按下面三点看，通常比盯着浏览器地址栏更快：

1. 确认目标地址是当前请求可接受的路径或完整 URL，并检查最终响应是否只写出一个 Location。
2. 把魔法数字换成 http.StatusSeeOther、http.StatusTemporaryRedirect 等常量，避免把 302 当成 307 使用。
3. 确认跳转前没有写正文、刷新响应或提前调用 WriteHeader；错误分支返回后不要继续执行跳转。

还要区分“服务端发出了正确的 3xx”和“客户端自动跟随后的最终页面”。前者由 http.Redirect 决定，后者属于客户端的重定向策略，不能靠替换服务端状态码解决所有问题。

最后用一个小包装收拢业务意图

func redirectByIntent(w http.ResponseWriter, r *http.Request, target string, preserveMethod bool) {
    // 用业务意图集中选择状态码，调用方不再散落 302、303、307 等数字。
    code := http.StatusSeeOther
    if preserveMethod {
        code = http.StatusTemporaryRedirect
    }

    // 统一出口，保证 Location 和状态码由同一个响应写入动作产生。
    http.Redirect(w, r, target, code)
}

这个包装只适合临时跳转的两种常见分支；永久迁移应单独命名并使用 301 或 308，避免把“临时”与“永久”混成同一个布尔参数。

常见问题

POST 成功后为什么推荐 303？

因为它把写操作和结果读取分开，刷新结果页不会自然地再次提交原表单，适合 Post/Redirect/Get。

307 和 308 能保证请求一定被重放吗？

不能。它们表达保留原方法和请求体的语义，是否自动跟随、是否能重建请求体仍由客户端实现决定。

能不能直接手写 Location？

可以，但容易遗漏状态码、短响应和方法边界。没有特殊响应格式要求时，优先让 http.Redirect 一次性写完。