可能是端口问题，还有其他原因？

当遇到ClickHouse连接时的“Connection refused”错误，问题表面看似是端口配置不当，实则涉及协议匹配、配置文件设置、客户端参数、端口冲突及容器环境映射等多重因素——HTTP客户端必须连8123端口，TCP客户端必须连9000端口，而config.xml中的tcp_port和http_port配置、netstat监听验证、lsof端口占用排查、以及Docker/K8s中宿主机与容器端口映射偏差，任一环节出错都会导致连接被系统内核直接拒绝；掌握这套系统性排查逻辑，才能快速定位并彻底解决看似简单却极易误判的连接故障。

如果您尝试通过客户端连接ClickHouse服务，但收到“Connection refused”错误提示，则很可能是由于客户端指定的端口与服务器实际监听的端口不一致。以下是解决此问题的步骤：

一、确认ClickHouse实际监听的端口

ClickHouse默认提供多个协议端口，不同连接方式对应不同端口。若客户端使用HTTP协议（如JDBC、curl、浏览器访问），应连接8123端口；若使用原生TCP协议（如clickhouse-client、ClickHouse-CPP），则需连接9000端口。混淆二者将直接导致连接被拒。

1、执行命令检查当前监听状态：netstat -tuln | grep -E '9000|8123'

2、观察输出中是否包含类似 tcp 0 0 *:9000 *:* LISTEN 或 tcp 0 0 *:8123 *:* LISTEN 的行

3、若仅出现8123而未见9000，说明服务仅启用了HTTP接口，此时原生客户端必须改用8123端口并配合HTTP协议参数

二、检查config.xml中tcp_port与http_port配置

ClickHouse的端口行为由配置文件/etc/clickhouse-server/config.xml中的tcp_port和http_port字段决定。即使服务运行正常，若这两个值被注释、设为0或被误修改，对应协议监听器将不会启动。

1、打开配置文件：sudo vim /etc/clickhouse-server/config.xml

2、查找标签，确认其值为9000且未被注释

3、查找标签，确认其值为8123且未被注释

4、保存后重启服务：sudo systemctl restart clickhouse-server

三、验证客户端连接参数是否匹配协议类型

客户端必须同时满足“正确端口 + 正确协议”，否则操作系统内核会在建立TCP连接阶段直接返回RST包，表现为Connection refused。例如JDBC URL中端口号与协议类型必须严格对应。

1、原生TCP连接（clickhouse-client）应使用：clickhouse-client --host localhost --port 9000

2、HTTP连接（curl或JDBC）应使用：curl 'http://localhost:8123/?query=SELECT%201'

3、JDBC URL中若含jdbc:clickhouse://前缀，默认走TCP协议，端口必须为9000；若含jdbc:clickhouse:http://前缀，则走HTTP协议，端口必须为8123

四、排查端口被其他进程占用的情况

当ClickHouse配置了某端口但启动失败时，常见原因是该端口已被其他服务（如Hadoop、Nginx、另一个ClickHouse实例）独占绑定，导致ClickHouse监听器无法初始化。

1、检查9000端口占用进程：sudo lsof -i :9000

2、检查8123端口占用进程：sudo lsof -i :8123

3、若发现非clickhouse进程占用，可终止该进程或修改ClickHouse配置中对应端口值

4、修改后务必执行：sudo systemctl daemon-reload && sudo systemctl restart clickhouse-server

五、区分容器/云环境中的端口映射偏差

在Docker或Kubernetes部署中，宿主机暴露的端口可能与容器内ClickHouse监听端口不一致。例如docker run命令中指定-p 9001:9000，则外部必须访问9001端口，而非容器内的9000。

1、查看容器端口映射：docker port

2、确认输出是否显示类似 9000/tcp -> 0.0.0.0:9001

3、客户端连接时应使用映射后的宿主机端口，即--port 9001而非--port 9000

4、若使用docker-compose.yml，检查ports:字段下的映射定义是否准确

今天关于《可能是端口问题，还有其他原因？》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！