“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）
检查网络可达性与中间拦截
即使服务在运行，数据包也可能在途中被阻断。
AI舌诊面诊问诊医疗系统+诊疗商城系统源码
下载
AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。
- 用 ping 目标IP 初步判断三层连通性（注意：部分服务器禁 ping，失败不等于不通）
- 用 telnet 目标IP 端口号 或 nc -zv 目标IP 端口号 测试四层 TCP 连通性。如果显示 “Connection refused”，说明网络可达但端口无服务；如果超时（timeout），可能是防火墙丢包、路由不通或目标机器关机
- 检查本机防火墙（ufw status / firewall-cmd --state）、云服务器安全组、企业网络 ACL 是否放行目标端口和方向
- 跨主机调用时，确认使用的是服务实际部署的 IP，而非 localhost 或 127.0.0.1（后者在容器或远程调用中会指向调用方自身）
核对客户端配置与 DNS 解析
连错了地址，自然被拒。
- 检查客户端配置中的 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），若下游不可用，主服务可能启动失败或自动退出，表现为“看似运行实则挂了”
不复杂但容易忽略，关键在逐层验证：从服务进程本身 → 网络路径 → 客户端输入 → 应用策略，每一步都用对应工具实测，而不是凭经验猜测。
