sql.open不建立真实连接，仅初始化连接池管理器；必须立即调db.ping()验证连通性，否则首次query时才暴露连接错误，导致panic延迟且堆栈难定位。
别用 lib/pq，也别跳过 db.Ping() —— 否则你写的接口跑起来就 panic，而且错误堆栈里根本看不出是连不上库。
为什么 sql.Open("postgres", dsn) 不报错却连不上？
sql.Open 只是解析连接字符串、初始化连接池参数，并不建立任何 TCP 连接。它返回的 *sql.DB 是个“空壳”，后续第一次 Query 或 Exec 才真正拨号——这时才暴露 dial tcp 127.0.0.1:5432: connect: connection refused 或 Ident authentication failed。
- 必须紧跟着调
db.Ping()或db.PingContext(ctx)来触发真实握手 - 在 Kubernetes 环境中，DNS 解析可能延迟，建议加简单重试（比如最多 3 次，间隔 1s）
- 如果用
pgxpool.Pool，Ping是从池里取一个连接测，比lib/pq更快反馈真实状态
驱动选型和导入必须写对
社区已明确淘汰 lib/pq（2023 年归档），pgx/v5 是当前事实标准，尤其推荐 pgxpool.Pool。
- 用
database/sql接口时：导入import _ "github.com/jackc/pgx/v5"，驱动名仍是"postgres"，不是"pgx" - 直连
pgxpool时：导入import "github.com/jackc/pgx/v5/pgxpool"，然后用pgxpool.Connect - 别写
import "github.com/lib/pq"—— 缺少下划线会导致驱动注册失败，sql.Open("postgres", ...)直接 panicsql: unknown driver "postgres"
sslmode=disable 和 sslmode=require 怎么选？
开发环境用 sslmode=disable 省事；生产环境必须设为 sslmode=require，否则 PostgreSQL 服务端若配置了 require 或 verify-full，连接会直接拒绝。
- 连接字符串示例：
host=localhost port=5432 user=postgres password=pass dbname=myapp sslmode=disable TimeZone=Asia/Shanghai - 漏写
host会 fallback 到 localhost（TCP），但某些 pg_hba.conf 默认对::1（IPv6 回环）用 ident 认证，本地没 ident 服务就崩出Ident authentication failed - 如果用 Docker 或云数据库（如 Azure），务必确认 host 是否可解析、端口是否开放、防火墙是否放行
Gin 中怎么安全注入 DB 实例？
别把 *sql.DB 或 *gorm.DB 声明成全局变量再裸奔传参；Gin 的 c.MustGet("db") 或中间件注入更可控。
- 初始化后存进 Gin 的
Engine：r.Set("db", db) - 在 handler 里取：
db := c.MustGet("db").(*sql.DB) - 更推荐用依赖注入容器（如 wire）或构造函数传参，避免隐式依赖和并发风险
- 记得在
main()结尾调db.Close()，否则进程退出前连接池不会释放
最常被忽略的点：NULL 值扫进非指针类型会直接 panic，比如 Scan(&name) 而 name 是 string 不是 *string —— 这和连接无关，但一上线就炸，且堆栈不提示是 NULL 导致的。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
