消息确认与输入校验
🎯 引言
用户发送了空消息,服务器应该拒绝并告诉用户原因。如果服务器迟迟没有回复,客户端也不能一直等待。本篇把“处理结果”与每次发送关联起来,实现成功、业务拒绝和等待超时三种反馈。
🧱 确认回调有什么用
Socket.IO 允许发送方在 emit 的最后传一个函数,接收方处理后调用对应的确认函数,把结果送回这一次请求。这个机制叫 Acknowledgement,通常简称 ack。
本例约定成功返回 { ok: true },拒绝返回 { ok: false, error: '原因' }。这些字段由应用设计,Socket.IO 负责传递它们。
🛠 服务端先检查,再确认
用下面代码替换 server.mjs 原有的 chat:send 监听。每条消息去掉首尾空格后必须有内容,且最多 100 个 JavaScript 字符长度单位。
socket.on('chat:send', (text, reply) => {
if (typeof reply !== 'function') {
return;
}
if (typeof text !== 'string' || !text.trim() || text.trim().length > 100) {
reply({ ok: false, error: '请输入 1~100 个字符' });
return;
}
socket.emit('chat:message', text.trim());
reply({ ok: true });
});
reply 是这里给确认函数取的名字。类型检查保证旧客户端没有传确认参数时也不会导致服务端抛错。校验拒绝后立即 return,避免继续发送消息或第二次确认。
即使客户端限制输入,服务器仍应检查实际收到的数据,因为客户端代码可以被修改。部分 emoji 的 length 大于 1,练习先使用普通汉字或英文字母。
客户端最多等三秒
在 client.mjs 的 connect 回调中,把原来的 emit 替换为以下代码。
socket.timeout(3000).emit('chat:send', '你好', (error, result) => {
if (error) {
console.log('等待确认超时,处理结果还不确定');
return;
}
console.log(result.ok ? '服务端已接受' : `服务端拒绝:${result.error}`);
});
timeout(3000) 以毫秒设置本次确认的等待上限。启用超时后,第一个回调参数是等待错误,第二个才是服务端返回的数据。服务端返回 ok: false 时,确认已经到达,所以不会进入超时分支。确认与超时文档
🧰 对照三种结果
重启两端,先用代码中的“你好”验证成功。再把 emit 的消息参数改成三个空格,重新运行客户端,验证拒绝。
| 操作 | 消息回传 | 本次确认 |
|---|---|---|
| 发送“你好” | 收到 你好 | 服务端已接受 |
| 发送空格 | 没有消息 | 服务端拒绝,并说明原因 |
| 临时删掉成功分支的 reply 后发送 | 仍收到消息 | 约三秒后超时 |
第三行测试时只注释掉 reply({ ok: true }),保留 socket.emit。它展示了服务端处理过消息但调用方没有得到确认的情况。恢复代码后重新启动服务。
❓ 知识问答
Q1:成功确认是不是表示其他用户已经读过消息?
本例的成功仅表示服务端校验通过并执行了回传。若需要已读状态,必须由接收用户另外报告阅读结果。
Q2:超时后直接重发会怎样?
可能产生重复消息,因为上一次处理也许已经完成。需要可靠重试时,应给同一次提交固定的请求 ID,并在服务端检查是否处理过。课程的消息补取一篇会区分遗漏与重复。
🧪 小练习
增加“禁止发送纯数字消息”的服务端规则。将客户端 emit 的消息参数设为“123”应收到拒绝,改为“订单123”应成功。让无效内容明确返回原因,保证每次发送只调用一次确认函数。
🎉 每次发送现在都有可以验证的处理结果和等待上限。
