TTransportException: Connection refused表明客户端无法与服务端建立TCP连接，需依次排查服务端监听状态、客户端连接参数、防火墙策略、传输层配置一致性及代理干扰五方面问题。

如果您在调用Thrift服务时收到TTransportException: Connection refused异常，则表明客户端无法与服务端建立TCP连接。以下是排查此问题的具体步骤：

一、确认服务端进程是否运行并监听指定端口

该异常最常见原因是服务端未启动、已崩溃或未绑定到预期地址和端口。需验证服务端实际监听状态，而非仅依赖启动日志。

1、在服务端机器上执行命令检查端口监听情况：Linux/macOS使用netstat -tuln | grep :端口号或ss -tuln | grep :端口号；Windows使用netstat -ano | findstr :端口号。

2、若无输出，说明服务端未监听该端口，需检查服务端启动日志中是否有绑定失败提示（如Address already in use、Permission denied等）。

3、若输出显示监听地址为127.0.0.1:端口号或localhost:端口号，则仅允许本地回环访问；客户端若从其他IP访问，将触发Connection refused。

4、确认服务端代码中socket绑定地址是否显式指定为0.0.0.0（全网卡监听）或具体外网IP，而非仅127.0.0.1。

二、验证客户端连接参数是否匹配服务端配置

客户端必须使用与服务端完全一致的IP地址和端口号发起连接，且不能因hosts文件、代理或DNS解析导致地址错位。

1、检查客户端代码中TSocket构造参数，确认IP字符串值为服务端可被访问的真实IP（如"192.168.1.100"），而非"localhost"或"127.0.0.1"（除非确为本机调用）。

2、在客户端机器上执行ping 服务端IP，确认基础网络可达；再执行telnet 服务端IP 端口号或nc -zv 服务端IP 端口号，验证TCP端口是否开放并响应。

3、检查客户端所在机器的/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows），确认无将服务端域名错误映射至127.0.0.1或无效IP的条目。

4、若使用域名，执行nslookup 域名或dig 域名 +short，确认解析结果与服务端实际IP一致。

三、检查防火墙及安全组策略

即使服务端监听正确、网络可达，中间防火墙或云平台安全组仍可能拦截入站连接请求，导致连接被直接拒绝。

1、在服务端操作系统层面，临时关闭防火墙进行测试：Linux执行sudo systemctl stop firewalld或sudo ufw disable；Windows在“高级安全Windows防火墙”中启用“公用配置文件”的入站规则测试。

2、若服务部署于云环境（如阿里云、腾讯云、AWS），登录控制台检查对应ECS实例的安全组规则，确保入方向已添加允许目标端口、源IP范围（如0.0.0.0/0或客户端IP段）的规则。

3、确认服务端所在主机未启用iptables/nftables规则主动DROP目标端口流量，可执行sudo iptables -L -n -v | grep 端口号查看匹配计数。

四、核对传输层配置一致性

Thrift客户端与服务端的传输层实现必须严格匹配，否则在连接建立后握手阶段即失败，部分场景会退化为Connection refused表象。

1、确认服务端使用的TTransport类型（如TFramedTransport、TBufferedTransport）与客户端初始化时封装的transport类型完全一致。

2、检查客户端是否在TSocket构造时设置了超时参数（如new TSocket(ip, port, timeoutMs)），若timeoutMs过小（如1ms），可能导致未完成三次握手即抛出异常。

3、若服务端为Python实现，重点核查TSocket.TServerSocket初始化是否遗漏host参数：正确写法应为TSocket.TServerSocket(host='0.0.0.0', port=8848)，而非仅port=8848（后者在某些Thrift版本下默认绑定127.0.0.1）。

4、若服务端为Java实现，检查TServerSocket构造是否传入了InetSocketAddress，且其address非localhost。

五、排查代理与网络中间件干扰

客户端所在环境若配置了HTTP/HTTPS代理或SOCKS代理，且代理进程未运行或端口不可达，部分Thrift封装库可能误将RPC请求路由至代理地址，从而触发Connection refused。

1、检查系统级代理设置：Linux/macOS查看http_proxy、https_proxy环境变量；Windows检查“Internet选项→连接→局域网设置”中的代理配置。

2、检查Git、curl等工具的代理配置是否全局污染，执行git config --get http.proxy和git config --get https.proxy，若返回http://127.0.0.1:7890类值，需运行git config --unset http.proxy清除。

3、若使用IDE（如IntelliJ IDEA），进入Settings → Appearance & Behavior → System Settings → HTTP Proxy，确认未启用“Auto-detect proxy settings”或错误配置手动代理。

4、在客户端机器上执行lsof -i :代理端口（Linux/macOS）或netstat -ano | findstr :代理端口（Windows），确认代理进程实际在监听该端口。