- 一、WebSocket：实时通信的"高速公路"
- - 1.1 HTTP的短板：永远的"单相思"
  - 1.2 WebSocket的优势：真正的"双向对话"
- 二、30分钟搭建聊天服务器
- - 2.1 环境准备
  - 2.2 WebSocket配置类
  - 2.3 核心消息处理器
- 三、前端实现：比AJAX简单多了！
- - 3.1 HTML骨架
- 四、进阶功能：让聊天室更专业
- - 4.1 用户认证（带Token的连接）
  - 4.2 私聊功能
  - 4.3 在线用户列表
- 五、性能优化：应对高并发场景
- - 5.1 二进制消息传输（适合传输文件）
  - 5.2 心跳检测（防止连接假死）
- 六、生产环境注意事项
- - 6.1 负载均衡：需要支持WebSocket的LB（如Nginx）
  - 6.2 SSL安全：务必使用WSS
  - 6.3 连接管理：实现重连机制
  - 6.4 消息压缩：减少带宽消耗
- 七、WebSocket的替代方案
- 八、常见问题排雷
- 结语：从聊天室到实时世界的桥梁

“为什么我的页面要不停刷新才能看到新消息？” —— 如果你还在为这种用户体验头疼，那么WebSocket就是你的解药！今天，我要带你用WebSocket打造一个真正的实时聊天应用，告别落后的轮询时代，体验丝滑般的即时通讯。

一、WebSocket：实时通信的"高速公路"

1.1 HTTP的短板：永远的"单相思"

传统HTTP就像写信交流：

客户端：“有新消息吗？”（请求）
服务器：“没有”（响应）
（重复100次…）
客户端：“有新消息吗？”
服务器：“有！”（终于等到你）

这种轮询(Polling)方式不仅低效，还浪费资源！

1.2 WebSocket的优势：真正的"双向对话"

WebSocket建立了持久化的全双工通道：

一次握手，长久连接
服务器可以主动推送
低延迟，高效能
节省带宽（无需重复HTTP头）

二、30分钟搭建聊天服务器

2.1 环境准备

# 使用Spring Boot快速启动
spring init --dependencies=websocket,lombok websocket-chat

2.2 WebSocket配置类


@Configuration
@EnableWebSocket
public class WebSocketConfig implements WebSocketConfigurer {@Overridepublic void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {registry.addHandler(chatHandler(), "/chat").setAllowedOrigins("*"); // 允许跨域}@Beanpublic WebSocketHandler chatHandler() {return new ChatWebSocketHandler();}
}

2.3 核心消息处理器

public class ChatWebSocketHandler extends TextWebSocketHandler {private static final List<WebSocketSession> sessions = new CopyOnWriteArrayList<>();@Overridepublic void afterConnectionEstablished(WebSocketSession session) {sessions.add(session);broadcast("系统: " + session.getId() + " 加入聊天室");}@Overrideprotected void handleTextMessage(WebSocketSession session, TextMessage message) {String msg = session.getId() + ": " + message.getPayload();broadcast(msg);}@Overridepublic void afterConnectionClosed(WebSocketSession session, CloseStatus status) {sessions.remove(session);broadcast("系统: " + session.getId() + " 离开聊天室");}private void broadcast(String message) {sessions.forEach(session -> {try {session.sendMessage(new TextMessage(message));} catch (IOException e) {e.printStackTrace();}});}
}

三、前端实现：比AJAX简单多了！

3.1 HTML骨架

<!DOCTYPE html>
<html>
<head><title>实时聊天室</title><style>#chatBox {height: 300px;border: 1px solid #ccc;overflow-y: scroll;}#msgInput {width: 80%;}</style>
</head>
<body>
<div id="chatBox"></div>
<input id="msgInput" type="text" placeholder="输入消息...">
<button onclick="sendMessage()">发送</button><script>const chatBox = document.getElementById('chatBox');const msgInput = document.getElementById('msgInput');let socket;function connect() {socket = new WebSocket('ws://' + window.location.host + '/chat');socket.onopen = () => appendMessage('系统: 连接已建立');socket.onmessage = (event) => appendMessage(event.data);socket.onclose = () => appendMessage('系统: 连接已关闭');}function sendMessage() {if (socket && msgInput.value) {socket.send(msgInput.value);msgInput.value = '';}}function appendMessage(message) {const p = document.createElement('p');p.textContent = message;chatBox.appendChild(p);chatBox.scrollTop = chatBox.scrollHeight;}// 页面加载时自动连接window.onload = connect;
</script>
</body>
</html>

四、进阶功能：让聊天室更专业

4.1 用户认证（带Token的连接）

后端改造：


@Override
public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {registry.addHandler(chatHandler(), "/chat").setAllowedOrigins("*").addInterceptors(new AuthHandshakeInterceptor());
}public class AuthHandshakeInterceptor implements HandshakeInterceptor {@Overridepublic boolean beforeHandshake(ServerHttpRequest request, ServerHttpResponse response, WebSocketHandler wsHandler, Map<String, Object> attributes) {String token = ((ServletServerHttpRequest) request).getServletRequest().getParameter("token");return validateToken(token); // 实现你的验证逻辑}// ... afterHandshake方法
}

前端连接：

socket = new WebSocket(`ws://${window.location.host}/chat?token=${userToken}`);

4.2 私聊功能

消息格式改造：

{"type": "private","target": "user123","content": "晚上一起吃饭？"
}

后端处理：


@Getter
@Setter
class ChatMessage {private String type;private String from;private String target;private String content;
}// 在Handler中
private void handleJsonMessage(WebSocketSession session, String json) {ChatMessage msg = objectMapper.readValue(json, ChatMessage.class);if ("private".equals(msg.getType())) {sendToUser(msg.getTarget(), msg.getFrom() + "(私信): " + msg.getContent());}// ... 其他类型处理
}

4.3 在线用户列表

后端实现：

private static final Map<String, WebSocketSession> userSessions = new ConcurrentHashMap<>();@Override
public void afterConnectionEstablished(WebSocketSession session) {String username = getUsernameFromSession(session);userSessions.put(username, session);broadcastUserList();
}private void broadcastUserList() {String userList = objectMapper.writeValueAsString(userSessions.keySet());broadcast("USER_LIST:" + userList);
}

前端展示：

socket.onmessage = (event) => {if (event.data.startsWith('USER_LIST:')) {updateUserList(JSON.parse(event.data.substring(10)));} else {appendMessage(event.data);}
};

五、性能优化：应对高并发场景

5.1 二进制消息传输（适合传输文件）

// 二进制处理器
public class BinaryWebSocketHandler extends BinaryWebSocketHandler {@Overrideprotected void handleBinaryMessage(WebSocketSession session, BinaryMessage message) {byte[] payload = message.getPayload().array();// 处理二进制数据（如图片、文件）}
}// 前端发送
const fileReader = new FileReader();
fileReader.onload = () => {socket.send(fileReader.result);
};
fileReader.readAsArrayBuffer(file);

5.2 心跳检测（防止连接假死）

// 心跳处理器
public class HeartbeatWebSocketHandler extends TextWebSocketHandler {@Overrideprotected void handleTextMessage(WebSocketSession session, TextMessage message) {if ("PING".equals(message.getPayload())) {session.sendMessage(new TextMessage("PONG"));}// ... 其他消息处理}
}// 前端定时发送
setInterval(() => {if (socket.readyState === WebSocket.OPEN) {socket.send("PING");}
}, 30000);

六、生产环境注意事项

6.1 负载均衡：需要支持WebSocket的LB（如Nginx）

location /chat {proxy_pass http://backend;proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";
}

6.2 SSL安全：务必使用WSS

new WebSocket('wss://yourdomain.com/chat');

6.3 连接管理：实现重连机制

function connect() {socket = new WebSocket(...);socket.onclose = () => setTimeout(connect, 5000); // 5秒后重连
}

6.4 消息压缩：减少带宽消耗

config.setCompressionEnabled(true); // 服务端启用压缩

七、WebSocket的替代方案

技术	优点	缺点
SSE	服务器单向推送简单	不支持双向通信
长轮询	兼容性极好	高延迟，高开销
MQTT	轻量级，适合IoT	需要额外Broker
gRPC	高性能，支持流式通信	复杂度高