在 go 中使用全局变量跨函数共享状态时，必须确保类型匹配且赋值方式正确：全局变量需声明为指针类型（如 *rest.api），并在函数中用 = 而非 := 赋值，否则会意外创建同名局部变量，导致全局变量未被初始化。
问题核心在于 Go 的变量作用域与初始化语法的双重陷阱。
首先，github.com/ant0ine/go-json-rest/rest 包中的 NewApi() 函数返回的是 *rest.Api（即指向 Api 结构体的指针），而非 rest.Api 值类型：
func NewApi() *Api { ... } // 返回 *Api，不是 Api而原始代码中声明的全局变量为：
var api rest.Api // ❌ 类型不匹配：期望 *rest.Api
这会导致编译失败（若启用严格检查）或隐式类型转换错误；更重要的是，它掩盖了后续逻辑问题。
其次，在 foo() 函数中：
api := rest.NewApi() // ❌ 这是短变量声明，创建了新的局部变量 api
:= 在此处不会赋值给全局变量，而是定义并初始化一个同名的局部变量，其作用域仅限于 foo() 内。因此，全局 api 始终为 nil，后续调用 api.MakeHandler() 将 panic 或返回无效 handler，导致路由注册失效、HTTP 服务无法正确分发请求。
✅ 正确做法是：
- 修正全局变量类型：声明为指针类型 *rest.Api；
- 使用赋值操作符 =：在函数内显式赋值给全局变量；
- 确保初始化早于使用：foo() 必须完成 api 初始化后，bar() 才能安全调用 api.MakeHandler()。
修复后的完整代码如下：
package main
import (
"github.com/ant0ine/go-json-rest/rest"
"log"
"net"
"net/http"
)
type Message struct {
Body string
}
var api *rest.Api // ✅ 正确：声明为 *rest.Api
func hostLookup(w rest.ResponseWriter, req *rest.Request) {
ip, err := net.LookupIP(req.PathParam("host"))
if err != nil {
rest.Error(w, err.Error(), http.StatusInternalServerError)
return
}
w.WriteJson(&ip)
}
func foo() {
api = rest.NewApi() // ✅ 正确：赋值给全局变量，非局部声明
api.Use(rest.DefaultDevStack...)
router, err := rest.MakeRouter(
&rest.Route{"GET", "/lookup/#host", hostLookup},
)
if err != nil {
log.Fatal(err)
}
api.SetApp(router)
}
func bar() {
log.Fatal(http.ListenAndServe(":8080", api.MakeHandler())) // ✅ 此时 api 已初始化
}
func main() {
foo()
bar()
}? 关键注意事项：
- Go 中 var x T 声明的变量零值为 T 的零值（如 *T 的零值是 nil），务必显式初始化；
- := 仅用于新变量声明，若左侧变量已存在（如全局变量），应使用 = 赋值；
- 全局变量虽可简化状态共享，但易引发竞态与测试困难；生产环境建议改用依赖注入（如将 *rest.Api 作为参数传入 foo() 和 bar()）；
- go-json-rest 已归档（不再维护），新项目推荐使用标准库 net/http 搭配 gorilla/mux 或 chi 等现代路由库。
通过精准匹配类型与赋值语法，即可让全局指针变量可靠承载应用核心实例，支撑多函数协同工作。
