本文详解“目标机器主动拒绝连接”错误（127.0.0.1:1026）的根本成因，重点说明本地回环地址（127.0.0.1）的局限性，并提供python服务端与c#客户端跨设备通信的完整配置方案、代码修正和关键注意事项。
本文详解“目标机器主动拒绝连接”错误（127.0.0.1:1026）的根本成因，重点说明本地回环地址（127.0.0.1）的局限性，并提供python服务端与c#客户端跨设备通信的完整配置方案、代码修正和关键注意事项。
该错误 No connection could be made because the target machine actively refused it. 127.0.0.1:1026 是TCP编程中极具误导性的典型提示——它并非网络不通，而是目标端口上没有监听进程响应连接请求。尤其当服务端与客户端运行在不同设备时，若服务端仍绑定到 127.0.0.1（即仅接受本机回环连接），则外部设备（包括同一局域网内的其他机器）必然无法建立连接，系统内核会直接拒绝SYN包，从而抛出此异常。
✅ 正确的服务端绑定方式
127.0.0.1 仅用于本机测试；要支持局域网或跨设备通信，服务端必须绑定到实际网卡IP（如 192.168.1.105）或通配地址 0.0.0.0（监听所有可用接口）：
import socket
def StartServer(host, port, log):
server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
# ❌ 错误：仅监听回环，外部不可达
# server_socket.bind(("127.0.0.1", port))
# ✅ 正确：监听所有网络接口（推荐用于开发调试）
server_socket.bind(("0.0.0.0", port))
# ✅ 或指定本机局域网IP（需确保IP稳定，如通过 ipconfig / ifconfig 查询）
# server_socket.bind(("192.168.1.105", port))
server_socket.listen(1)
log.info(f"✅ Server listening on all interfaces:{port}")
while True:
client_socket, addr = server_socket.accept()
log.info(f"? Accepted connection from {addr}")
data = client_socket.recv(1024).decode("utf-8")
response = "data received"
client_socket.send(response.encode("utf-8"))
client_socket.close()⚠️ 注意：若使用 0.0.0.0，请确保防火墙放行对应端口（如 Windows 防火墙 → 入站规则 → 新建规则 → 端口 → TCP 1026 → 允许连接）。
✅ C# 客户端调用修正
客户端需指向服务端所在设备的真实局域网IP，而非 127.0.0.1：
public static void SendData(string serverAddress, int port) // serverAddress 应为服务端IP，如 "192.168.1.105"
{
try
{
using var client = new TcpClient(); // 推荐使用 using 确保资源释放
Console.WriteLine($"Connecting to {serverAddress}:{port}...");
client.Connect(serverAddress, port); // 显式 Connect() 更易调试
using NetworkStream stream = client.GetStream();
Console.WriteLine("✓ Connected. Sending data...");
string message = "Hello from C# client";
byte[] data = Encoding.UTF8.GetBytes(message); // ✅ 改用 UTF8 而非 ASCII（更通用）
stream.Write(data, 0, data.Length);
// 设置读取超时，避免无限阻塞
stream.ReadTimeout = 5000;
data = new byte[256];
int bytes = stream.Read(data, 0, data.Length);
string responseData = Encoding.UTF8.GetString(data, 0, bytes);
Console.WriteLine($"✅ Received from server: {responseData}");
}
catch (SocketException ex) when (ex.ErrorCode == 10061) // WSAECONNREFUSED
{
Console.WriteLine($"❌ Connection refused. Please verify:\n" +
$" • Server is running and bound to {serverAddress}:{port}\n" +
$" • Server is NOT bound to 127.0.0.1\n" +
$" • Firewall allows inbound traffic on port {port}");
}
catch (Exception ex)
{
Console.WriteLine($"❌ Error: {ex.Message}");
}
}? 关键检查清单（排错必备）
| 检查项 | 方法 | 说明 |
|---|---|---|
| 服务端是否真正运行？ | netstat -an \| findstr :1026（Windows）或 ss -tuln \| grep :1026（Linux/macOS） | 查看 LISTEN 状态及绑定地址（应为 *:1026 或 192.168.x.x:1026，绝不能是 127.0.0.1:1026） |
| IP地址是否正确？ | 在服务端机器执行 ipconfig（Win）或 ifconfig（macOS/Linux），取 IPv4 地址（非 127.0.0.1） | 客户端必须使用该地址，而非 localhost |
| 端口是否被占用？ | netstat -ano \| findstr :1026 → 查 PID → 任务管理器结束冲突进程 | 确保无其他程序占用了 1026 端口 |
| 防火墙是否放行？ | 临时关闭防火墙测试；或添加入站规则允许 TCP 1026 | Windows：控制面板 → Windows Defender 防火墙 → 高级设置 → 入站规则 → 新建规则 |
? 总结
- 127.0.0.1 是纯本地回环地址，任何跨设备通信都必须替换为服务端的实际局域网IP或 0.0.0.0；
- 错误 actively refused 的本质是 “端口无监听”，而非网络层不通；
- 始终优先验证服务端监听状态（netstat/ss），再排查代码逻辑；
- 生产环境建议增加超时控制、异常细分处理和日志输出，提升可维护性。
遵循以上配置后，C# 客户端即可稳定连接 Python 服务端，为后续分布式通信打下坚实基础。
