'# Python：[WinError 10061] 由于目标计算机积极拒绝，无法连接。
一、背景与问题
[WinError 10061] 是 Windows 系统中常见的网络连接错误，其本质是 TCP/IP 协议栈在建立连接时检测到目标主机的 TCP 端口处于 CLOSED 状态（即拒绝连接）。该错误在 Python 中常出现在使用 socket 模块或 httpx/aiohttp 等网络库时，具体表现为：
socket.error: [WinError 10061] 由于目标计算机积极拒绝，无法连接这种错误的典型场景包括：
- 目标服务器未启动或未监听指定端口
- 防火墙/安全组规则阻止连接
- 网络路由不可达
- 服务端配置错误（如未正确绑定 IP 地址）
- 协议不匹配（如 TCP 与 UDP 混用）
本文将深入分析该错误的底层原理，结合实际开发案例，探讨如何通过代码规避该错误，并分析其在不同场景下的适用性。
二、基本原理
1. TCP 连接建立过程（三次握手）
当客户端尝试连接服务器时，会经历以下步骤：
- SYN（同步）：客户端发送
SYN包，请求建立连接 - SYN-ACK（同步-确认）：服务器回应
SYN-ACK包，确认连接请求 - ACK（确认）：客户端发送
ACK包，完成三次握手，连接建立
若任何一步失败，客户端会收到 ECONNREFUSED 错误（即 WinError 10061）。
2. 错误触发条件
- 服务器未监听端口：服务器未启动或未绑定到指定端口
- 防火墙拦截：系统或网络设备的防火墙规则阻止通信
- 协议不匹配：客户端使用 TCP 而服务器只监听 UDP（反之亦然）
- 网络路由问题：客户端与服务器不在同一网络段
- 端口被占用：服务器端口被其他进程占用
三、环境准备
1. Python 环境
确保已安装 Python 3.8+，可使用以下命令验证：
python --version2. 开发工具
netstat（查看端口占用）telnet（测试端口连通性）wireshark（抓包分析）
四、核心实现
1. 基础 socket 连接示例
import socket
def connect_to_server(host, port):
try:
# 创建 TCP 套接字
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
# 设置连接超时（默认 30 秒）
sock.settimeout(10)
# 尝试连接
sock.connect((host, port))
print("连接成功")
return sock
except socket.error as e:
print(f"连接失败: {e}")
return None
finally:
if sock:
sock.close()
# 测试连接
connect_to_server("localhost", 8080)关键代码解释：
socket.AF_INET表示 IPv4 地址族socket.SOCK_STREAM表示 TCP 协议settimeout(10)设置连接超时时间，避免无限等待connect()会触发三次握手，若失败则抛出socket.error
2. 异步连接（asyncio）示例
import asyncio
async def connect_async(host, port):
try:
reader, writer = await asyncio.open_connection(host, port)
print("异步连接成功")
return reader, writer
except OSError as e:
print(f"异步连接失败: {e}")
return None, None
# 异步测试
async def main():
reader, writer = await connect_async("localhost", 8080)
# 运行异步事件循环
asyncio.run(main())关键代码解释：
asyncio.open_connection()会自动处理 TCP 三次握手- 异步模式更适合高并发场景，但需要确保异步库与目标服务协议兼容
- 若目标服务未启动，会立即抛出
OSError（Windows 上映射为 WinError 10061）
3. 网络诊断工具（telnet 测试）
# Windows 命令行
telnet localhost 8080
# Linux/macOS（需安装 telnet）
telnet localhost 8080输出示例：
- 成功连接时显示空白屏幕
- 连接失败时显示
Connection refused
五、完整案例：HTTP 服务连接测试
1. 服务端代码（Flask）
from flask import Flask
import socket
app = Flask(__name__)
@app.route('/')
def index():
return "Hello, World!"
if __name__ == '__main__':
# 获取本机 IP 地址
host = socket.gethostbyname(socket.gethostname())
app.run(host=host, port=8080)2. 客户端代码（Python）
import requests
def test_http_connection():
try:
response = requests.get("http://localhost:8080")
print(f"HTTP 状态码: {response.status_code}")
except requests.exceptions.ConnectionError as e:
print(f"HTTP 连接失败: {e}")
test_http_connection()运行流程：
- 启动服务端（Flask 服务）
- 执行客户端代码，若服务正常将输出
HTTP 状态码: 200 - 若服务未启动，将抛出
ConnectionError（底层映射为 WinError 10061）
六、源码解析
1. socket 模块底层机制
在 Python 中，socket.connect() 实际调用的是系统调用 connect()，其底层依赖于操作系统提供的 TCP/IP 协议栈。当连接失败时，会触发以下处理流程：
- 系统调用失败：Linux 返回
ECONNREFUSED，Windows 返回WSAECONNREFUSED（映射为 WinError 10061） - 异常封装：Python 将系统错误码封装为
socket.error异常 - 超时处理：若设置
settimeout()，会触发socket.timeout异常
2. 异步连接的实现差异
asyncio.open_connection() 会通过 socket.connect() 启动连接，但会异步等待结果。其关键区别在于：
| 项目 | 同步连接 | 异步连接 |
|---|---|---|
| 建立连接 | 阻塞 | 非阻塞 |
| 错误处理 | 直接抛出 | 通过协程返回错误 |
| 性能 | 适合小规模 | 适合高并发 |
七、进阶使用
1. 端口占用检测
import socket
def is_port_in_use(port):
with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
return s.connect_ex((socket.gethostname(), port)) == 0应用场景：在部署服务前检查端口是否可用，避免因端口冲突导致连接失败。
2. 防火墙规则绕过
import subprocess
def disable_firewall():
# Windows 10/11（需管理员权限）
subprocess.run(["netsh", "advfirewall", "set", "currentprofile", "state", "off"])注意事项：此方法仅用于测试环境，生产环境应通过配置防火墙规则实现安全控制。
3. 自定义超时设置
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
sock.settimeout(3) # 设置 3 秒超时性能优化：合理设置超时时间可避免因无效连接导致的资源浪费。
八、性能与工程实践
1. 高并发场景优化
- 使用异步库：
asyncio、httpx等异步库可显著提升并发性能 - 连接池：复用已有连接，避免频繁创建/销毁 TCP 连接
- SSL 加密：使用
ssl.wrap_socket()增加安全性
2. 网络安全性考量
- 明文传输风险：未加密的 TCP 连接可能被中间人窃听
- 身份验证缺失：未验证客户端身份可能导致服务滥用
- 推荐方案：使用
ssl.create_default_context()配合https://协议
3. 异常处理策略
try:
sock.connect((host, port))
except socket.error as e:
if e.errno == socket.errno.ECONNREFUSED:
print("目标主机拒绝连接")
elif e.errno == socket.errno.ETIMEDOUT:
print("连接超时")
else:
print(f"其他网络错误: {e}")最佳实践：区分不同错误类型，针对性处理网络异常。
九、常见问题与踩坑
1. 常见错误场景
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 服务未启动 | 未运行服务器程序 | 启动服务端 |
| 端口被占用 | 其他进程占用端口 | 使用 lsof -i :端口号 查找占用进程 |
| 防火墙拦截 | 系统/网络防火墙规则 | 关闭防火墙或添加允许规则 |
| 协议不匹配 | TCP/UDP 混用 | 检查服务端协议配置 |
2. 开发陷阱
- 未处理异步错误：异步代码中未正确捕获异常可能导致程序崩溃
- 未设置超时：长连接可能占用资源，导致服务不可用
- 未验证身份：未验证客户端身份可能导致服务被滥用
3. 性能陷阱
- 频繁创建连接：未使用连接池可能导致资源浪费
- 未使用压缩：未启用 TCP 拥塞控制算法（如 CUBIC）影响性能
- 未处理半关闭：未正确处理
FIN_WAIT状态可能导致连接残留
十、最佳实践
1. 推荐方案
| 场景 | 推荐技术 | 说明 |
|---|---|---|
| 轻量级连接 | socket | 简单直接，适合小规模场景 |
| 高并发连接 | asyncio/httpx | 异步非阻塞，支持高并发 |
| 安全传输 | ssl | 加密通信，防止中间人攻击 |
| 分布式系统 | ZeroMQ/Redis | 高级消息队列，支持复杂通信模式 |
2. 避免使用场景
- 需要高并发：同步代码可能导致线程阻塞
- 需要安全传输：未加密的 TCP 连接存在安全风险
- 需要复杂协议：如 HTTP/2、WebSocket 等需专用库支持
十一、总结
[WinError 10061] 是 TCP 连接失败的典型表现，其根本原因在于目标主机未监听指定端口或网络环境阻止连接。通过深入分析 TCP 协议栈、网络诊断工具和代码实现，我们可以精准定位问题并采取有效措施。
在实际开发中，建议：
- 使用异步库提升并发性能
- 配置合理的超时和重试策略
- 通过防火墙/安全组规则控制网络访问
- 在需要安全传输时启用 SSL 加密
同时，要避免在未充分验证的场景下直接使用 TCP 连接，特别是在涉及敏感数据或高并发场景时。通过合理的架构设计和错误处理机制，可以有效规避该错误带来的影响，确保系统稳定运行。