写Unity网络这块,尤其是服务端,常有一种尴尬:客户端教程一抓一大把,什么RPC、SyncVar、NetworkTransform讲得头头是道,可真到了要自己搭一个服务端、跑通一条完整消息链路的时候,很多人直接卡住。不是不会写C#,而是不知道服务端该管哪些事、消息怎么设计、连接怎么维护。这篇东西就是冲着这个问题来的,我直接把一个能跑通的基础服务端代码从零拆给你看,用C#写、走TCP、配长度前缀协议,顺便把心跳、粘包、半包、掉线重连这些坑都填上。适合刚接触Unity网络、想自己动手写服务端而不是只会调库的开发者。
1. 先想清楚:Unity服务端到底要管哪些事?
很多Unity开发者第一次接触网络,是照着教程在客户端里拖一个NetworkManager,点一下Play就能看到两个玩家动起来。这时候服务端是框架帮你藏起来的,你根本不知道它做了什么。一旦你想自己做联机,或者想接入自己的服务器,立刻就会撞上一堵墙:服务器代码到底从哪下手?
我给你的答案是:先别急着写代码,把服务端的职责拆清楚。
一个最基础的服务端,日常就干四件事:管连接、收消息、发消息、维护状态。管连接是接受客户端进来、处理客户端断开;收消息是把客户端发过来的字节流还原成一条条有意义的数据;发消息是给指定客户端或所有客户端广播数据;维护状态则是服务端自己留下一份"权威数据",比如玩家坐标、血量、房间信息。大部分所谓"网络卡了"的问题,本质上都是这四件事里某一件没做好。
Unity客户端和服务端最大的思维差异就在这里:客户端的所有操作都是围绕本地表现来的,一个人、一台机器、一个画面;服务端则要同时面对几十上百个连接,每条消息都要判断"这条该转给谁"。你可以把服务端想象成一个前台,所有人都找它说话,它得记清每个房间住着谁,还得保证传话不传错。
技术选型上,我建议服务端直接用C#写控制台程序,用.NET 6以上版本。不要引入Mirror、Photon这些现成框架,原因很简单:你要学的是原理,不是API用法。用原始Socket写一遍,你才能理解为什么框架要帮你做那些封装。而且C#写服务端有一个天然优势:协议类、消息定义可以直接和Unity客户端共用一套C#代码,不用像Node或Java那样维护两套定义。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 一个最小可运行的服务端骨架:监听、接入与消息循环
服务端最基本的骨架,就是监听端口、接受连接、然后给每个连接开一条消息处理通道。下面这套代码是我实际项目里最常用的基底,删掉了业务逻辑,只保留网络骨架。
csharp复制// Server.cs
using System.Net;
using System.Net.Sockets;
using System.Text;
public class GameServer
{
private TcpListener _listener;
private readonly Dictionary<int, ClientConnection> _clients = new();
private int _nextClientId = 1;
private bool _isRunning;
public async Task StartAsync(int port)
{
_listener = new TcpListener(IPAddress.Any, port);
_listener.Start();
_isRunning = true;
Console.WriteLine($"[Server] listening on port {port}");
while (_isRunning)
{
try
{
TcpClient tcpClient = await _listener.AcceptTcpClientAsync();
ClientConnection conn = new ClientConnection(tcpClient, _nextClientId, OnClientMessage, OnClientDisconnected);
_clients[_nextClientId] = conn;
Console.WriteLine($"[Server] client #{_nextClientId} connected, total {_clients.Count}");
_ = conn.StartAsync();
_nextClientId++;
}
catch (Exception ex)
{
Console.WriteLine($"[Server] accept error: {ex.Message}");
}
}
}
private void OnClientMessage(int clientId, string message)
{
Console.WriteLine($"[Server] from #{clientId}: {message}");
// 在这里做消息分发和业务处理
}
private void OnClientDisconnected(int clientId)
{
if (_clients.Remove(clientId))
{
Console.WriteLine($"[Server] client #{clientId} disconnected, total {_clients.Count}");
}
}
}
核心逻辑就三行:AcceptTcpClientAsync 等连接进来;进来之后包一个 ClientConnection 存到字典里;然后开一个不阻塞主循环的任务去处理这个连接。
这里有个初学者特别容易犯的错误:在 while 循环里同步调用 AcceptTcpClient()。这样一旦有客户端连上,服务端就会卡在消息处理上,别的客户端就进不来了。用 AcceptTcpClientAsync
