本文详解 go 中使用 database/sql 和 github.com/lib/pq 连接 postgresql 时常见连接失败问题，重点说明连接字符串格式、连接池初始化与主动健康检查（db.ping()）的必要性，并修正 sql 查询参数占位符错误。
本文详解 go 中使用 database/sql 和 github.com/lib/pq 连接 postgresql 时常见连接失败问题，重点说明连接字符串格式、连接池初始化与主动健康检查（db.ping()）的必要性，并修正 sql 查询参数占位符错误。
在 Go 中，sql.Open() 并不会立即建立实际数据库连接，它仅初始化一个连接池并返回 *sql.DB 句柄。若连接字符串有误（如用户名、密码、数据库名错误或网络不可达），sql.Open() 通常仍会成功返回，而真正的连接错误会在首次执行查询（如 Query、Exec）或显式调用 db.Ping() 时才暴露。这正是你遇到“连接字符串无效却无报错”的根本原因。
✅ 正确做法是：在 sql.Open() 后立即调用 db.Ping()，强制触发一次连接验证：
db, err := sql.Open("postgres", "user=postgres password=password dbname=name sslmode=disable")
if err != nil {
log.Fatal("连接配置解析失败:", err)
}
defer db.Close() // 注意：应在确认连接有效后再 defer，但此处位置合理
// 关键步骤：主动检测连接可用性
if err = db.Ping(); err != nil {
log.Fatal("数据库连接失败（网络/认证/权限问题）:", err)
}此外，你的原始查询语句存在两个关键问题：
- 参数占位符错误：PostgreSQL 驱动（lib/pq）使用 $1, $2 等位置参数，而非 ? 或命名参数。你写的是 "SELECT city FROM streams WHERE id=69"，却传入了 age 参数——该参数完全未被使用，且硬编码 id=69 与变量 age 逻辑矛盾。
- 参数未绑定：即使 SQL 中含 $1，也需确保参数数量、类型与占位符严格匹配。
✅ 正确查询应为：
rows, err := db.Query("SELECT city FROM streams WHERE id = $1", 69) // 直接传入整数 69
// 或若需动态变量：
id := 69
rows, err := db.Query("SELECT city FROM streams WHERE id = $1", id)⚠️ 其他重要注意事项：
- 连接字符串字段必须准确：dbname=name 中的 name 需替换为真实数据库名（如 myapp_dev）；user 和 password 也需与 PostgreSQL 用户配置一致；
- SSL 模式建议：生产环境应避免 sslmode=disable，推荐 sslmode=require 或更安全的 verify-full（需配置证书）；
- 资源清理：rows 必须调用 rows.Close()，否则连接可能泄漏；建议配合 defer rows.Close() 使用；
- Go 版本兼容性：Go 1.6 已较旧，建议升级至 Go 1.19+ 以获得更好驱动支持与安全更新（lib/pq 已归档，推荐迁移到 pgx）。
总结：Go 的数据库连接是懒初始化的，务必通过 db.Ping() 主动验证；SQL 查询需使用 $N 占位符并确保参数传递正确；连接字符串中的每个字段都需与 PostgreSQL 实际配置完全一致。
