ERR_CONNECTION_REFUSED 本质是TCP层明确拒绝，即目标IP+端口无进程监听或防火墙主动RST，非超时或DNS问题；Go中应通过errors.Is(err, syscall.ECONNREFUSED)精准判断，而非字符串匹配。
connection refused 错误本质是 TCP 层的明确拒绝
这个错误不是超时、dns 失败或网络不通，而是操作系统内核在收到 syn 包后，直接回复 rst —— 意味着目标 ip + 端口上**没有进程在监听**，或者防火墙策略主动丢弃连接请求。go 中常见于 net.dial、http.client.do、db.ping() 等调用，底层通常返回 *net.operror，其 err 字段为 syscall.econnrefused（linux/macos）或 syscall.wsaeconnrefused（windows）。
关键判断依据：errors.Is(err, syscall.ECONNREFUSED) 比字符串匹配 "connection refused" 更可靠，且不受 locale 影响。
快速验证目标端口是否真正在监听
别急着改 Go 代码，先确认服务端状态。Go 报错只是现象，根源在目标机器。
- 本地服务（如 MySQL、Redis、自建 HTTP server）：用
lsof -i :3306（macOS/Linux）或netstat -ano | findstr :3306（Windows）查是否有 LISTEN 状态进程 - 远程服务（如云数据库、API）：用
telnet host 3306或nc -zv host 3306测试连通性；失败则说明网络路径中某处拦截或服务未开 - 注意绑定地址：若服务只监听
127.0.0.1:3306，从其他机器或容器内访问就会被拒；应改为0.0.0.0:3306（并确保防火墙放行） - Docker 场景下，检查是否用了
host.docker.internal（Mac/Windows）或172.17.0.1（Linux）代替localhost—— 容器里localhost指自己，不是宿主机
Go 代码中如何区分和响应 connection refused
database/sql 的 db.Ping() 或 http.Get() 报错时，错误可能嵌套多层，需逐层展开判断。
- 用
errors.Is(err, syscall.ECONNREFUSED)直接检测，不要依赖err.Error() -
net.Error.Temporary()对ECONNREFUSED返回false—— 这是 Go 标准库的明确设计，说明它不是临时故障，重试价值极低 - 重试策略要分场景：
ECONNREFUSED建议最多重试 1–2 次并记录清晰日志，例如"mysql service not running on 127.0.0.1:3306"；而context.DeadlineExceeded或syscall.EHOSTUNREACH才适合指数退避 - Termux 等受限环境需额外处理 DNS：若报错含
read: connection refused且发生在解析阶段，可能是/etc/resolv.conf缺失，需用proot -b $PREFIX/etc/resolv.conf:/etc/resolv.conf ./your-binary
代理与 GOPROXY 导致的 connection refused
Go 工具链（如 go mod tidy）报 dial tcp 142.251.42.241:443: connect: connection refused，大概率是代理配置问题，而非你的代码或服务问题。
- 检查当前 GOPROXY：
go env GOPROXY；若为https://proxy.golang.org且国内访问不稳定，会直接被中间防火墙 RST - 切换为国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct（注意加,direct避免私有模块被转发） - 若使用公司私有 proxy，确认其 HTTPS 端口（通常是 443）是否开放、证书是否可信；可临时设
GOPROXY=direct排查是否 proxy 本身不可达 - Go debug 启动失败报
Connection refused: getsockopt: localhost:61148，可能是 dlv 与 Go 版本不兼容（如系统 Go 是 1.22.0，项目用 1.22.2），需统一版本
真正难排查的点往往不在 Go 侧：端口监听地址写死为 127.0.0.1 却从容器访问、GOPROXY 配置残留、Termux 缺少 resolv.conf、云服务器安全组没开对应端口 —— 这些比写重试逻辑重要得多。
