“Connection refused”错误主因是客户端端口与ClickHouse实际监听端口不匹配：HTTP协议需连8123端口，原生TCP协议需连9000端口；须检查netstat监听状态、config.xml中tcp_port和http_port配置、JDBC等客户端协议与端口一致性、端口占用情况及容器环境端口映射偏差。
如果您尝试通过客户端连接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、查找<tcp_port>标签，确认其值为9000且未被注释
3、查找<http_port>标签，确认其值为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 <container_name_or_id>
2、确认输出是否显示类似 9000/tcp -> 0.0.0.0:9001
3、客户端连接时应使用映射后的宿主机端口，即--port 9001而非--port 9000
4、若使用docker-compose.yml，检查ports:字段下的映射定义是否准确
