WebSocket实时通讯搭建陪诊小程序：就诊进度推送、患者与陪诊师在线沟通源码分享

传统线上陪诊小程序大多采用HTTP轮询的方式实现消息同步，客户端需要定时频繁请求服务端接口，以此获取最新的订单状态和沟通消息。这种实现方式在医疗陪诊场景中存在明显短板，医院就诊流程动态性强，排队叫号、科室候诊、检查完成等进度实时变动，轮询模式不仅延迟高、服务器资源消耗大，还无法实现患者与陪诊师的即时双向沟通。消息更新不及时，容易出现陪诊人员错过就诊节点、医患沟通滞后、服务衔接不畅等问题，影响整体就医服务体验。

在医疗陪诊业务场景中，实时信息交互是保障服务质量的关键。用户下单预约陪诊服务后，从入院签到、科室候诊、排队等待、项目检查到就诊结束，全流程需要实时同步进度给用户和陪诊师。同时异地等候、分开就诊的场景下，患者需要随时和陪诊师沟通就诊问题、同步位置、确认流程，普通HTTP短连接无法支持双向实时通信，只能被动刷新数据，极易造成信息断层。

相较于HTTP短连接，WebSocket属于长连接通讯协议，客户端与服务端建立一次连接后，可实现双向持续数据传输，无需反复握手请求。服务端可以主动向客户端推送进度消息、聊天信息、状态通知，无需客户端频繁请求，极大降低接口请求量与服务器压力，同时消息延迟控制在毫秒级，完全满足就诊流程实时同步、医患即时沟通的业务需求，是本地生活、医疗服务实时场景的最优落地方案。

本次开发的WebSocket实时通讯模块，主要包含两大核心业务能力。一是就诊进度全局推送，陪诊师更新就诊节点后，服务端通过长连接实时推送至用户小程序，用户无需刷新页面即可查看最新就诊状态，涵盖候诊中、就诊中、检查中、就诊完成等全流程节点；二是医患双向在线沟通，支持患者与陪诊师一对一实时聊天，传递文字消息、就诊备注、注意事项，适配就诊过程中的即时沟通需求。

为适配医疗陪诊的业务特殊性，模块增加了连接管理、消息兜底、会话隔离机制。系统以订单ID为唯一会话标识，实现不同就诊订单会话隔离，避免消息串发、错发问题；针对小程序后台休眠、网络波动导致的连接断开问题，支持客户端自动重连、断线消息留存，网络恢复后自动补发未读消息，保证就诊关键信息不丢失。同时所有聊天记录、进度更新记录持久化存储，方便后续服务复盘与售后追溯。

整体技术实现基于SpringBoot原生WebSocket组件开发，无需引入第三方通讯框架，轻量化、易部署、易维护，适配中小型陪诊平台和小程序项目。项目独立封装通讯工具类、会话管理类、消息推送类，代码解耦性高，不会和原有订单、用户、资质模块产生代码冲突，可无缝集成到现有医疗陪诊系统中。

下面分享项目核心的WebSocket会话配置、就诊进度推送Java源码，代码精简规范，可直接集成使用。

WebSocket核心连接配置与会话管理代码：

@Configuration @EnableWebSocket public class WebSocketConfig implements WebSocketConfigurer { @Bean public WebSocketHandler webSocketHandler() { return new MedicalAccompanyWebSocketHandler(); } @Override public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) { // 配置websocket连接路径，允许跨域连接 registry.addHandler(webSocketHandler(), "/ws/medical/{orderId}") .setAllowedOrigins("*"); } }

就诊进度实时推送核心业务代码：

@Component public class MedicalAccompanyWebSocketHandler extends TextWebSocketHandler { // 存储订单对应的WebSocket会话 private static final Map<String, WebSocketSession> SESSION_MAP = new ConcurrentHashMap<>(); /** * 建立连接成功，保存会话 */ @Override public void afterConnectionEstablished(WebSocketSession session) { String orderId = session.getAttributes().get("orderId").toString(); SESSION_MAP.put(orderId, session); } /** * 推送就诊进度消息 */ public void sendMedicalProgress(String orderId, String progressMsg) throws IOException { if (SESSION_MAP.containsKey(orderId)) { WebSocketSession session = SESSION_MAP.get(orderId); // 组装就诊进度消息体 String msg = JSON.toJSONString(Map.of("orderId",orderId,"progress",progressMsg,"time",new Date())); session.sendMessage(new TextMessage(msg)); } } /** * 连接关闭，移除会话 */ @Override public void afterConnectionClosed(WebSocketSession session, CloseStatus status) { String orderId = session.getAttributes().get("orderId").toString(); SESSION_MAP.remove(orderId); } }

医患聊天消息发送极简核心代码：

@Service public class MedicalChatService { @Autowired private MedicalAccompanyWebSocketHandler webSocketHandler; /** * 医患实时消息发送 */ public Result sendChatMsg(String orderId, Long sendId, String content) { try { // 推送聊天消息至对应会话 webSocketHandler.sendMedicalProgress(orderId, content); // 持久化保存聊天记录 saveChatRecord(orderId, sendId, content); return Result.success("消息发送成功"); } catch (Exception e) { return Result.error("消息发送失败，请重试"); } } private void saveChatRecord(String orderId, Long sendId, String content){ // 聊天记录入库逻辑 } }

从业务落地角度分析，WebSocket实时通讯模块彻底解决了传统陪诊小程序消息滞后的问题。就诊进度实时推送，让患者及家属无需反复询问、刷新页面，随时掌握就诊排队、检查、问诊进度，大幅提升就医安全感和服务体验；医患在线沟通功能，打通患者与陪诊师的即时沟通壁垒，解决就诊过程中咨询、确认、报备不及时的问题，提升陪诊服务的专业性和流畅度。

从系统运维和性能角度来看，长连接替代轮询后，无效接口请求大幅减少，有效降低服务器并发压力与带宽消耗。会话隔离机制精准匹配每一笔陪诊订单，避免消息错乱、推送异常等问题，适配多城市、多订单同时在线的运营场景。同时断线重连、消息持久化机制，保障了医疗服务消息的完整性和可追溯性，贴合医疗服务严谨、规范的运营要求。

从项目开发与毕设角度而言，WebSocket实时通讯是区别于传统CRUD项目的优质技术亮点。该功能涵盖长连接通讯、会话管理、实时消息推送、数据持久化等核心知识点，贴合互联网医疗真实业务场景，技术实用性强、落地难度适中。在项目答辩中，可以从传统方案弊端、实时技术优势、医疗场景适配性、异常兼容处理等多个维度讲解，有效提升项目的技术完整性与实战价值。

整体而言，基于WebSocket搭建的陪诊小程序实时通讯方案，精准适配医疗陪诊场景的实时交互需求，通过就诊进度推送、医患在线沟通两大核心功能，完善了陪诊服务的数字化交互链路。技术方案成熟稳定、轻量化无冗余，可无缝对接各类Java医疗陪诊系统，无论是商用项目功能迭代、后端技术实战学习，还是计算机专业毕业设计功能拓展，都具备较高的参考和落地价值。