Connection refused: no further information: localhost/127.0.0.1:8803

### 排查并解决 `Connection refused` 错误 当遇到 `Connection refused` 的错误时，通常表示客户端尝试连接到服务器上的某个端口失败。以下是可能导致此问题的原因以及相应的解决方案： #### 1. **服务未启动** 如果目标服务（如 ClickHouse 或其他数据库）尚未运行，则会触发此类错误。 确认服务是否已正常启动可以通过以下命令完成： ```bash sudo systemctl status clickhouse-server ``` 或者手动检查进程是否存在： ```bash ps aux | grep clickhouse ``` 对于自定义端口号的情况，需确保服务配置文件中指定了正确的监听端口。例如，在 ClickHouse 中，可以编辑 `/etc/clickhouse-server/config.xml` 文件中的 `<port>` 配置项[^2]。 --- #### 2. **防火墙阻止访问** 即使服务正在运行，也可能因为防火墙规则而无法通过指定端口建立连接。验证方法如下： ```bash sudo ufw status ``` 或使用 `iptables` 查看当前规则： ```bash sudo iptables -L ``` 允许特定端口（如 8803）的流量可通过以下命令实现： ```bash sudo ufw allow 8803/tcp ``` 或针对更复杂的环境调整规则： ```bash sudo iptages -A INPUT -p tcp --dport 8803 -j ACCEPT ``` --- #### 3. **绑定地址不匹配** 某些情况下，默认的服务可能仅绑定了本地回环接口 (`127.0.0.1`) 而不是所有网络接口 (`0.0.0.0`)。这会导致外部设备无法访问该服务。修改配置文件以支持全局访问是一个常见做法。例如，在 ClickHouse 的配置文件中设置： ```xml <listen_host>0.0.0.0</listen_host> ``` 随后重启服务使更改生效： ```bash sudo systemctl restart clickhouse-server ``` --- #### 4. **端口冲突或其他程序占用** 另一个潜在原因是目标端口已被其他应用程序占用。利用以下工具检测端口状态： ```bash netstat -tuln | grep 8803 ``` 如果有其他进程占用了所需端口，则需要终止这些进程或将它们迁移到其他端口上。释放端口的方法之一是找到对应 PID 并杀死它： ```bash fuser -k 8803/tcp ``` --- #### 5. **日志分析** 最后一步是对服务的日志进行深入审查，寻找更多线索。ClickHouse 日志路径一般位于 `/var/log/clickhouse-server/` 下面。查看最近记录可以帮助定位具体原因： ```bash tail -f /var/log/clickhouse-server/clickhouse-server.log ``` 以上措施综合运用能够有效诊断和修复大多数因 `Connection refused` 导致的问题[^3]。 --- ### 示例代码片段 下面展示如何编写简单的 Python 客户端测试脚本，用于验证 TCP 连接可用性。 ```python import socket def test_connection(host, port): try: sock = socket.create_connection((host, port), timeout=5) print(f"Successfully connected to {host}:{port}") sock.close() except Exception as e: print(f"Failed to connect to {host}:{port}. Error: {e}") test_connection('localhost', 8803) ```