Go 语言如何连接操作 PostgreSQL 数据库？

哈喽！今天心血来潮给大家带来了《Go 语言如何连接操作 PostgreSQL 数据库？》，想必大家应该对Golang都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习Golang，千万别错过这篇文章~希望能帮助到你！

生产环境必须用pgxpool.Pool，因其支持连接复用、健康检查、自动重连和context取消；pgx.Connect和sql.Open+lib/pq均不满足高并发与稳定性要求。

直接用 database/sql + pgx/v5 驱动，别碰已归档的 lib/pq；连接字符串必须带 sslmode=disable（开发）或 sslmode=require（生产），且 sql.Open 后必须立刻 db.Ping() 验证。

为什么 sql.Open("postgres", connStr) 会报 “unknown driver”？

因为没导入驱动包——database/sql 本身不实现任何数据库协议，只是接口层。你得显式导入并空白引用驱动才能注册它。

• 用 pgx/v5：写 import _ "github.com/jackc/pgx/v5/database/sql"（注意下划线）
• 别写 import "github.com/jackc/pgx/v5"——那是原生 pgx API，和 database/sql 不兼容
• lib/pq 已归档，GitHub 页面明确标为 “Deprecated”，新项目禁止使用
• 导入后仍报错？检查 go.mod 是否真拉了 github.com/jackc/pgx/v5，运行 go mod tidy

连接字符串怎么写才不卡住或连不上？

PostgreSQL 默认强制 SSL，本地开发不加 sslmode=disable 就会卡在握手、超时后报 failed to connect: server does not support SSL；生产环境则必须用 sslmode=require 或更严模式。

• 推荐 URL 格式：postgres://user:pass@localhost:5432/dbname?sslmode=disable
• 密码含特殊字符（如 @、/）？先用 url.QueryEscape(pass) 处理再拼接
• Docker 环境里 host 别写 localhost——容器内 localhost 指自己，应填服务名（如 postgres）或宿主机网关 IP（如 172.17.0.1）
• 云数据库（如 AWS RDS）端口不是 5432？必须显式写 :5433，不能依赖默认值

查数据时为什么 Scan panic 报 “unsupported Scan, storing driver.Value type ”？

这是 NULL 值扫进非指针/非 sql.NullXXX 类型的典型错误。PostgreSQL 的 NULL 不等于 Go 的零值，也不能直接扫进 *string 或 string。

• 字段可能为 NULL？一律用 sql.NullString、sql.NullInt64、sql.NullTime
• 确定非空且是 TEXT/VARCHAR？用 &myVar（变量地址），不是 &myPtr（指针变量的地址）
• 时间字段扫出来是空？别用 time.Time，改用 *time.Time 或 sql.NullTime
• JSONB 字段不能扫进 string——会报 cannot scan into *string from jsonb，改用 json.RawMessage 或自定义 Scan 方法

事务里执行第二条语句就报 “current transaction is aborted”？

PostgreSQL 的事务是强一致性模型：只要一条语句出错（唯一键冲突、类型转换失败等），整个事务立即进入 aborted 状态，后续所有命令全被拒绝，直到你显式 ROLLBACK。

• 每条 tx.Query / tx.Exec 后都必须检查 err != nil，一出错立刻 tx.Rollback() 并返回
• 别写 defer tx.Rollback() 就完事——成功路径必须 tx.Commit()，否则连接永远卡在 idle in transaction
• 事务内严禁混用 db.Query 和 tx.Query：前者走连接池新连，不在事务中，隔离性失效
• 用 pgxpool.Pool 开事务，别用 pgx.Connect——后者没有连接复用，高并发下直接 dial tcp: too many open files

最易被忽略的一点：所有 PostgreSQL 连接配置（包括 sslmode、timezone、search_path）都得在连接字符串或 pgx.ParseConfig 里显式声明，pgx 不读环境变量、不自动 fallback、不猜你的意图。

以上就是《Go 语言如何连接操作 PostgreSQL 数据库？》的详细内容，更多关于的资料请关注golang学习网公众号！