Java视频会议系统设计：Spring Boot+WebSocket+WebRTC落地指南

简介：基于Java的视频会议系统毕业设计资源包，内含完整源代码与项目报告，面向计算机相关专业毕业生及有Java基础的开发者。项目覆盖Java SE核心、Swing/JavaFX界面构建、Socket网络通信、JMF/WebRTC音视频处理、多线程并发、数据库存储及MVC等常见设计模式，适合毕业设计参照和实际开发训练。压缩包共313个文件，以208个xmi建模文件为主，辅以31个class字节码、11个Java源码、12个XML配置及1份项目报告doc，整体大小3.72MB，目录结构清晰便于查找。xmi文件为UML设计模型，可辅助还原系统架构与类关系。已有278人学习该资源，结合源代码与设计文档，可系统梳理会议系统的需求分析、模块划分与关键实现，也能深入理解实时音视频传输、多线程协作及安全性处理等落地细节，对完善毕设或提升项目能力均有实用价值。

1. 基于java的视频会议系统毕业设计与实现：先想清楚这三件事再动手

基于java的视频会议系统毕业设计与实现，每年都有一批学生选，但真正能一次跑通演示的不到一半。问题不在Java，而在于很多人把精力压在了“视频”两个字上，忽略了信令、房间状态、并发连接这些真正决定成败的部分。这篇文章把一条验证过的落地路径拆给你：Spring Boot提供后端服务，WebSocket负责实时信令，浏览器内置的WebRTC完成采集和传输。适合Java基础扎实、想把毕设做成“能演示、能讲清、能扩展”的工程作品的同学。按这个思路走，你收获的不只是一份源代码和项目报告，而是一套能站上答辩现场的设计逻辑。

2. 系统架构与技术选型：为什么是Spring Boot + WebSocket + WebRTC

2.1 毕业设计场景下的技术方案对比：SIP、RTMP还是WebRTC

做视频会议系统，最容易在选型上栽跟头。我见过有人用SIP协议加JAIN SIP库，代码写了一千多行，光注册和呼叫状态机就绕晕了；也有人用RTMP推送流到流媒体服务器，部署了Nginx-RTMP模块，结果发现浏览器原生不支持RTMP播放，还要额外搭配Flash方案——现在的浏览器已经不给你用Flash了。这些方案不是不对，而是对毕业设计来说成本太高、风险太大。

真正适合“基于java的视频会议系统”这题目的，是三段式组合：Java后端只做信令和业务，媒体能力交给浏览器内置的WebRTC。WebRTC是浏览器原生的实时通信能力，采集摄像头、编码、传输、解码、渲染全包了，不需要安装任何插件。你的Java代码负责三件事：管理会议房间、转发SDP和ICE候选帧、维护成员状态。

我一般建议选第三种。理由是它把最难的媒体堆栈踢给了成熟技术，把信令和房间管理留给你自己设计——这两块恰恰是毕设报告里最能体现工作量、最出彩的部分。

2.2 系统模块划分：信令、媒体协商、房间状态与持久化

整个系统的职责要划分清楚。我一般拆成四个模块，每个模块在报告里单独开一节，逻辑清晰。

信令服务是整个系统的调度中心。它接收客户端发来的join、offer、answer、ice-candidate、leave这五类事件，并把它们路由到对应的房间里。信令本身不传输视频数据，只传输描述信息和网络协商信息，量很小，WebSocket完全扛得住。

媒体协商模块在浏览器端。WebRTC的RTCPeerConnection负责创建SDP（会话描述协议）和ICE候选。SDP是什么？简单说就是“我能接收什么编码格式、什么分辨率的流”的自我介绍。两个端点交换SDP后，才知道用什么编码方式互发视频。

会议房间管理由Java后端的内存状态维护。每个房间是一个集合，保存房间内的WebSocketSession句柄。用户加入、退出的瞬间，后端要广播成员列表的变化，这样才能触发新成员发起offer、旧成员渲染新视频画面。

持久化层用Spring Boot + MyBatis来记录会议历史、用户信息、会议时长。这块是凑项目报告“数据库设计”一章的必要素材，别省略——没有数据库设计的毕设，在一辩就会被问倒。

2.3 数据库设计：用户表、会议室表和会议记录表

数据库是项目报告里最容易被老师翻的一节。视频会议系统最少需要三张表：用户表、会议室表、会议记录表。用户登录用，会议室创建用，会议记录是答辩加分项——多一张表，报告里就能多画一张E-R图。如果你想让MyBatis-Plus根据Java实体类生成创建表的SQL语句，可以直接用它的代码生成器，或者在建库时用下面的脚本手动执行，两种方式在报告中都可以写清楚。

CREATE TABLE `sys_user` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL COMMENT '登录名', `password` VARCHAR(128) NOT NULL COMMENT 'BCrypt密文', `nickname` VARCHAR(50) DEFAULT '' COMMENT '显示名', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE `meeting_room` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `room_name` VARCHAR(100) NOT NULL COMMENT '会议室名称', `creator_id` BIGINT NOT NULL COMMENT '创建人ID', `max_members` INT DEFAULT 8 COMMENT '最大人数', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE `meeting_record` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `room_id` BIGINT NOT NULL, `user_id` BIGINT NOT NULL, `join_time` DATETIME NOT NULL, `leave_time` DATETIME NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

逻辑说明：三张表的主键都用自增BIGINT，避免分布式雪花算法增加无谓复杂度。meeting_record里的leave_time在用户中途退出或会议结束时才更新，配合join_time可以算出每个人的参会时长，这是报告里“统计报表”功能的素材。max_members字段默认8，控制房间规模，防止演示时有人反复刷入导致内存被撑爆。

对应的MyBatis-Plus实体类，示范一个：

@Data @TableName("meeting_room") public class MeetingRoom { @TableId(type = IdType.AUTO) private Long id; private String roomName; private Long creatorId; private Integer maxMembers; private LocalDateTime createTime; }

参数说明：MyBatis-Plus用@TableName映射表名，@TableId标注主键生成策略为自增。配置好Mapper扫描后，这个实体类的CRUD不需要手写SQL，直接注入Mapper调用selectById、insert即可。源代码里能少掉几百行重复代码，报告里也能名正言顺写一句“持久层使用MyBatis-Plus简化开发”。

2.4 项目目录结构与pom.xml关键依赖

先把工程目录搭好再写代码，能省掉后面整理源代码的时间。Maven工程，package按功能拆：

src/main/java/com/demo/meeting/ config/WebSocketConfig.java controller/AuthController.java controller/RoomController.java service/RoomService.java service/UserService.java handler/SignalHandler.java model/entity/User.java model/entity/MeetingRoom.java model/entity/MeetingRecord.java model/dto/JoinRoomRequest.java model/vo/MemberVO.java src/main/resources/ static/index.html static/js/meeting.js static/css/style.css application.yml

pom.xml里最关键的是下面三个依赖，其他按Spring Boot官方起步依赖补：

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-websocket</artifactId> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.7</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency>

参数说明：spring-boot-starter-websocket自带WebSocket基础支持，不引入它就得从零实现WebSocket协议栈，不值得。mybatis-plus-boot-starter的版本号要和Spring Boot大版本匹配，Spring Boot 3.x里数据库驱动坐标也改为com.mysql:mysql-connector-j，注意别照搬旧教程。

application.yml的要点：

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/meeting?useUnicode=true&characterEncoding=utf8 username: root password: 123456 jackson: time-zone: GMT+8 mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml global-config: db-config: id-type: auto

这段配置里，characterEncoding=utf8是为了避免中文乱码，jackson时区设置为GMT+8避免LocalDateTime序列化偏移8小时——这个坑我踩过，报告里写一笔“统一时区处理”，答辩老师会觉得你考虑周到。

3. 核心功能实现：信令服务、房间管理与SDP协商

3.1 信令通道：WebSocket配置类与消息处理器

WebSocket在Spring Boot里不是一个黑匣子，而是把协议升级、文本帧解码都封装好的框架。你只需要写一个配置类注册Handler，再写一个Handler处理消息。

@Configuration @EnableWebSocket public class WebSocketConfig implements WebSocketConfigurer { @Override public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) { registry.addHandler(signalHandler(), "/signal") .setAllowedOriginPatterns("*"); } @Bean public WebSocketHandler signalHandler() { return new SignalHandler(new RoomManager()); } }

逻辑说明：registerWebSocketHandlers把SignalHandler挂到/signal路径，前端new WebSocket("ws://" + location.host + "/signal")就能连上。setAllowedOriginPatterns("*")允许来自不同端口的前端页面发起连接——如果你用8080跑后端、3000跑前端调试，这行是必须的。

接下来是SignalHandler，整个信令链路的核心。按五类事件分派：

@Component public class SignalHandler extends TextWebSocketHandler { private static final ObjectMapper MAPPER = new ObjectMapper(); private final RoomManager roomManager; public SignalHandler(RoomManager roomManager) { this.roomManager = roomManager; } @Override protected void handleTextMessage(WebSocketSession session, TextMessage message) throws Exception { JsonNode json = MAPPER.readTree(message.getPayload()); String type = json.get("type").asText(); switch (type) { case "join" -> handleJoin(session, json); case "offer" -> relay(session, json); case "answer" -> relay(session, json); case "ice-candidate" -> relay(session, json); case "leave" -> { roomManager.leave(session); session.close(CloseStatus.NORMAL); } default -> session.sendMessage(new TextMessage("{\"type\":\"error\",\"message\":\"未知消息类型\"}")); } } private void handleJoin(WebSocketSession session, JsonNode json) throws Exception { String roomId = json.get("roomId").asText(); String userId = json.get("userId").asText(); session.getAttributes().put("roomId", roomId); session.getAttributes().put("userId", userId); String members = roomManager.join(roomId, session); session.sendMessage(new TextMessage("{\"type\":\"welcome\",\"members\":\"" + members + "\"}")); } }

参数说明：ObjectMapper把WebSocket消息安全解析成JsonNode，避免字符串拼接的转义问题。handleJoin里把roomId和userId存入session的attributes，后面relay才能知道消息要转发给谁。switch表达式是Java 14+的写法，如果学校机房JDK还是8，要改成传统switch语句。

3.2 房间管理器：并发状态维护与成员广播

房间管理器是一个纯内存组件，用并发集合持有每个房间的WebSocketSession集合。选择CopyOnWriteArraySet是因为它读多写少：每次广播成员列表都要遍历读取，而用户加入和离开是低频操作，它的并发写成本可以接受。

@Component public class RoomManager { private final ConcurrentHashMap<String, CopyOnWriteArraySet<WebSocketSession>> rooms = new ConcurrentHashMap<>(); public String join(String roomId, WebSocketSession session) { CopyOnWriteArraySet<WebSocketSession> room = rooms.computeIfAbsent(roomId, k -> new CopyOnWriteArraySet<>()); room.add(session); session.getAttributes().put("roomId", roomId); return room.stream() .map(s -> String.valueOf(s.getAttributes().get("userId"))) .collect(Collectors.joining(",")); } public void leave(WebSocketSession session) { String roomId = (String) session.getAttributes().get("roomId"); if (roomId == null) return; CopyOnWriteArraySet<WebSocketSession> room = rooms.get(roomId); if (room != null) { room.remove(session); if (room.isEmpty()) { rooms.remove(roomId); } else { String members = room.stream() .map(s -> String.valueOf(s.getAttributes().get("userId"))) .collect(Collectors.joining(",")); relay(session, "member-update", members); } } } public void relay(WebSocketSession sender, JsonNode json) { String roomId = (String) sender.getAttributes().get("roomId"); CopyOnWriteArraySet<WebSocketSession> room = rooms.get(roomId); if (room == null) return; String sendType = json.get("type").asText(); JsonNode data = json.get("data"); for (WebSocketSession target : room) { if (target != sender) { send(target, sendType, data); } } } }

逻辑说明：join返回当前成员ID的逗号拼接串，SignalHandler收到后作为welcome消息回给新成员，新成员就知道房间里有谁、该向谁发起offer。leave中，当房间移除会话后如果还有人，就广播新的成员列表，旧成员的RTCPeerConnection里的远端流才能被正确清理。注意relay方法只转发type和data，不转发from字段，由接收端自己赋值，避免伪造消息。

3.3 浏览器端：getUserMedia到SDP交换的完整链路

前端页面是整个系统最能直观打动答辩老师的地方。HTML只需要两个video标签和两个按钮，关键在meeting.js里。按流程拆开：

let localStream; let ws; async function joinRoom() { // 1. 先拿本地摄像头和麦克风流 localStream = await navigator.mediaDevices.getUserMedia({ video: { width: 640, height: 480 }, audio: true }); document.getElementById('localVideo').srcObject = localStream; // 2. 建立WebSocket连接 ws = new WebSocket(`ws://${location.host}/signal`); ws.onmessage = onMessage; // 3. 发送join事件 ws.onopen = () => { ws.send(JSON.stringify({type: 'join', roomId, userId})); }; }

逻辑说明：getUserMedia的video参数里width和height不是硬性采集分辨率，而是理想值，浏览器会根据实际摄像头能力自动调整。video标签的srcObject直接赋给媒体流，比老式的createObjectURL更简洁且内存友好。ws.onopen保证WebSocket握手成功后立刻发送join，此时后端才能将session收进房间并广播成员列表。

async function createPeerConnection() { const pc = new RTCPeerConnection({iceServers: []}); pc.onicecandidate = event => { if (event.candidate) { ws.send(JSON.stringify({ type: 'ice-candidate', data: event.candidate.toJSON() })); } }; pc.ontrack = event => { document.getElementById('remoteVideo').srcObject = event.streams[0]; }; localStream.getTracks().forEach(track => pc.addTrack(track, localStream)); return pc; } async function makeOffer(peerId) { const pc = await createPeerConnection(); const offer = await pc.createOffer(); await pc.setLocalDescription(offer); ws.send(JSON.stringify({type: 'offer', data: pc.localDescription})); } async function handleOffer(peerId, offerData) { const pc = await createPeerConnection(); await pc.setRemoteDescription(offerData); const answer = await pc.createAnswer(); await pc.setLocalDescription(answer); ws.send(JSON.stringify({type: 'answer', data: pc.localDescription})); }

参数说明：iceServers留空数组代表局域网直连模式，不依赖外部服务；如果部署到公网，需要再配置STUN/TURN服务器地址。onicecandidate事件在setLocalDescription后自动触发，把候选帧实时推给对端。对端的ontrack事件在收到远端媒体流后触发，把streams[0]赋给远端video标签，这一步成功后画面就出来了。

这里的关键点：offer和answer里携带的是SDP消息，ice-candidate携带的是网络路径试探消息。SDP决定“你我能用什么编码格式通信”，ICE候选决定“你我走哪条网络路径通信”。两块都有延迟，任何一个丢了都黑屏。

3.4 本地最小验证：两个浏览器窗口跑通一场会议

无需服务器、无需公网IP，本地就能验证整条链路是否正常。这是我复制给答辩前演练用的最小步骤：

1. 启动Spring Boot应用，看到Tomcat started on port 8080，通常用mvn spring-boot:run或者在IDE里直接跑主类。
2. 打开Chrome访问http://localhost:8080，登录后进入会前等待页。
3. 再开一个Edge（注意不要用隐身窗口），访问同一地址，用另一个用户登录。
4. 两个页面都点击“加入房间”，输入同一个roomId。
5. Chrome先加入，Edge随后加入，此时Edge发起offer，Chrome回answer，双方视频画面出现在对方页面。

如果你发现视频画面正常但听不到声音，大概率是浏览器自动播放策略限制：远端音频轨道必须等用户点击过一次页面后才能播放。这是浏览器安全策略，不是代码问题，在onclick事件里调用remoteVideo.play()就能解决。

4. 项目报告撰写与答辩避坑：从代码到学分的落点

4.1 项目报告的结构设计：五章叙事与图表素材

毕设报告不是代码堆叠，老师看的是你有没有走完“需求分析、设计、实现、测试”的全流程。建议报告正文按五章组织：

写报告时图一定自己画。用draw.io画用例图和E-R图，用IDEA的Diagrams生成类图，这些图是查重系统无法命中外部文本的，既能降低重复率又能让老师感到你真的做了设计。项目报告里贴代码时，只贴核心片段并注释思路，不要整段复制源码，避免查重标红。

4.2 五条高频踩坑记录：现象、原因、解决

坑一：getUserMedia不弹摄像头权限框，直接报NotAllowedError

现象：本地打开前端页面，点击“加入会议”，控制台报DOMException: Permission denied，但浏览器设置里已经允许摄像头权限。

原因：浏览器只在HTTPS或http://localhost环境下开放getUserMedia接口。你用http://192.168.x.x:8080访问时，浏览器把页面当作“不安全上下文”，直接拒绝媒体权限。

解决：开发时统一用http://localhost访问；若要用局域网IP演示，在Chrome的Site Settings里把该IP加入“不安全内容”允许列表。答辩部署时用Nginx配HTTPS自签名证书。

坑二：第二个用户加入后，远端视频窗口还是黑的

现象：Edge端加入房间，Chrome端能看到自己画面但看不到Edge的画面，控制台没报错，WebSocket一直在收发消息。

原因：ICE候选没有到达对端。可能是后端relay逻辑只转发了data字段，把ice-candidate整体丢掉了；也可能是前端的onicecandidate事件在setLocalDescription之前触发，部分候选没有进入对端addIceCandidate。

解决：先在后端日志打印candidate帧，确认两个端点都在发；再看前端，给onicecandidate回调加console.log，确认event.candidate不是null。最后比对两端的sessionDescription类型，确认offer和answer都成功set了。

坑三：答辩现场两台电脑之间连不上，单机测试正常

现象：在家用一台电脑的两个浏览器窗口测试一切正常，答辩现场换了另一台电脑，两台机器之间视频黑屏。

原因：绝大多数校园网和企业Wi-Fi开了AP隔离，无线客户端之间不允许互访。WebRTC的P2P连接在这种网络里被直接阻断。

解决：提前准备备用方案——用手机开热点，两台电脑都连同一个热点，AP隔离不会生效。如果现场没有热点条件，就把答辩演示改为单机双窗口模式，先讲信令逻辑再切实时画面。千万不要到现场才第一次试双机。

坑四：打包成jar后，前端页面连不上WebSocket

现象：IDE里跑mvn spring-boot:run没问题，但打成jar后java -jar启动，浏览器打开页面点击加入会议，WebSocket一直CONNECTING然后报错。

原因：前端代码里WebSocket地址写死了ws://127.0.0.1:8080/signal，但后端服务配置了context-path，或者浏览器访问的是localhost而socket地址用的是127.0.0.1，端口被服务器防火墙拦截时也会有这种表现。

解决：前端用ws://${location.host}/signal动态拼接，不写死IP。检查server.context-path配置，如果配了/api前缀，WebSocket注册路径也要带上。打包后先curl确认根路径返回200再开页面。

坑五：论文报告查重率卡在30%边缘

现象：报告提交到查重系统，连续两次查重率都在28%左右，差一点超线；挨段排查，重的地方集中在第三章“系统实现”的代码说明和第五章测试表。

原因：代码片段虽然默认查重占比不高，但解释代码时的措辞容易跟网上同名毕设撞车，尤其是“通过WebSocket实现实时通信”这类套话，全网几千篇写得一样。

解决：用自己的话重写技术解释，把框架术语换成从自己项目里观察到的细节，比如“本系统在join事件中返回当前房间成员列表，前端据此决定是否发起offer”——描述越具体越不容易撞。图表一律自己画，参考文献格式务必和学校模板一致，那串[1][2]的排版标红也能拉高重复率。

5. 部署与答辩演示的最后一公里：打包、体检与代码习惯

5.1 用Maven打包成单文件jar

走到这一步，你已经有了能跑的代码和写得差不多的报告。毕业设计交付通常要jar或war，直接执行：

mvn clean package -DskipTests

这条命令编译源码、跳过单元测试、打包成可执行jar，输出在target目录下。部署到Linux服务器时用nohup保持后台运行：

nohup java -jar target/meeting-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod > meeting.log 2>&1 &

参数说明：--spring.profiles.active=prod切换生产环境配置，数据库连接和端口要改成服务器实际值，不要把本地密码带到线上。meeting.log保留运行日志，连接出问题能快速看stacktrace。

5.2 答辩前的五分钟体检清单

上场前不要自信，用这张表快速过一遍：

每一项不超过30秒，全程大约5分钟。“中途退出”这步很多人不测，但答辩老师特别爱问“用户断了网怎么办”，现场演示一次正常退出，再补一句“断网时WebSocket的close事件会触发同样逻辑，但存在30秒超时”，就很稳。

5.3 把信令消息类型抽成常量类

最后一个关于代码质量的好习惯：把五类信令消息抽成常量类，前端后端统一命名，防止手误打错字符串。

public final class MessageType { private MessageType() {} public static final String JOIN = "join"; public static final String LEAVE = "leave"; public static final String OFFER = "offer"; public static final String ANSWER = "answer"; public static final String ICE_CANDIDATE = "ice-candidate"; public static final String MEMBER_UPDATE = "member-update"; public static final String ERROR = "error"; }

这样做的价值在于：导师检查代码时扫一眼就明白，消息类型不会因为大小写混用产生难查的bug。我自己的血泪经验是有一版代码里join和JOIN混用，线上排查三小时才发现是大小写问题。从那以后坚持把消息类型收敛成常量，答辩老师看过这层设计后普遍认为你有工程意识。

希望这篇路线图能帮你少走两三个月的弯路，祝答辩顺利，希望帮到你。

本文还有配套的精品资源，点击获取