多人游戏与网络同步 / 系统课时

跑通客户端到服务端的技能请求

跑通客户端到服务端的技能请求

这一节只实现最小闭环:客户端生成技能请求并发送,服务端接收后验证和执行,再把确认序号与战斗结果返回客户端。先把这条链路跑通,后续加入预测、重试、延迟补偿时才有清晰的故障边界。

学习目标

  • 识别一次技能请求从发送到回包的关键阶段
  • 用最小 HTTP 示例验证请求、执行与响应闭环
  • 根据日志区分发送失败、服务端拒绝和执行异常

先定义闭环而不是只定义发送

“客户端成功发包”不能证明技能同步已经工作。完整链路至少要出现四个可观察事件:客户端发送、服务端接收、战斗逻辑执行、客户端收到结果。任何一步缺失,都应该被当成未闭环。

技能请求可以携带 seq、actorId、skillId 和技能所需输入;响应则返回服务端是否接受、累计确认到哪个序号,以及服务端真正算出的结果。客户端不应把自己预测出的伤害或最终生命值当成权威请求字段。

客户端技能请求从发送到服务端执行再回传结果的时序

用最小程序跑通请求和执行

下面示例只使用 Node.js 内置模块和 fetch,需要 Node.js 18 或更高版本。程序先启动一个临时端口的 HTTP 服务端,再由同一进程模拟客户端发送 fireball 请求。服务端校验字段后执行固定伤害,并返回 ackSeq 与权威生命值。

js
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();
});

预期输出:

text
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 做幂等处理,避免超时重试导致技能执行两次。最小闭环跑通后的验收标准很明确:同一个序号能够依次出现在发送、接收、执行和响应四个阶段,客户端最终采用的是服务端计算出来的权威结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

跑通客户端到服务端的技能请求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通