Go版本必须≥1.21,否则fiber.New()会静默失败;低版本(如1.20.x)执行go get会拉取不兼容旧分支,导致fiber.NewWithCustomCtx未定义。

go version 必须 ≥ 1.21,否则 fiber.New() 会静默失败
你执行 go get github.com/gofiber/fiber/v2 后,fiber.New() 报 undefined: fiber.NewWithCustomCtx,大概率不是代码写错了,而是 Go 版本太低。Fiber v2 要求最低 Go 1.21;若当前是 1.20.x,命令会静默拉取一个不兼容的旧分支(比如 v2.28),导致符号缺失。
实操步骤:
- 运行
go version确认版本 - 低于 1.21 时,执行
go install golang.org/dl/go1.24@latest && go1.24 download - 验证:用
go1.24 version,再执行go env -w GOROOT=$(go1.24 env GOROOT)切回系统默认 - 最后只跑
go get github.com/gofiber/fiber/v2—— 不加-u,避免误升到 v3
别用 fiber.Default(),热重载时日志和 panic 会互相干扰
fiber.Default() 默认加载 Logger、Recover、RequestID 三个中间件。每次保存触发重载后,前几秒所有请求日志全刷屏,掩盖真实 panic,调试时根本分不清哪条是错误堆栈。
正确初始化方式就一行:
立即学习“go语言免费学习笔记(深入)”;
app := fiber.New()
按需加中间件,例如开发期只开 recover:
app.Use(recover.New(recover.Config{EnableStackTrace: false}))
如需日志,用 logger.New() 并精简字段:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
logger.New(logger.Config{Format: "${status} - ${method} ${path}\n"})
去掉 Authorization 和 Body,避免敏感信息刷屏。
air 是唯一推荐的热重载工具,但配置必须对齐三个关键字段
Fiber 本身不提供热重载能力。go run main.go 每次都要手动 Ctrl+C + 回车,效率极低。必须用 air 或 reflex;air 生态最熟,但配错就白装。
关键配置项(.air.toml):
-
root = ".":必须设为项目根目录(含go.mod),填绝对路径易跨机器失效 -
build.bin = "./tmp/main":必须和build.cmd输出路径完全一致,否则报exec: "./tmp/main": file does not exist -
include_ext = ["go","yaml","yml","html","tmpl","json"]:默认只监听.go,改配置或模板不触发重启
常见坑:
- Windows 杀毒软件(如火绒)拦截
tmp/写入,可临时关闭实时防护测试 - Linux/macOS 监听太多后缀可能耗尽 inotify 句柄,大项目建议只列真正需要 reload 的扩展名
GORM 连接池在热重载下必须单次初始化,否则数据库很快连爆
热重载本质是进程反复重启。main() 多次执行,如果 gorm.Open() 写在包级变量或 init() 里,每次都会新建连接池,而旧池没被 db.Close(),很快触发 too many clients already。
安全做法:
- 把
gorm.Open()移到main()函数内,只调一次 - 显式设置连接池参数:
db.SetMaxOpenConns(20)、db.SetMaxIdleConns(10)、db.SetConnMaxLifetime(30 * time.Minute) -
AutoMigrate()仅限开发环境,且必须在db.Ping()成功后执行 - 务必加
defer db.Close(),确保每次进程退出前释放连接
别试图复用旧 *gorm.DB 实例——进程重启后 TCP 连接、内存地址全部失效,强行保留只会引发 invalid connection 或 context canceled。

















