Go连接ClickHouse失败：“driver: bad connection”错误排查指南
本文针对Go语言连接ClickHouse数据库时出现的“driver: bad connection”错误提供详细的排查和解决方法。此错误通常并非简单的网络连接问题，而是连接参数或驱动程序配置方面的问题。
问题描述:
开发者使用Go语言官方示例代码连接ClickHouse，却持续遇到“driver: bad connection”错误。代码使用了github.com/clickhouse/clickhouse-go v1.4.1驱动程序和github.com/jmoiron/sqlx v1.2.1库。错误日志显示多次连接尝试超时，最终抛出“driver: bad connection”异常。
示例代码片段：
package main
import (
_ "github.com/clickhouse/clickhouse-go"
"github.com/jmoiron/sqlx"
)
func main() {
connect, err := sqlx.Open("clickhouse", "tcp://127.0.0.1:9000?debug=true&read_timeout=10&write_timeout=10")
if err != nil {
panic(err)
}
var items []interface{}
sql := "select * from statics.mysql_slow_log"
if err := connect.Select(&items, sql); err != nil {
panic(err)
}
}
错误日志片段：
[clickhouse][connect=3][connect] read error: read tcp 127.0.0.1:49641->127.0.0.1:9000: i/o timeout panic: driver: bad connection
问题分析与解决方案:
错误日志和代码表明，问题根源在于连接字符串 "tcp://127.0.0.1:9000?debug=true&read_timeout=10&write_timeout=10" 缺少关键的数据库连接参数。连接字符串只指定了主机和端口，而缺少数据库名称(database)、用户名(username)和密码(password)。ClickHouse需要这些信息进行身份验证并连接到指定数据库。
解决方法：
修改连接字符串，添加必要的数据库名称、用户名和密码。例如：
"tcp://user:password@127.0.0.1:9000?database=mydatabase&debug=true&read_timeout=10&write_timeout=10"
请将 "user", "password", 和 "mydatabase" 替换为您的实际用户名、密码和数据库名称。 如果ClickHouse启用了身份验证，则必须提供正确的用户名和密码。
其他排查步骤:
如果问题仍然存在，请检查以下方面：
- ClickHouse服务器状态: 确保ClickHouse服务器正在运行，并且监听指定的端口 (9000)。
- 防火墙: 确认防火墙没有阻止客户端连接到ClickHouse服务器。
- 驱动程序版本: 检查驱动程序版本是否兼容您的ClickHouse版本。
-
网络连接: 确保客户端和服务器之间存在正常的网络连接。 可以使用
ping命令测试网络连通性。 - 用户权限: 确保使用的用户名具有访问指定数据库的权限。
通过仔细检查连接字符串并遵循上述排查步骤，您应该能够解决“driver: bad connection”错误，成功连接到ClickHouse数据库。
