一套微服务在线客服系统访客在商城页通过悬浮气泡咨询客服在管理后台工作台实时接待WebSocket 长连接同时保留商城/后台本身的业务能力。架构示意图浏览器┌──────────────────────┐ ┌──────────────────────────┐│ 商城 customer-system │ │ 后台 admin-system ││ Naive UI :3001 │ │ Element Plus :3000 ││ 访客悬浮聊天窗 │ │ 客服工作台(SSO 免二次登录) │└──────────┬───────────┘ └────────────┬─────────────┘│ HTTP /api WS /ws │ HTTP /ocs-api WS /ocs-ws▼ ▼┌─────────────────────────┐│ Spring Cloud Gateway:9000│ 统一入口/路由/静态文件└────────────┬─────────────┘┌───────────────────┼───────────────────┐▼ ▼ ▼┌────────────────┐ ┌─────────────────┐ ┌──────────────────────┐│ admin-service │ │customer-service │ │ online-service ││ :8080 │ │ :8081 │ │ :8082 HTTP :9001 WS ││ 用户/角色/权限 │ │ 客户/商品/购物车 │ │ 会话/消息/坐席/分配 ││ admin_system 库│ │ customer_service│ │ online_customer_service│└────────────────┘ └────────┬────────┘ └───────────┬──────────┘│ Feign │└───────────────────────┘ SSO 身份核实┌─────────────┬──────────────┬───────────────┐▼ ▼ ▼MySQL 5.7 Redis Nacos 3(三库独立) (token/在线状态/ (注册发现/配置)路由/限流)技术栈┌───────────┬───────────────────────────────────────────────────────────────────────────────────────────────────────┐│ 层 │ 技术 │├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤│ 语言/框架 │ Java 21、Spring Boot 3.5、Spring Cloud Alibaba 2025 │├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤│ 微服务 │ Spring Cloud GatewayWebFlux 反应式、OpenFeign、Nacos注册配置 │├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤│ 实时通信 │ Netty 手写 WebSocket 服务900130s 心跳、指数退避重连、SYSTEM 事件帧封装消息发送 HTTP/WS 双通道 │├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤│ 持久层 │ MyBatis-Plus 3.5Lambda 语法为主、MySQL 5.7每服务独立库 │├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤│ 缓存 │ Redis客服 token8h 滑动续期顶号、在线状态、技能组路由、限流、策略应急覆盖 │├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤│ 后台前端 │ Vue 3.5 TS Vite Element Plus Piniatoken 存 localStorage路由表按权限码动态注册 │├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤│ 商城前端 │ Vue 3.5 TS Vite Naive UI Pinia客户 token 走 httpOnly cookie不落 localStorage │├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤│ 工程规范 │ Lombok、SLF4J Slf4j、构造器注入、统一 ResultT / BusinessException、DTO/VO/DO 分层 │└───────────┴───────────────────────────────────────────────────────────────────────────────────────────────────────┘几个关键设计- 三库隔离 最小耦合权限点 ocsWorkbench:* 在 admin 库决定谁能进工作台坐席/会话在 online 库决定怎么接待admin 登录后用 adminToken 调 online SSO 换客服tokenonline 再反向 Feign 核实- 会话分配可热切换轮询 / 最少接待默认/ 技能组优先 / 指定客服支持 Redis 应急覆盖无需重启- 访客身份兜底已登录商城客户打开气泡时后端从 customer_token cookie 自动识别身份JS 读不到 token- 消息可靠性clientMsgId 唯一索引做发送幂等防重复消息、乐观消息气泡 失败重发、游标分页拉历史、已读回执整体就是一个典型的「网关 三业务服务 Netty 长连接 双前端嵌入」Spring Cloud 教学/演示架构。● 基础设施中间件本地实际运行版本已实测确认┌────────┬────────────────────────┬──────┬─────────────────────────────────────────────────────────────────────────────────┐│ 中间件 │ 版本 │ 端口 │ 在本项目的用途 │├────────┼────────────────────────┼──────┼─────────────────────────────────────────────────────────────────────────────────┤│ MySQL │ 5.7.43 │ 3306 │ 三个服务各独立一库admin_system / customer_service / online_customer_service │├────────┼────────────────────────┼──────┼─────────────────────────────────────────────────────────────────────────────────┤│ Redis │ 5.0.14.1Windows 版 │ 6379 │ 客服/客户 token、坐席在线状态、技能组路由、限流、分配策略应急覆盖 │├────────┼────────────────────────┼──────┼─────────────────────────────────────────────────────────────────────────────────┤│ Nacos │ 3.0.3 │ 8848 │ 服务注册发现 配置中心 │└────────┴────────────────────────┴──────┴─────────────────────────────────────────────────────────────────────────────────┘▎ 注意MySQL 是 5.7 而非计划文档里写的 8.0所以写 SQL 时要兼容 5.7如没有窗口函数、注意 ONLY_FULL_GROUP_BY。与之配套的框架/组件版本Mavenpom 实际声明┌──────────────────────┬─────────────────────────────┬──────────────────────────────────────────────────────┐│ 组件 │ 版本 │ 说明 │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ JDK │ 21 │ │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ Spring Boot │ 3.5.x │ 父 POM 管理 │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ Spring Cloud │ 2025.0.3 │ Gateway OpenFeign │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ Spring Cloud Alibaba │ 2025.0.0.0 │ Nacos 注册/配置Nacos Client 3.0.3 │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ MyBatis-Plus │ 3.5.9 │ ORMmybatis-plus-spring-boot3-starter │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ Netty │ 随 Spring Boot BOM4.2.x │ 9001 端口手写 WebSocket 服务 │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ Hutool │ 5.8.32 │ 工具库 │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ Lombok │ 1.18.30 │ │├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤│ 构建 │ Maven │ 多模块common / gateway / admin / customer / online │└──────────────────────┴─────────────────────────────┴──────────────────────────────────────────────────────┘前端侧 Node 22.21.1、Vite Vue 3.5属于构建工具链而非运行中间件。整套依赖 Spring Boot BOM 对齐版本没有手工锁冲突的三方包。开源地址stormeryang (youbangbang_stormeryang) - Gitee.com