Go 路由尾斜杠重定向怎么避免影响 POST 请求

在 net/http.ServeMux 中注册 /orders/ 这样的子树模式后，请求 POST /orders 可能先被补成 /orders/。写操作最稳妥的处理不是猜客户端会不会保留请求体，而是给 POST 选择明确的规范地址，或者把两种地址都用精确模式注册。Go 1.26 起 ServeMux 的这类尾斜杠重定向使用 307；旧版本、反向代理或手写重定向仍可能返回 301、302 等不同结果。

要避免 POST 受尾斜杠影响，优先让客户端直接调用规范 URL；需要兼容两种 URL 时，同时注册 POST /orders 与 POST /orders/{$}，不要只注册宽泛的 /orders/。

为什么 /orders 会被补成 /orders/

ServeMux 把以斜杠结尾的路径看作一个子树入口。注册 /orders/ 后，/orders/123 可以落入这棵子树；当请求正好是 /orders 时，标准库会尝试把它重定向到带斜杠的根路径，除非你另外注册了无斜杠的精确路径。

这里有两个容易混淆的边界：/orders/ 会覆盖后续路径，而 /orders/{$} 只匹配带尾斜杠的这一条路径。后者适合“创建订单入口”这类不希望意外吃掉子路径的 POST 处理。

先固定 POST 的规范地址

如果接口规范决定使用无斜杠地址，就让调用方一直发送 POST /orders；如果团队统一使用带斜杠地址，则文档、前端请求和服务端模式都写成 POST /orders/{$}。Go 1.22 引入的方法模式还会把不匹配的方法隔离开，避免 GET 处理函数误接收写请求。

package main

import "net/http"

func saveOrder(w http.ResponseWriter, r *http.Request) {
	// 这里只处理订单写入；真实项目应在此校验请求体并返回结果。
	w.WriteHeader(http.StatusCreated)
}

func listOrders(w http.ResponseWriter, r *http.Request) {
	// 读取接口使用子树模式，和 POST 的精确入口分开。
	w.WriteHeader(http.StatusOK)
}

func main() {
	mux := http.NewServeMux()
	// 无斜杠地址直接承接 POST，不依赖尾斜杠重定向。
	mux.HandleFunc("POST /orders", saveOrder)
	// 带斜杠地址只匹配这一条路径，{$} 不会扩展到 /orders/123。
	mux.HandleFunc("POST /orders/{$}", saveOrder)
	// GET 子树单独注册，避免把读取和写入边界混在一起。
	mux.HandleFunc("GET /orders/", listOrders)

	_ = http.ListenAndServe(":8080", mux)
}

两条 POST 模式可以共用处理函数。它们的价值在于：客户端无论发送哪一种规范形式，都能直接进入业务处理，不需要先经历一次路径改写。生产代码还应按项目要求处理请求体读取、幂等键、超时和错误响应，这些不属于尾斜杠匹配本身。

必须重定向时，先看状态码

Go 1.26 的 ServeMux 尾斜杠重定向改用 307，但不要把它当成跨版本或跨代理的唯一保障。排查时查看响应的 Location、状态码、客户端第二次请求的方法，以及请求体是否仍可读；如果中间层自行返回 301，问题就不在 ServeMux 的注册代码里。

上线前的路由检查清单

• 接口文档是否明确写出 /orders 还是 /orders/？
• POST 是否用了方法模式，带斜杠入口是否需要 {$} 精确限制？
• 是否存在网关、反向代理或 CDN 在应用之前改写尾斜杠？
• 测试时是否同时检查了响应 Location 与第二次请求的 method、body？

官方资料可继续查阅 net/http.ServeMux 文档、Go 1.22 路由增强说明 和 Go 1.26 发布说明。如果项目仍需兼容旧 Go，显式注册双路径比依赖自动重定向更容易审查。

常见问题

注册了 POST /orders/，为什么 POST /orders/123 也能进来？

因为结尾斜杠表示子树匹配。只想匹配根路径时改用 POST /orders/{$}。

307 一定能保证请求体被重发吗？

它表达了保留方法和请求体的语义，但客户端必须支持重定向并能重新提供请求体；不可重读的流或被代理改写时仍要单独处理。

可以只在处理函数里兼容两个路径吗？

可以，但如果无斜杠请求在进入处理函数前就被 ServeMux 重定向，函数没有机会判断原始路径。需要两种地址直达时，应注册两条精确模式。