gorilla/mux自定义中间件next handler为nil触发空指针panic问题求助

问题根源 #

你遇到的空指针异常是因为最内层全局中间件SetMigrater接收到的next参数为nil，本质原因是gorilla/mux构建中间件链时，传入的最终业务handler为nil，常见触发原因和解决方案如下：

1. 路由匹配失败（最高概率） #

gorilla/mux在请求没有匹配到任何有效handler时，理论上会自动 fallback 到默认的404 handler，但如果子路由规则配置错误，就可能出现handler为空的情况：

• 检查RouterWithPrefix函数调用时传入的前缀参数：如果传入了非空前缀，你在ListenAndServe中注册的/v2子路由的完整路径为{prefix}/v2/，你请求的/v2/自然无法匹配。
• 验证路由绑定的请求方法：你示例中/v2/路由绑定的是GET方法，确认请求方法与绑定规则一致。
• 可以临时添加全局404 handler验证是否匹配失败：

// 在注册完所有路由后添加
app.router.NotFoundHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    log.Println("未匹配到路由，请求路径：", r.URL.Path)
    http.NotFound(w, r)
})

如果运行后打印了未匹配日志，调整路由规则即可解决。

2. 中间件注册类型错误 #

检查SetRegistryClient的函数定义：你注册该中间件时没有加括号调用，如果它和SetMigrater一样是需要传入参数、返回mux.MiddlewareFunc的构造函数，直接传函数名会导致类型不匹配，即便编译巧合通过，运行时也会出现next为空的异常，需要修改为传入参数调用的形式：

// 错误写法
middleware.SetRegistryClient
// 正确写法（替换为实际参数）
middleware.SetRegistryClient(yourRegistryClientInstance)

临时规避方案 #

你可以在所有自定义中间件中添加next非空判断，先避免服务抛出500错误：

func SetMigrater(mgt dmigrate.Migrater) mux.MiddlewareFunc {
    return func(next http.Handler) http.Handler {
        return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
            r = httputil.WithValue(r, dmigrate.DockerMigraterKey, mgt)
            if next != nil {
                next.ServeHTTP(w, r)
                return
            }
            http.NotFound(w, r)
        })
    }
}

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