gokb驱动必须显式导入并触发init()函数，正确写法为import _ "kingbase.com/gokb"；连接字符串须用url格式如"kingbase://user:pass@host:port/db?sslmode=disable&client_encoding=utf8"；需手动配置连接池参数避免泄漏。
Go 连金仓数据库，不是装完 Go 就能直接 import _ "github.com/Kingbase/kingbase-go" 然后跑通的——驱动必须显式注册，且 database/sql 不会自动发现它。
gokb 驱动必须显式导入并触发 init()
金仓官方驱动 gokb 是一个纯 Go 实现的 database/sql/driver，但它不会像 mysql 或 postgres 那样在 import 时自动注册自己。你得确保它的 init() 函数被执行。
- 错误写法：
import "github.com/Kingbase/kingbase-go"—— 这只是引入包，没调用init()，sql.Open("kingbase", ...)会报sql: unknown driver "kingbase" - 正确写法：
import _ "github.com/Kingbase/kingbase-go"—— 下划线表示只执行包初始化，不引入任何符号 - 如果你用了 Go Modules，确认
go.mod中已包含该依赖：require github.com/Kingbase/kingbase-go v1.0.0（版本号以实际发布为准） - 别把
gokb和社区非官方驱动（如kingbase-go或kingbase-driver）混淆，后者不保证兼容性，官方只维护github.com/Kingbase/kingbase-go
连接字符串格式和常见参数陷阱
金仓的连接字符串语法接近 PostgreSQL，但有关键差异，比如不支持 sslmode=disable 这类参数，也不识别 host/port 的 shorthand 形式。
- 必须用 URL 格式：
"kingbase://user:password@host:port/database?parameter=value" - 常用且必须的参数：
-
sslmode=disable—— 金仓默认不启用 SSL，设为disable才能连；设成require会失败 -
connect_timeout=10—— 建议显式设置，避免默认超时过长 -
client_encoding=UTF8—— 中文环境务必加上，否则可能乱码
-
- 错误示例：
"user=test password=123 host=localhost port=54321 dbname=test"—— 这是 lib/pq 风格，gokb不认，会解析失败或静默忽略 - 正确示例：
"kingbase://test:123@localhost:54321/test?sslmode=disable&client_encoding=UTF8"
连接池配置必须手动干预
gokb 虽然实现了 database/sql 接口，但它的底层连接池行为和标准驱动略有不同：它默认不复用连接，也不自动清理空闲连接，容易导致连接数暴涨或连接泄漏。
- 务必在
sql.Open后立即设置：-
db.SetMaxOpenConns(20)—— 控制最大并发连接数，金仓单实例通常建议 ≤30 -
db.SetMaxIdleConns(5)—— 显式设值，否则默认为 2，太小易频繁建连 -
db.SetConnMaxLifetime(30 * time.Minute)—— 金仓连接长时间空闲可能被服务端 kill，设个合理 lifetime 避免driver: bad connection
-
- 不要依赖
gokb自带的连接池策略——它没有内置健康检查，PingContext失败后不会自动剔除坏连接 - 如果用在 Kubernetes 环境下，注意金仓服务 DNS 解析缓存问题：
gokb不自动刷新 DNS，建议配合net.Dialer自定义 resolver 或使用固定 IP
最容易被忽略的是：金仓的 gokb 驱动对连接字符串中特殊字符（如密码含 @、/）不做 URL 编码，而 database/sql 的解析器会提前截断。遇到连不上又无报错时，先检查密码是否被 url.Parse 错误切分——这是生产环境最隐蔽的坑。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
