Go程序启动错误无法通过main()返回值捕获，必须在main()内显式处理；init()中panic会立即终止程序；os.Exit()跳过defer导致资源泄漏；第三方库init()需主动验证。
main() 函数返回值无法捕获启动错误
Go 程序的 main() 函数签名固定为 func main()，不支持返回 error 或 int。这意味着你不能靠函数返回值把初始化失败“抛出去”。所有启动期错误必须在 main() 内部显式处理，否则进程会 panic 或静默退出。
- 常见错误现象：调用
http.ListenAndServe()前未检查端口占用，程序直接 panic 并打印 stack trace，但没输出可读错误信息 - 正确做法是用
if err != nil检查每个可能失败的初始化步骤，并调用log.Fatal()或自定义退出逻辑 - 不要依赖 defer + recover 捕获
main()中的 panic —— recover 只对同一 goroutine 有效，且无法挽回已发生的资源泄漏或监听绑定失败
init() 中 panic 会导致程序立即终止且无堆栈过滤
init() 函数执行早于 main()，常被误用于加载配置、连接数据库等重操作。一旦其中发生 panic（比如 json.Unmarshal 失败、sql.Open 参数错误），Go 运行时会直接中止，只打印原始 panic 信息，不经过任何日志中间件或错误格式化。
- 使用场景：仅适合无副作用、纯静态初始化（如注册 encoder、预设常量映射）
- 避免在
init()中做 I/O、网络调用、文件读取 —— 这些都应移入main()或专用初始化函数 - 若必须提前校验，可用全局变量 + 懒加载模式：
var cfg *Config var cfgErr error func loadConfig() (*Config, error) { if cfg != nil || cfgErr != nil { return cfg, cfgErr } cfg, cfgErr = parseConfig("config.json") return cfg, cfgErr }
os.Exit() 会跳过 defer，导致资源泄漏
在启动阶段调用 os.Exit(1) 是常见退出方式，但它会立即终止进程，忽略所有已注册的 defer 语句。如果此前已成功打开文件、监听 socket、启动 goroutine，这些都不会被清理。
- 典型问题：调用
net.Listen()成功后，紧接着检查配置失败并os.Exit()→ 端口仍被占用，下次启动报address already in use - 推荐做法：把资源获取和释放封装成结构体方法，用
defer配合显式 cleanup 函数type App struct { ln net.Listener } func (a *App) init() error { ln, err := net.Listen("tcp", ":8080") if err != nil { return err } a.ln = ln return nil } func (a *App) close() error { if a.ln != nil { return a.ln.Close() } return nil } func main() { app := &App{} if err := app.init(); err != nil { log.Printf("init failed: %v", err) os.Exit(1) // 此处仍不安全，见下条 } defer app.close() // 必须确保 defer 在可能 panic 的代码之后注册 } - 更稳妥的是统一用
log.Fatal()—— 它内部调用os.Exit()前会刷新日志，且语义更明确
第三方库 init() 无法控制，需主动防御性检查
像 database/sql、gopkg.in/yaml.v3 等库会在自己的 init() 中注册驱动或设置默认行为。它们的失败不会暴露给你的代码，但可能导致后续调用静默失败（例如 sql.Open("mysql", ...) 返回 nil 错误却无提示）。
立即学习“go语言免费学习笔记（深入）”；
- 关键点：调用任何第三方初始化接口后，立刻做一次最小可行性验证
- 示例：初始化 Prometheus registry 后，调用
reg.Gather()看是否 panic；初始化 Redis client 后，执行client.Ping(ctx).Err() - 避免在
init()中 import 有副作用的包（如_ "github.com/go-sql-driver/mysql"），除非你确认其init()安全且可控 - 生产环境建议启用
-gcflags="-l"禁用内联，便于调试初始化顺序问题
