基于Socket.io实现师生专属聊天功能遇到问题求助

1. 先把身份和关联关系存好 #

不管用内存还是数据库，后端必须维护两个核心数据：

• 用户角色：标记每个用户是学生还是教师
• 关联关系：记录每个教师对应的学生列表，以及每个学生对应的教师

示例代码（开发阶段用内存存储）：

// 存储用户角色
const userRoles = {
  "tea_001": "teacher",
  "stu_001": "student",
  "stu_002": "student"
};
// 存储关联关系：key是用户ID，value是可聊天的对象ID数组
const chatRelations = {
  "tea_001": ["stu_001", "stu_002"],
  "stu_001": ["tea_001"],
  "stu_002": ["tea_001"]
};

2. 连接时绑定用户ID与Socket实例 #

用户连接Socket时，必须带上自己的用户ID和角色（通过握手参数传递即可），后端要把用户ID和对应的socket实例映射起来，方便后续定位接收方：

const userIdToSocket = new Map();

io.on('connection', (socket) => {
  const { userId, role } = socket.handshake.query;
  // 存下用户ID和socket的对应关系
  userIdToSocket.set(userId, socket);

  // 给当前用户返回可聊天的联系人列表
  socket.on('get_available_contacts', () => {
    const contacts = chatRelations[userId] || [];
    socket.emit('contacts_list', contacts);
  });
});

3. 发送消息前做权限校验 #

这是实现需求的关键——不能直接照搬示例的私聊逻辑，必须加一层权限判断，只有发送方和接收方在关联关系列表里，才允许转发消息：

socket.on('send_private_msg', ({ toUserId, content }) => {
  const senderId = socket.handshake.query.userId;
  // 校验：发送方的可聊列表里有没有接收方
  const allowedContacts = chatRelations[senderId] || [];
  if (!allowedContacts.includes(toUserId)) {
    socket.emit('msg_error', '你无权和该用户聊天');
    return;
  }

  // 找到接收方的socket实例发送消息
  const receiverSocket = userIdToSocket.get(toUserId);
  if (receiverSocket) {
    receiverSocket.emit('private_msg', { from: senderId, content });
    // 给发送方返回发送成功的回执
    socket.emit('msg_sent', { to: toUserId, content });
  } else {
    socket.emit('msg_error', '对方当前不在线');
  }
});

4. 前端配合逻辑 #

• 用户登录后，立即触发get_available_contacts事件，拿到自己能聊的联系人列表并渲染；
• 选择联系人后，调用send_private_msg事件发送消息；
• 监听private_msg事件接收消息，监听msg_error事件处理异常提示。

内容的提问来源于stack exchange，提问作者Coobie