Golang API路由异常：仅匹配最后一条路由问题排查

我帮你分析下，你遇到的这个问题大概率是踩了Gorilla Mux路由库的一个常见语法坑——错误地将HandleFunc的返回值赋值回了路由器变量，导致所有路由最终都被合并到了最后一条Route上。

具体来说： #

Gorilla Mux的Router.HandleFunc()方法返回的是*Route对象（用来配置当前路由的属性，比如请求方法、名称等），而不是*Router对象。如果你的代码是像下面这样写的：

r := mux.NewRouter()
r = r.HandleFunc("/api/info", InfoShow)  // 错误：把*Route对象赋值给了原本是*Router的r变量
r = r.HandleFunc("/api/something", SomeHandler)  // 继续修改同一个Route对象
r.HandleFunc("/users/create", UsersCreate)  // 最后这条Route的处理器被覆盖为UsersCreate

这时候变量r已经不再是路由器实例，而是变成了一个单一的*Route对象。后续所有的HandleFunc调用都是在修改这个Route，最终这条Route的处理器会被最后一次调用覆盖，并且路径匹配逻辑出现异常，导致所有请求（包括/api/info）都被路由到最后设置的处理器（也就是UsersCreate）。

当你移除第二条路由后，代码变成：

r := mux.NewRouter()
r = r.HandleFunc("/api/info", InfoShow)
r.HandleFunc("/users/create", UsersCreate)

这时候虽然写法依然错误，但因为/api/info的Route路径刚好匹配请求，所以暂时能正常工作，但后续添加新路由还是会出问题。

正确的写法： #

直接在*Router对象上连续调用HandleFunc，不要将返回值赋值回路由器变量：

r := mux.NewRouter()
// 直接在Router上添加路由，返回的Route对象用来配置属性（比如请求方法）
r.HandleFunc("/api/info", InfoShow).Methods("GET")
r.HandleFunc("/api/something", SomeHandler).Methods("GET")
r.HandleFunc("/users/create", UsersCreate).Methods("POST")

也可以用链式调用给路由添加更多属性（比如命名），但注意不要覆盖路由器变量：

r := mux.NewRouter()
r.HandleFunc("/api/info", InfoShow).Methods("GET").Name("info-show")
r.HandleFunc("/api/something", SomeHandler).Methods("GET").Name("something-handler")
r.HandleFunc("/users/create", UsersCreate).Methods("POST").Name("user-create")

其他可能的小概率原因： #

1. 路由顺序问题：如果把通配符路由（比如/api/{param}）放在固定路径路由（比如/api/info）之前，Mux会优先匹配通配符路由，但这种情况只会影响同前缀的请求，不会让所有请求都匹配最后一条路由，不符合你的场景。
2. 未指定请求方法：如果某个路由没加Methods()限制，会匹配所有HTTP方法，但路径不匹配的话也不会出现/api/info跳转到/users/create的情况，可能性较低。

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