4. 常见Socket错误码解析：EADDRINUSE、ECONNREFUSED、ETIMEDOUT、ECONNRESET

Socket编程中，错误码就是系统给你的“暗号”。读懂它们，你就能快速定位问题。我见过不少新手，一看到错误码就慌，其实大可不必。今天咱们就把最常见的四个错误码掰开揉碎了讲清楚。

4.1 EADDRINUSE —— 地址已被占用

这个错误码的意思是：你试图绑定的IP地址和端口号，已经被其他进程占用了。说白了，就是“这个坑已经有人蹲着了”。

我在项目中遇到过好几次这种情况。有一次线上服务重启失败，查了半天，原来是上一个进程还没完全退出，端口还处于 TIME_WAIT 状态。嗯，这里要注意，TIME_WAIT 是TCP主动关闭连接后的一个等待状态，通常会持续 2MSL（大约 1-4 分钟）。

解决思路其实不复杂：

• 查占用：用 netstat -tlnp | grep [端口号] 或 ss -tlnp 看看谁在用这个端口。
• 杀进程：确认无误后 kill 掉占用进程。
• 代码层面：设置 SO_REUSEADDR 选项，允许重用 TIME_WAIT 状态的地址。

// 设置 SO_REUSEADDR 的示例（C语言）
int opt = 1;
if (setsockopt(sockfd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt)) < 0) {
    perror("setsockopt SO_REUSEADDR failed");
}
// 然后再 bind()

4.2 ECONNREFUSED —— 连接被拒绝

这个错误码很直白：你发起了 connect()，但对方根本没在监听那个端口。你想想看，就像你敲门，但屋里没人。

我个人的排查习惯是，看到 ECONNREFUSED 先问三个问题：

1. 目标服务真的启动了吗？
2. 端口号写对了吗？
3. 防火墙有没有把端口给挡了？

场景	可能原因	快速验证
客户端连接服务端	服务端未启动或端口错误	telnet [IP] [端口]
跨机器连接	防火墙规则拦截	iptables -L -n 或云平台安全组
容器/微服务场景	服务注册中心未同步	检查服务发现状态

4.3 ETIMEDOUT —— 连接超时

ETIMEDOUT 比 ECONNREFUSED 更让人头疼。它意味着你的连接请求发出去了，但对方一直没回应，直到超时时间耗尽。为什么会这样？

• 网络不通：路由不可达、物理链路断了。
• 防火墙静默丢弃：有些防火墙配置是直接丢包，不返回拒绝。
• 对端负载过高：服务端太忙，来不及响应 SYN 包。

我记得有一次排查线上问题，客户端一直报 ETIMEDOUT。我抓包一看，SYN 包发出去了，但服务端根本没回 SYN-ACK。最后发现是云服务商的安全组策略把端口给禁了，但没返回 ICMP 不可达，所以客户端只能傻等超时。

排查 ETIMEDOUT 时，我建议你按这个顺序来：

1. 先 ping：看基础网络通不通。
2. 再 traceroute：看路由路径上哪一跳丢了。
3. 最后抓包：用 tcpdump 看三次握手有没有完成。

# 抓包示例：只抓 SYN 和 SYN-ACK
tcpdump -i eth0 'tcp[tcpflags] & (tcp-syn|tcp-ack) != 0 and host [目标IP]'

4.4 ECONNRESET —— 连接被重置

这个错误码最让人摸不着头脑。它通常发生在连接已经建立之后，对方突然发了一个 RST 包过来，把你的连接给掐断了。

说白了，ECONNRESET 就是“对方不想跟你玩了，而且连招呼都不打”。

常见触发场景：

• 对端进程崩溃：服务端突然挂了，操作系统会发 RST。
• 对端主动关闭：对方调了 close() 但你没及时处理。
• 数据格式错误：你发了对方不认识的协议数据，对方直接 RST。
• 超时关闭：服务端设置了空闲超时，你太久没发数据。

处理 ECONNRESET 的核心思路：

1. 区分读写：读操作收到 RST 返回 ECONNRESET，写操作收到 RST 返回 EPIPE（SIGPIPE 信号）。
2. 做好重试：对于非业务逻辑导致的 RST，可以尝试重连。
3. 加心跳：应用层心跳或 TCP keepalive 都能提前发现问题。

// 设置 TCP keepalive 的示例
int keepalive = 1;
int keepidle = 60;   // 60秒无数据后开始探测
int keepintvl = 10;  // 探测间隔10秒
int keepcnt = 3;     // 最多探测3次

setsockopt(sockfd, SOL_SOCKET, SO_KEEPALIVE, &keepalive, sizeof(keepalive));
setsockopt(sockfd, IPPROTO_TCP, TCP_KEEPIDLE, &keepidle, sizeof(keepidle));
setsockopt(sockfd, IPPROTO_TCP, TCP_KEEPINTVL, &keepintvl, sizeof(keepintvl));
setsockopt(sockfd, IPPROTO_TCP, TCP_KEEPCNT, &keepcnt, sizeof(keepcnt));

4.5 四个错误码的快速对比

错误码	含义	触发阶段	典型原因	排查优先级
EADDRINUSE	地址已被占用	bind()	端口冲突、TIME_WAIT	高（本地问题）
ECONNREFUSED	连接被拒绝	connect()	端口未监听、防火墙	中（需确认对端）
ETIMEDOUT	连接超时	connect()	网络不通、丢包	高（网络排查）
ECONNRESET	连接被重置	read()/write()	对端崩溃、协议错误	中（需抓包分析）