gorilla/mux搭建的六边形架构API测试指定端点出现空指针运行时错误

问题根因 #

你遇到的空指针panic完全是路由注册阶段的语法错误导致的：

• gorilla/mux的HandleFunc方法第二个参数要求传入http.HandlerFunc类型的函数引用，标准写法是只传函数名，不要加执行括号。你在代码中写的api.GenerateDeepLink()加了括号，等价于在注册路由的阶段就立刻执行这个接口处理方法，此时没有传入合法的http.ResponseWriter和*http.Request实例，方法内部访问这两个nil参数时直接触发空指针异常。

为什么错误路径不会触发报错 #

当你请求的路径和注册的路由不匹配时，gorilla/mux会直接返回404响应，不会执行对应路由绑定的handler逻辑：

• 你用未配置的路径测试时，路由匹配失败，直接返回404，自然不会走到有问题的handler代码，也就不会触发panic。
• 你把路由路径改成/之后，测试请求还是发向/getDeepLink，路径匹配不上，同样不会执行handler，所以不会报错。

修复方案 #

只需要修改routersSetup方法里的路由注册代码，去掉函数后面的执行括号即可：

func routersSetup(api ConverterAPI) *mux.Router {
    apiRouter := mux.NewRouter()
    // 去掉GenerateDeepLink后面的括号，传函数引用而非直接执行
    apiRouter.HandleFunc("/getDeepLink", api.GenerateDeepLink).Methods("POST")
    return apiRouter
}

额外排查建议 #

如果修改后仍然出现panic，可以按顺序检查以下几点：

• NewConverterAPI初始化逻辑是否返回了nil的ConverterAPI实例
• service.NewConverterService、link.NewRepository是否有未初始化的依赖字段，返回了存在nil属性的实例
• GenerateDeepLink方法内部是否访问了未初始化的API结构体字段

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