Go连接PostgreSQL时，90%连接失败或卡住源于未显式配置sslmode：本地环境必须设sslmode=disable，否则驱动默认require SSL而数据库不支持；psql能连而Go报ident失败，是因psql走Unix socket、Go走TCP触发不同pg_hba.conf规则；连接池未调优会导致too many clients错误。
Go 连接 PostgreSQL 时，不加 sslmode 或设错值，90% 的“连接失败”“卡住无响应”都源于此——不是密码错，也不是端口不通，而是驱动默认要求 SSL，而本地或测试环境的 PostgreSQL 根本没配证书。
sslmode=disable 必须显式写在连接字符串里
lib/pq 和 pgx（v5+）在 v1.10+ 后默认启用 sslmode=require。若 PostgreSQL 未开启 SSL（绝大多数本地开发、Docker 容器、Vagrant 环境都是），连接会阻塞数秒后报 failed to connect: server does not support SSL 或直接超时。
- 正确写法：
postgres://user:pass@localhost:5432/dbname?sslmode=disable - 错误写法：
postgres://user:pass@localhost:5432/dbname（缺参数，走默认 require） - 生产环境如需 SSL，应设
sslmode=require；若用自签名证书或需校验，才用sslmode=verify-full并配sslrootcert路径
密码不能硬编码在代码里
把密码写死在 sql.Open() 字符串中，等于把数据库凭据打包进二进制——CI/CD 流水线、镜像分发、日志打印都可能泄露。
- 改用环境变量：
os.Getenv("DB_PASSWORD")，再拼接 DSN - 或使用配置中心（如 Viper + Vault），绝不出现
password=123456这类明文 - 若用
pgxpool.ParseConfig()，记得调用config.AfterConnect做运行时凭据注入，避免 DSN 里含敏感字段
pg_hba.conf 认证方式不匹配导致 ident 失败
psql 能连上，Go 程序报 pq: Ident authentication failed for user "xxx"，本质是连接路径不同：psql 默认走 Unix socket（匹配 local 规则），而 Go 驱动默认走 127.0.0.1（触发 host 规则下的 ident 认证）。
- 快速验证：在连接字符串里加
host=/var/run/postgresql（Linux）或host=/tmp（macOS），强制走 Unix socket - 长期解法：修改
pg_hba.conf，对127.0.0.1/32这一行把认证方法从ident改为md5或scram-sha-256 - 别信“localhost 解析成 ::1”——Go 驱动对
host=localhost会尝试 IPv6，容易掉进host ::1/128 ident的坑
连接池参数没调导致 too many clients already
错误不是出在 SQL，而是连接池失控：db.SetMaxOpenConns(0)（无限）、db.SetMaxIdleConns(0)（不复用空闲连接）、或根本没设——结果每个 HTTP 请求都新建连接，撑爆 PostgreSQL 的 max_connections（默认常为 100）。
- 必须设
db.SetMaxOpenConns(25)（建议 ≤ PGmax_connections× 0.8） - 设
db.SetMaxIdleConns(10)，避免频繁建连销毁开销 -
db.SetConnMaxLifetime(30 * time.Minute)和db.SetConnMaxIdleTime(5 * time.Minute)防止被中间件（如 PgBouncer）或云 DB（如 RDS）静默断连后连接卡死
真正难处理的从来不是“连不上”，而是“连上了但行为不一致”：同一套 DSN，在本地跑通，上容器就挂；psql 正常，Go 就报 ident；加了 sslmode=disable 还卡住——这些几乎全是认证路径、SSL 策略、连接复用三者隐式耦合导致的，得逐层对照 pg_hba.conf、驱动默认行为、和你的实际网络拓扑来验证。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
