如何使用h2go包通过TCP连接H2数据库？连接报错排查

H2数据库连接失败（driver: bad connection） #

• 连接字符串格式错误：github.com/jmrobles/h2go驱动要求TCP模式的连接字符串需用tcp()包裹主机和端口，当前格式未符合要求，导致驱动无法解析地址。修正后的连接字符串应为：

connectionData := fmt.Sprintf("h2://%v:%v@tcp(%v:%v)/%v", dbUsername, dbPassword, dbHost, dbPort, dbName)

• 检查H2容器配置：确保容器启动时开启了TCP远程连接，启动命令需包含-tcp、-tcpAllowOthers（允许外部访问）、-tcpPort（指定端口）等参数，否则无法通过网络连接H2。
• 验证端口映射：确认Docker容器的H2 TCP端口（默认9092）已正确映射，代码中的dbPort需与实际映射端口一致。

Postgres驱动运行时切片越界错误（runtime error: slice bounds out of range [:-4]） #

• 错误原因：github.com/lib/pq驱动在解析超长的十六进制用户名/密码时，切片操作逻辑异常导致越界。
• 解决方案：
  • 改用键值对格式的连接字符串，该格式解析逻辑更稳定，避免URL格式的转义问题：

connectionData := fmt.Sprintf("host=%v port=%v user=%v password=%v dbname=%v sslmode=disable",
    host, port, username, password, dbname)

• 若坚持使用URL格式，需对用户名和密码进行URL编码：

import "net/url"

escapedUser := url.QueryEscape(username)
escapedPass := url.QueryEscape(password)
connectionData := fmt.Sprintf("postgres://%v:%v@%v:%v/%v?sslmode=disable", escapedUser, escapedPass, host, port, dbname)

• 注意：H2兼容Postgres协议但并非原生Postgres，优先解决H2原生驱动的问题更稳妥，避免兼容性风险。

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