以下是 Socket 编程中常见的错误及其解决方案，按典型场景分类：

1. Connection Refused (连接被拒绝)

• 错误原因：目标端口无服务监听、防火墙阻止、服务未启动。
• 解决方案：
  • 检查目标服务是否运行（如 netstat -tuln | grep 端口）。
  • 确认目标端口是否正确。
  • 检查防火墙规则（如 iptables 或云服务安全组）。

2. Address Already in Use (地址已被占用)

• 错误原因：端口被其他进程占用，或 TIME_WAIT 状态未释放。
• 解决方案：
  • 更换端口号。
  • 设置 SO_REUSEADDR 选项允许重用地址：

    sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)

  • 查找占用端口的进程并终止（如 lsof -i :端口 或 kill -9 PID）。

3. Connection Timed Out (连接超时)

• 错误原因：网络不可达、目标服务未响应、DNS解析慢。
• 解决方案：
  • 用 ping 或 traceroute 测试网络连通性。
  • 检查目标机器是否存活。
  • 增加超时时间（如 socket.settimeout(10)）。

4. Connection Reset by Peer (连接被对方重置)

• 错误原因：对方异常关闭连接（如服务崩溃、进程被杀）。
• 解决方案：
  • 确保对方服务稳定性。
  • 捕获异常并重试或重新建立连接。
  • 使用 try-except 处理 socket.error。

5. Broken Pipe (管道破裂)

• 错误原因：向已关闭的 Socket 写入数据。
• 解决方案：
  • 检查 Socket 状态后再发送数据。
  • 使用心跳机制检测连接活性。

6. Invalid Argument (无效参数)

• 错误原因：调用 API 时参数错误（如无效 IP、端口超出范围）。
• 解决方案：
  • 检查 IP 格式（如 socket.inet_aton() 验证）。
  • 确保端口号在 1-65535 之间。
  • 确认协议类型正确（如 TCP/UDP）。

7. Permission Denied (权限不足)

• 错误原因：非特权用户绑定低端口（<1024）。
• 解决方案：
  • 使用 sudo 运行程序。
  • 改用 1024 以上的端口。
  • 配置系统权限（如 setcap 赋予二进制文件权限）。

8. Resource Temporarily Unavailable (资源暂时不可用)

• 错误原因：非阻塞 Socket 未就绪时尝试读写。
• 解决方案：
  • 使用 select/poll/epoll 监听读写事件。
  • 捕获 EAGAIN 或 EWOULDBLOCK 错误并重试。

9. DNS Resolution Failure (DNS解析失败)

• 错误原因：主机名无法解析为 IP。
• 解决方案：
  • 检查主机名拼写。
  • 配置正确的 DNS 服务器。
  • 使用 IP 地址替代主机名。

调试工具推荐

• 网络诊断：netstat、tcpdump、Wireshark。
• 端口扫描：nmap、telnet 目标IP 端口。
• 连接监控：lsof -i :端口、ss -tuln。

通用建议

• 使用 try-except 捕获 socket.error 并处理异常。
• 确保正确关闭 Socket（shutdown() + close()）。
• 跨平台注意：Windows 和 Linux 错误码可能不同（如 WSAECONNRESET vs ECONNRESET）。

通过结合具体错误码和工具诊断，可以快速定位并解决大多数 Socket 问题。