1.\u540e\u53f0<\/h2>\n1.1 \u5f00\u542fwebsocket\u3001sse<\/h3>\n
\u5728\u00a0application.yml \u4e2d，\u627e\u5230 sse \u53ca\u00a0websocket \u7684\u914d\u7f6e\u9879，\u5c06\u00a0enabled \u7684\u503c\u6539\u4e3a true<\/p>\n
![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/01\/20260121045844-69705d043981f.png\")
<\/p>\n<\/p>\n
1.2 \u4e1a\u52a1\u6a21\u5757\u5f15\u5165 websocket \u4f9d\u8d56<\/h3>\n
\u4e1a\u52a1\u6a21\u5757\u5728\u00a0ruoyi-modules \u4e0b，\u5982：ruoyi-xxx<\/p>\n
<dependency>
\n<groupId>org.dromara<\/groupId>
\n<artifactId>ruoyi-common-websocket<\/artifactId>
\n<\/dependency> <\/p>\n
ruoyi-common-websocket \u4e3a\u82e5\u4f9d\u6846\u67b6\u81ea\u5e26\u7684\u516c\u5171\u7ec4\u4ef6，\u4f4d\u4e8e\u00a0ruoyi-common \u4e0b\u3002<\/p>\n
1.3\u00a0websocket \u914d\u7f6e\u7c7b<\/h3>\n
import org.springframework.context.annotation.Bean;
\nimport org.springframework.context.annotation.Configuration;
\nimport org.springframework.web.socket.config.annotation.EnableWebSocket;
\nimport org.springframework.web.socket.server.standard.ServerEndpointExporter;<\/p>\n
@Configuration
\n@EnableWebSocket
\npublic class HisWebSocketConfig {
\n @Bean
\n public ServerEndpointExporter serverEndpointExporter() {
\n return new ServerEndpointExporter();
\n }
\n} <\/p>\n
1.4\u00a0websocket \u6d88\u606f\u63a5\u6536\u3001\u5904\u7406<\/h3>\n
import com.alibaba.fastjson.JSON;
\nimport com.alibaba.fastjson.serializer.SerializerFeature;
\nimport jakarta.annotation.PostConstruct;
\nimport jakarta.annotation.Resource;
\nimport jakarta.websocket.OnClose;
\nimport jakarta.websocket.OnError;
\nimport jakarta.websocket.OnMessage;
\nimport jakarta.websocket.OnOpen;
\nimport jakarta.websocket.Session;
\nimport jakarta.websocket.server.ServerEndpoint;
\nimport lombok.extern.slf4j.Slf4j;
\nimport org.apache.commons.lang3.StringUtils;
\nimport org.dromara.common.core.enums.FormatsType;
\nimport org.dromara.common.core.utils.DateUtils;
\nimport org.dromara.common.core.utils.JsonUtils;
\nimport org.dromara.common.core.utils.SpringUtils;
\nimport org.dromara.common.mybatis.core.page.TableDataInfo;
\nimport org.dromara.common.websocket.utils.WebSocketUtils;<\/p>\n
import org.springframework.stereotype.Component;<\/p>\n
import java.util.Collections;
\nimport java.util.HashMap;
\nimport java.util.HashSet;
\nimport java.util.List;
\nimport java.util.Map;
\nimport java.util.Set;<\/p>\n
\/**
\n * websocket \u6d88\u606f\u5904\u7406
\n *
\n * @author
\n * @date 2026\/1\/16 \u661f\u671f\u4e94
\n * @since JDK 17
\n *\/
\n@Slf4j
\n@Component
\n@ServerEndpoint("\/websocket\/message")
\npublic class HisWebSocketServer {
\n@Resource
\nprivate IWebsocketService websocketService;<\/p>\n
\/**
\n * \u9759\u6001\u53d8\u91cf，\u7528\u6765\u8bb0\u5f55\u5f53\u524d\u5728\u7ebf\u8fde\u63a5\u6570\u3002\u5e94\u8be5\u628a\u5b83\u8bbe\u8ba1\u6210\u7ebf\u7a0b\u5b89\u5168\u7684\u3002
\n *\/
\n private static int onlineCount = 0;<\/p>\n
\/**
\n * \u5b58\u50a8\u5728\u7ebf\u4f1a\u8bdd. concurrent\u5305\u7684\u7ebf\u7a0b\u5b89\u5168Set，\u7528\u6765\u5b58\u653e\u6bcf\u4e2a\u5ba2\u6237\u7aef\u5bf9\u5e94\u7684MyWebSocket\u5bf9\u8c61\u3002
\n *\/
\n private static final Set<Session> SESSIONS = Collections.synchronizedSet(new HashSet<>());<\/p>\n
\/**
\n * \u521d\u59cb\u5316\u65b9\u6cd5，\u8ba2\u9605WebSocket\u6d88\u606f\u4e3b\u9898
\n *\/
\n @PostConstruct
\n public void init() {
\n log.info("\u521d\u59cb\u5316HisWebSocketServer, \u8ba2\u9605WebSocket\u6d88\u606f\u4e3b\u9898");
\n \/\/ \u8ba2\u9605WebSocket\u6d88\u606f
\n WebSocketUtils.subscribeMessage((message) -> {
\n log.info("HisWebSocketServer\u6536\u5230\u8ba2\u9605\u6d88\u606f: {}", message);
\n \/\/ \u53d1\u9001\u6d88\u606f\u7ed9\u6240\u6709\u8fde\u63a5\u7684\u5ba2\u6237\u7aef
\n HisWebSocketServer.sendMessageToAll(message.getMessage());
\n });
\n }<\/p>\n
\/**
\n * \u8fde\u63a5\u5efa\u7acb\u6210\u529f\u8c03\u7528\u7684\u65b9\u6cd5
\n *\/
\n@OnOpen
\npublic void onOpen(Session session) {
\n\/\/ log.info("Websocket\u8fde\u63a5\u5efa\u7acb\u6210\u529f");
\n \/\/ \u6dfb\u52a0\u4f1a\u8bdd\u5230\u96c6\u5408\u4e2d
\n SESSIONS.add(session);
\n \/\/ \u5728\u7ebf\u6570\u52a01
\n addOnlineCount();
\n}<\/p>\n
@OnClose
\npublic void onClose(Session session) {
\n\/\/ log.info("Websocket\u8fde\u63a5\u5173\u95ed");
\n \/\/ \u4ece\u96c6\u5408\u4e2d\u79fb\u9664\u4f1a\u8bdd
\n SESSIONS.remove(session);
\n \/\/ \u5728\u7ebf\u6570\u51cf1
\n subOnlineCount();
\n}<\/p>\n
\/**
\n * \u629b\u51fa\u5f02\u5e38\u65f6\u5904\u7406
\n *\/
\n@OnError
\npublic void onError(Session session, Throwable exception) throws Exception {
\nlog.error("Websocket\u629b\u51fa\u5f02\u5e38\u65f6\u5904\u7406.", exception);
\n \/\/ \u4ece\u96c6\u5408\u4e2d\u79fb\u9664\u51fa\u9519\u7684\u4f1a\u8bdd
\n SESSIONS.remove(session);
\n \/\/ \u5728\u7ebf\u6570\u51cf1
\n subOnlineCount();
\n}<\/p>\n
\/**
\n * \u670d\u52a1\u5668\u63a5\u6536\u5230\u5ba2\u6237\u7aef\u6d88\u606f\u65f6\u8c03\u7528\u7684\u65b9\u6cd5
\n *\/
\n@OnMessage
\npublic void onMessage(String message, Session session) {
\nlog.info("Websocket\u63a5\u6536\u5230\u5ba2\u6237\u7aef\u6d88\u606f.sessionId:{}, \u6d88\u606f:{}", session.getId(), message);<\/p>\n
if (StringUtils.isBlank(message)) {
\nlog.info("Websocket\u63a5\u6536\u5230\u7684\u5ba2\u6237\u7aef\u6d88\u606f\u4e3a\u7a7a,\u4e0d\u505a\u5904\u7406.sessionId:{}", session.getId());
\n try {
\n Map<String, Object> result = new HashMap<>(3);
\n result.put("code", "400");
\n result.put("msg", "\u6d88\u606f\u4e0d\u80fd\u4e3a\u7a7a");
\n result.put("data", "");
\n session.getBasicRemote().sendText(JSON.toJSONString(result));
\n } catch (Exception e) {
\n log.error("Websocket\u63a5\u6536\u5230\u5ba2\u6237\u7aef\u6d88\u606f-\u5f02\u5e38:{}", e.getMessage(), e);
\n }
\nreturn;
\n}
\ntry {
\n\/\/ JSON\u683c\u5f0f
\nString regex = "^(\\\\\\\\{.*\\\\\\\\}|\\\\\\\\[.*\\\\\\\\])$";<\/p>\n
if (!message.matches(regex)) {
\nlog.info("Websocket\u63a5\u6536\u5230\u7684\u5ba2\u6237\u7aef\u6d88\u606f\u4e0d\u662fJSON\u683c\u5f0f,\u4e0d\u505a\u5904\u7406.sessionId:{}, \u6d88\u606f:{}", session.getId(), message);
\n Map<String, Object> result = new HashMap<>(3);
\n result.put("code", "400");
\n result.put("msg", "\u6d88\u606f\u4e0d\u662fJSON\u683c\u5f0f");
\n result.put("data", "");
\n session.getBasicRemote().sendText(JSON.toJSONString(result));
\nreturn;
\n}
\n \/\/ \u5904\u7406\u4e1a\u52a1\u903b\u8f91
\n this.handleBizLogic(message, session);
\n\/\/ session.getBasicRemote().sendText("\u670d\u52a1\u5668\u5df2\u6536\u5230\u6d88\u606f");
\n} catch (Exception e) {
\nlog.error("Websocket\u63a5\u6536\u5230\u5ba2\u6237\u7aef\u6d88\u606f\u5904\u7406-\u5f02\u5e38:{}", e.getMessage(), e);
\n}
\n}<\/p>\n
\/**
\n * \u5904\u7406\u4e1a\u52a1\u903b\u8f91
\n *
\n * @date 2026-01-17
\n * @param message \u5ba2\u6237\u7aef\u6d88\u606f
\n * @param session \u4f1a\u8bdd
\n * @since JDK 17
\n * @author
\n *\/
\nprivate void handleBizLogic(String message, Session session) throws Exception {
\n \/\/ \u5ba2\u6237\u7aef\u8bf7\u6c42\u53c2\u6570
\n HisWebSocketReqVo reqVo = JSON.parseObject(message.trim(), HisWebSocketReqVo.class);
\n \/\/ TODO \u5177\u4f53\u4e1a\u52a1\u5904\u7406<\/p>\n
\/\/ \u53d1\u9001\u6d88\u606f\u5230\u5ba2\u6237\u7aef（\u524d\u7aef），\u53ef\u4ee5\u662fJSON\u683c\u5f0f，\u4e5f\u53ef\u4ee5\u662f\u5176\u4ed6\u683c\u5f0f，\u548c\u524d\u7aef\u5b9a\u597d\u5c31\u884c
\n session.getBasicRemote().sendText(JSON.toJSONString(bespeakList, SerializerFeature.WriteDateUseDateFormat));
\n}<\/p>\n
\/**
\n * \u83b7\u53d6\u5728\u7ebf\u8fde\u63a5\u6570
\n * @return \u5728\u7ebf\u8fde\u63a5\u6570
\n *\/
\n public static synchronized int getOnlineCount() {
\n return onlineCount;
\n }<\/p>\n
\/**
\n * \u5728\u7ebf\u8fde\u63a5\u6570\u52a01
\n *\/
\n public static synchronized void addOnlineCount() {
\n HisWebSocketServer.onlineCount++;
\n }<\/p>\n
\/**
\n * \u5728\u7ebf\u8fde\u63a5\u6570\u51cf1
\n *\/
\n public static synchronized void subOnlineCount() {
\n HisWebSocketServer.onlineCount–;
\n }<\/p>\n
\/**
\n * \u53d1\u9001\u6d88\u606f\u7ed9\u6240\u6709\u8fde\u63a5\u7684\u5ba2\u6237\u7aef
\n * @param message \u6d88\u606f\u5185\u5bb9
\n *\/
\n public static void sendMessageToAll(String message) {
\n log.info("\u53d1\u9001WebSocket\u6d88\u606f\u7ed9\u6240\u6709\u5ba2\u6237\u7aef, \u6d88\u606f\u5185\u5bb9: {}", message);
\n \/\/ \u5faa\u73af\u5728\u7ebf\u4f1a\u8bdd
\n for (Session session : SESSIONS) {
\n try {
\n if (session.isOpen()) {
\n session.getBasicRemote().sendText(message);
\n log.info("\u6210\u529f\u53d1\u9001WebSocket\u6d88\u606f\u7ed9\u5ba2\u6237\u7aef, sessionId: {}", session.getId());
\n } else {
\n log.warn("\u5ba2\u6237\u7aef\u8fde\u63a5\u5df2\u5173\u95ed, \u8df3\u8fc7\u53d1\u9001, sessionId: {}", session.getId());
\n \/\/ \u79fb\u9664\u5173\u95ed\u7684\u4f1a\u8bdd
\n SESSIONS.remove(session);
\n subOnlineCount();
\n }
\n } catch (Exception e) {
\n log.error("\u53d1\u9001WebSocket\u6d88\u606f\u7ed9\u5ba2\u6237\u7aef\u5931\u8d25, sessionId: {}, \u5f02\u5e38: {}", session.getId(), e.getMessage(), e);
\n }
\n }
\n }
\n}<\/p>\n
\u5728\u00a0@Component \u5f15\u5165\u00a0@Resource，websocketService=null，\u6240\u4ee5\u9700\u8981SpringUtils \u91cd\u65b0\u5b9e\u4f8b\u5316\u3002<\/p>\n
\u5177\u4f53\u7684\u4e1a\u52a1\u5904\u7406，\u5305\u62ec \u8c03\u7528service\u3001dao（mapper）\u7b49\u3002<\/p>\n
\u5230\u8fd9\u513f，\u540e\u53f0\u7684\u914d\u7f6e\u5c31\u5b8c\u6210\u4e86\u3002<\/p>\n<\/p>\n
2.\u524d\u7aef<\/h2>\n2.1 \u542f\u7528websocket\u3001sse<\/h3>\n
\u5168\u5c40\u641c\u7d22\u00a0VITE_APP_WEBSOCKET\u3001VITE_APP_SSE，\u5c06\u5176\u503c\u6539\u4e3a\u00a0true<\/p>\n
\u8fd9\u6837\u624d\u80fd\u8c03\u7528\u5230\u540e\u53f0\u670d\u52a1\u3002<\/p>\n
![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/01\/20260121045844-69705d045d7f8.png\")
<\/p>\n<\/p>\n
2.2 \u5f15\u5165websocket\u4f9d\u8d56<\/h3>\n
\u5728\u4f7f\u7528\u5230websocket\u7684\u9875\u9762，\u5f15\u5165\u4f9d\u8d56\u3002<\/p>\n
import { initWebSocket } from '@\/utils\/websocket'; <\/p>\n
2.3 \u5177\u4f53\u4ee3\u7801<\/h3>\n
\u5176\u4e2d\u7684\u00a0ws:\/\/127.0.0.1:18080\/websocket\/message \u5373\u4e3a\u540e\u53f0\u7684websocket \u94fe\u63a5\u3002<\/p>\n
（1）127.0.0.1:18080 \u4e3a\u540e\u53f0\u670d\u52a1\u7684IP\u3001\u7aef\u53e3\u53f7<\/p>\n
（2）\/websocket\/message \u4e3a\u540e\u53f0\u4ee3\u7801\u00a0HisWebSocketServer \u5b9a\u4e49\u7684\u3002<\/p>\n
\/\/ WebSocket\u8fde\u63a5
\nconst baseClassListSocket = ref<any>(null);<\/p>\n
\/\/ \u521d\u59cb\u5316
\nonMounted(async () => {
\n console.log('onMounted\u5f00\u59cb\u6267\u884c');<\/p>\n
\/\/ \u521b\u5efaWebSocket\u8fde\u63a5
\n console.log('\u5f00\u59cb\u521b\u5efaWebSocket\u8fde\u63a5');
\n baseClassListSocket.value = createBaseClassListSocket();
\n});<\/p>\n
\/\/ \u7ec4\u4ef6\u9500\u6bc1\u524d\u91cd\u7f6eisInitialized\u5e76\u5173\u95edWebSocket\u8fde\u63a5
\nonBeforeUnmount(() => {<\/p>\n
\/\/ \u5173\u95edWebSocket\u8fde\u63a5
\n if (baseClassListSocket.value) {
\n baseClassListSocket.value.close();
\n console.log('\u6392\u73ed\u5217\u8868WebSocket\u8fde\u63a5\u5df2\u5173\u95ed');
\n }
\n});<\/p>\n
\/\/ \u521b\u5efa\u6392\u73ed\u5217\u8868WebSocket\u8fde\u63a5
\nconst createBaseClassListSocket = () => {
\n \/\/ \u4f7f\u7528\u540e\u7aef\u63d0\u4f9b\u7684\u5b8c\u6574WebSocket\u5730\u5740
\n const wsUrl = 'ws:\/\/127.0.0.1:18080\/websocket\/message';
\n const connName = '\u6392\u73ed\u5217\u8868WebSocket';
\n console.log('\u521b\u5efa\u6392\u73ed\u5217\u8868WebSocket\u8fde\u63a5，URL:', wsUrl);
\n return initWebSocket(wsUrl, {
\n onConnected() {
\n console.log(`${connName}\u5df2\u7ecf\u8fde\u63a5`);
\n },
\n onDisconnected() {
\n console.log(`${connName}\u5df2\u7ecf\u65ad\u5f00`);
\n },
\n onMessage: (e) => {
\n console.log(`${connName}\u6536\u5230\u539f\u59cb\u6d88\u606f:`, e.data);
\n if (!e.data || e.data.indexOf('ping') > 0) {
\n return;
\n }
\n try {
\n const message = JSON.parse(e.data);
\n console.log(`${connName}\u6536\u5230\u89e3\u6790\u540e\u6d88\u606f:`, message);<\/p>\n
\/\/ \u5904\u7406\u6392\u73ed\u5217\u8868\u6d88\u606f
\n if (message.code === 200 && Array.isArray(message.data)) {
\n handleBaseClassListMessage(message.data);
\n }
\n } catch (error) {
\n console.error(`${connName}\u6d88\u606f\u89e3\u6790\u9519\u8bef:`, error);
\n }
\n }
\n });
\n};<\/p>\n
\/\/ \u5904\u7406\u6392\u73ed\u5217\u8868WebSocket\u6d88\u606f
\nconst handleBaseClassListMessage = (data: any[]) => {
\n \/\/ \u5408\u5e76\u7ed3\u679c，\u6784\u5efa\u6620\u5c04\u8868
\n const newMap: Record<string, any> = {};<\/p>\n
\/\/ \u5904\u7406\u6240\u6709\u6392\u73ed\u6570\u636e（\u5305\u62ec\u533b\u751f\u548c\u54a8\u8be2\u5e08）
\n data.forEach((userTypeGroup) => {
\n if (userTypeGroup?.list) {
\n userTypeGroup.list.forEach((user) => {
\n if (user?.userId && user?.baseWorkClassList) {
\n const userId = user.userId.toString();
\n const duty = user.duty?.toString() || '';<\/p>\n
\/\/ \u6839\u636eduty\u533a\u5206\u533b\u751f(1)\u548c\u54a8\u8be2\u5e08(11)
\n if (duty === '1') {
\n newMap[`doctor_${userId}`] = user.baseWorkClassList;
\n } else if (duty === '11') {
\n newMap[`consultant_${userId}`] = user.baseWorkClassList;
\n }
\n }
\n });
\n }
\n });<\/p>\n
userBaseClassMap.value = newMap;
\n};<\/p>\n
\/\/ \u52a0\u8f7d\u6392\u73ed\u4fe1\u606f
\nconst loadUserBaseClassList = async () => {
\n try {
\n isLoading.value = true;
\n let startDateStr, endDateStr;
\n if (boardViewMode.value === '\u65e5') {
\n startDateStr = dayjs(dayInfoList.value[0].date).format('YYYY-MM-DD');
\n endDateStr = startDateStr;
\n } else {
\n startDateStr = dayjs(dayInfoList.value[0].date).format('YYYY-MM-DD');
\n endDateStr = dayjs(dayInfoList.value[6].date).format('YYYY-MM-DD');
\n }<\/p>\n
\/\/ \u901a\u8fc7WebSocket\u53d1\u9001\u8bf7\u6c42
\n if (baseClassListSocket.value?.send) {
\n const requestData = {
\n startDate: startDateStr,
\n endDate: endDateStr,
\n duty: '' \/\/ \u7a7a\u5b57\u7b26\u4e32\u8868\u793a\u83b7\u53d6\u6240\u6709\u5c97\u4f4d
\n };<\/p>\n
baseClassListSocket.value.send(JSON.stringify(requestData));
\n console.log('\u6392\u73ed\u5217\u8868WebSocket\u8bf7\u6c42\u5df2\u53d1\u9001:', requestData);
\n } else {
\n console.error('\u6392\u73ed\u5217\u8868WebSocket\u8fde\u63a5\u672a\u5efa\u7acb');
\n }
\n } catch (error) {
\n console.error('\u52a0\u8f7d\u6392\u73ed\u4fe1\u606f\u5931\u8d25', error);
\n } finally {
\n isLoading.value = false;
\n }
\n}; <\/p>\n
3. Nginx\u914d\u7f6e<\/h2>\n
18080\u00a0 \u662f\u540e\u53f0\u63a5\u53e3\u7aef\u53e3\u53f7\u3002<\/p>\n
# \u666e\u901a API \u8bf7\u6c42
\nlocation \/dev-api\/ {
\n proxy_pass http:\/\/localhost:18080\/;
\n proxy_set_header Host $host;
\n proxy_set_header X-Real-IP $remote_addr;
\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
\n proxy_set_header X-Forwarded-Proto $scheme;
\n}<\/p>\n
# WebSocket \u4e13\u7528\u8def\u5f84（\u5fc5\u987b\u5355\u72ec\u914d\u7f6e！）
\nlocation \/dev-api\/websocket\/ {
\n proxy_pass http:\/\/localhost:18080\/websocket\/; # \u6ce8\u610f\u7ed3\u5c3e\u659c\u6760\u5339\u914d
\n proxy_http_version 1.1;
\n proxy_set_header Upgrade $http_upgrade; # \u2b50 \u5173\u952e：\u652f\u6301\u534f\u8bae\u5347\u7ea7
\n proxy_set_header Connection "upgrade"; # \u2b50 \u5173\u952e：\u89e6\u53d1 101 \u5207\u6362
\n proxy_set_header Host $host;
\n proxy_set_header X-Real-IP $remote_addr;
\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
\n proxy_set_header X-Forwarded-Proto $scheme;
\n} <\/p>\n","protected":false},"excerpt":{"rendered":"
\u6846\u67b6：RuoYi-Vue-Plus
\n\u4e0b\u8f7d\u5730\u5740：
\n（1）\u540e\u7aef\u4ee3\u7801\u00a0\u00a0https:\/\/www.gitlink.org.cn\/dromara-org\/RuoYi-Vue-Plus\/tree\/5.X
\n\u6216 https:\/\/gitee.com\/dromara\/RuoYi-Vue-Plus
\n\u6216 https:\/\/gitee.com\/dromara\/RuoYi-Cloud-Plus
\n（2）\u524d\u7aef\u4ee3\u7801\u00a0\u00a0<\/p>\n","protected":false},"author":2,"featured_media":63148,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[99,1117],"topic":[],"class_list":["post-63150","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-server","tag-java","tag-1117"],"yoast_head":"\n