使用pgx驱动时，Go sqlx连接PostgreSQL的驱动名及导入依赖问题

核心原因与解决方案 #

你遇到的报错本质是pgx驱动未被正确注册到Go标准库的database/sql接口——pgx为兼容database/sql提供了单独的适配包，而非直接在主包完成驱动注册。

1. 安装必要依赖 #

需要安装pgx的标准库适配包（按需可同时安装pgx主包用于原生高性能API）：

go get github.com/jackc/pgx/v5/stdlib
# 若需使用pgx原生API，额外安装主包
go get github.com/jackc/pgx/v5

2. 正确导入驱动包 #

在数据库连接代码中，必须导入pgx/stdlib包（注意前缀的下划线_，表示仅执行包的init函数完成驱动注册，无需直接调用包内方法）：

import (
    "github.com/jmoiron/sqlx"
    // 关键：注册pgx的database/sql兼容驱动
    _ "github.com/jackc/pgx/v5/stdlib"
)

3. 使用正确的驱动名与连接字符串 #

• 驱动名必须用pgx（这是pgx/stdlib注册的官方驱动标识）
• 连接字符串前缀支持postgres://或postgresql://，格式与标准PostgreSQL连接串一致
  示例代码：

func ConnectDB() (*sqlx.DB, error) {
    // 替换为你的数据库账号、地址、库名等信息
    connStr := "postgres://username:password@localhost:5432/dbname?sslmode=disable"
    db, err := sqlx.Connect("pgx", connStr)
    if err != nil {
        return nil, err
    }
    // 可选：验证连接有效性
    if err := db.Ping(); err != nil {
        return nil, err
    }
    return db, nil
}

常见误区说明 #

• 仅导入github.com/jackc/pgx/v5主包无法注册database/sql驱动，必须导入stdlib子包
• 驱动名不能用postgres或postgresql，这些是其他PostgreSQL驱动（如lib/pq）的标识，pgx不兼容该命名
• 连接字符串的sslmode参数需根据部署环境调整（生产环境建议使用require或verify-full）

内容的提问来源于stack exchange，提问作者Peter