详解 "connect() failed (111: Connection refused)" 的排查全链路-Nginx-PHP中文网

“Connection refused”错误表示目标端口无服务监听或被拦截，需依次验证服务监听状态（netstat/ss）、监听地址（0.0.0.0 vs 127.0.0.1）、防火墙/安全组、网络连通性（telnet/nc）、客户端配置（IP/端口/DNS）及应用层限制。

$详解 \$

这个错误表示客户端尝试连接某个服务端口时，目标服务器明确拒绝了连接请求。核心原因是：目标地址上没有进程在监听该端口，或防火墙/网络策略主动拦截了连接。

这是最常见原因。不能只看服务“启动了”，要验证它是否真在监听你访问的 IP 和端口。

用 netstat -tuln | grep :端口号 或 ss -tuln | grep :端口号 查看本地是否有进程绑定到目标端口（如 :8080）
注意监听地址：127.0.0.1:8080 只接受本机连接；0.0.0.0:8080 或具体内网 IP 才能被外部访问
检查服务日志，确认启动成功且未因配置错误（如端口被占用、证书路径错）而静默降级或退出
如果是 Docker 容器，用 docker ps 确认容器运行中，并用 docker port 容器名 核对端口映射是否正确（例如 -p 8080:3000 表示宿主机 8080 映射到容器 3000）

即使服务在运行，数据包也可能在途中被阻断。

用 ping 目标IP 初步判断三层连通性（注意：部分服务器禁 ping，失败不等于不通）
用 telnet 目标IP 端口号 或 nc -zv 目标IP 端口号 测试四层 TCP 连通性。如果显示 “Connection refused”，说明网络可达但端口无服务；如果超时（timeout），可能是防火墙丢包、路由不通或目标机器关机
检查本机防火墙（ufw status / firewall-cmd --state）、云服务器安全组、企业网络 ACL 是否放行目标端口和方向
跨主机调用时，确认使用的是服务实际部署的 IP，而非 localhost 或 127.0.0.1（后者在容器或远程调用中会指向调用方自身）

连错了地址，自然被拒。

AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。

下载

检查客户端配置中的 host 和 port 是否写错（比如把 localhost 写成 localhsot，或端口多写一个 0）
若使用域名，用 nslookup 域名 或 dig 域名 确认解析结果是否符合预期（尤其是 Kubernetes Ingress 或负载均衡场景下，可能解析到无效 VIP）
检查 hosts 文件（/etc/hosts 或 C:\Windows\System32\drivers\etc\hosts）是否有错误静态映射，导致域名指向了错误 IP
确认协议一致：HTTP 客户端不要去连 HTTPS 端口（如 443），gRPC 客户端不要连 HTTP 服务端口

某些服务会主动拒绝不符合条件的连接，表现也是 Connection refused。

查看服务文档，确认是否限制了源 IP、TLS 版本、SNI 域名、HTTP Host 头等。例如 Nginx 配置了 listen 443 ssl 但没配证书，直接用 HTTP 访问 443 就会被拒
数据库类服务（如 MySQL、Redis）可能绑定了特定 IP 或设置了 bind-address，或启用了 requirepass 但客户端未认证——但这类通常返回认证失败而非 Connection refused，需结合日志区分
服务启动依赖其他组件（如依赖 Redis 或 DB），若下游不可用，主服务可能启动失败或自动退出，表现为“看似运行实则挂了”

不复杂但容易忽略，关键在逐层验证：从服务进程本身 → 网络路径 → 客户端输入 → 应用策略，每一步都用对应工具实测，而不是凭经验猜测。