多人游戏与网络同步 / 系统课时
跑通客户端到服务端的技能请求
跑通客户端到服务端的技能请求
这一节只实现最小闭环:客户端生成技能请求并发送,服务端接收后验证和执行,再把确认序号与战斗结果返回客户端。先把这条链路跑通,后续加入预测、重试、延迟补偿时才有清晰的故障边界。
学习目标
- 识别一次技能请求从发送到回包的关键阶段
- 用最小 HTTP 示例验证请求、执行与响应闭环
- 根据日志区分发送失败、服务端拒绝和执行异常
先定义闭环而不是只定义发送
“客户端成功发包”不能证明技能同步已经工作。完整链路至少要出现四个可观察事件:客户端发送、服务端接收、战斗逻辑执行、客户端收到结果。任何一步缺失,都应该被当成未闭环。
技能请求可以携带 seq、actorId、skillId 和技能所需输入;响应则返回服务端是否接受、累计确认到哪个序号,以及服务端真正算出的结果。客户端不应把自己预测出的伤害或最终生命值当成权威请求字段。

用最小程序跑通请求和执行
下面示例只使用 Node.js 内置模块和 fetch,需要 Node.js 18 或更高版本。程序先启动一个临时端口的 HTTP 服务端,再由同一进程模拟客户端发送 fireball 请求。服务端校验字段后执行固定伤害,并返回 ackSeq 与权威生命值。
const http = require("node:http");
const server = http.createServer((req, res) => {
if (req.method !== "POST" || req.url !== "/skill") {
res.writeHead(404).end();
return;
}
let body = "";
req.setEncoding("utf8");
req.on("data", chunk => {
body += chunk;
});
req.on("end", () => {
const command = JSON.parse(body);
console.log(`server received seq=${command.seq}`);
if (!Number.isInteger(command.seq) || command.skillId !== "fireball") {
res.writeHead(400, { "content-type": "application/json" });
res.end(JSON.stringify({ accepted: false, reason: "invalid command" }));
return;
}
const targetHpBefore = 100;
const damage = 35;
const targetHp = Math.max(0, targetHpBefore - damage);
console.log(`server executed seq=${command.seq}`);
res.writeHead(200, { "content-type": "application/json" });
res.end(JSON.stringify({
accepted: true,
ackSeq: command.seq,
result: { damage, targetHp }
}));
});
});
server.listen(0, "127.0.0.1", async () => {
const address = server.address();
const port = address.port;
console.log(`server listening on ${port}`);
const command = {
seq: 17,
actorId: "player-1",
skillId: "fireball",
input: { targetId: "enemy-9" }
};
console.log(`client sending seq=${command.seq}`);
const response = await fetch(`http://127.0.0.1:${port}/skill`, {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify(command)
});
const result = await response.json();
console.log(`client received status=${response.status}`);
console.log(JSON.stringify(result));
server.close();
});预期输出:
server listening on <PORT>
client sending seq=17
server received seq=17
server executed seq=17
client received status=200
{"accepted":true,"ackSeq":17,"result":{"damage":35,"targetHp":65}}<PORT> 是操作系统分配的临时端口,实际运行时会显示具体数字。其余输出与示例中的固定请求一致。
用确认序号判断请求是否真正闭环
响应中的 ackSeq=17 不只是“请求成功”的标志,它还把响应明确关联回客户端的第 17 条战斗指令。客户端可以据此把这条指令从待确认队列移除,并判断更早的输入是否已经处理。
不要仅根据 HTTP 200 就播放最终战斗结果。更稳妥的客户端处理顺序是先验证响应对应的会话和序号,再读取 accepted,最后采用服务端返回的权威结果。若网络层成功但 accepted=false,技能仍然属于业务拒绝,而不是执行成功。
按阶段定位没有回包的问题
排查时不要从“技能没放出来”直接跳到战斗逻辑。先沿链路找最后一个已经出现的证据:客户端是否记录了 client sending,服务端是否记录了 server received,执行器是否出现 server executed,客户端最终是否读到响应。
如果客户端有发送日志但服务端没有接收,应优先检查地址、连接和传输层;服务端已经接收却没有执行,检查参数验证、重复请求过滤和技能前置条件;服务端已经执行但客户端没收到结果,则检查响应发送、连接中断以及请求超时。
真实项目还应让一次技能请求携带会话标识或请求 ID,并对重复 seq 做幂等处理,避免超时重试导致技能执行两次。最小闭环跑通后的验收标准很明确:同一个序号能够依次出现在发送、接收、执行和响应四个阶段,客户端最终采用的是服务端计算出来的权威结果。