尧图网页设计 
简介这份资源是基于Java实现的公交车实时监控系统设计源码面向具备一定Java基础、希望学习智能交通或微服务架构开发的学生与开发者可用于课程设计、毕业设计或二次开发参考。压缩包共43个文件约61KB以37个Java源文件为核心辅以2个XML配置、1个YAML配置、1个SQL建表脚本及gitignore、txt说明等分别承担业务逻辑、参数配置、数据持久化与项目说明等职责。系统采用Spring Boot构建微服务架构通过RESTful API通信并基于笑园实时公交API获取车辆位置、状态与运行轨迹等数据实现公交车的实时监控。目前已有279人学习浏览。读者可从中获取完整的后端工程结构、API对接思路、配置文件组织方式与数据库脚本理解实时数据流处理与模块化设计方法适合作为智能交通类项目的实践起点。1. 公交实时监控系统源码拆解Java 技术栈能跑出什么效果公交实时监控系统源码核心解决的是「车辆位置怎么实时上报、后台怎么稳定接收、前端怎么低延迟展示」这条链路。这套基于 Java 实现的公交车实时监控系统设计源码把车载终端模拟、服务端接收、数据存储、Web 端展示串成了一条完整可跑的链路适合做课程设计、毕业设计也适合想搞明白实时监控系统骨架的 Java 开发者拿来二次开发。它不是一个只贴几张截图的空壳而是有明确分层、有接口定义、有数据流转的工程结构。你拿到手能直接看到车辆模拟器怎么发数据、服务端怎么接、前端怎么刷。下面按「资源是什么 → 怎么用 → 坑在哪」的顺序把这份源码拆开讲透每一步都落到能复现的操作上。2. 环境搭建与工程结构从 JDK 到数据库的完整落地2.1 技术栈选型与依赖版本确认这套源码的技术栈是典型的 Java Web 组合后端用 Spring Boot 承载 REST API 和 WebSocket 推送持久层用 MyBatis 操作 MySQL前端是 HTML JavaScript 配合地图 API 做轨迹渲染。选这套组合的原因很直接——Spring Boot 内嵌 Tomcat省去单独部署容器的步骤MyBatis 对 SQL 的控制粒度细方便你改查询逻辑WebSocket 保证车辆位置推送不是靠前端轮询硬拉延迟能压到秒级以内。拿到源码包后先别急着导入 IDE。第一步是确认版本匹配这是最容易翻车的地方。常见做法是打开pom.xml核对三处Spring Boot 父版本、MySQL 驱动版本、JDK 编译级别。如果源码写的是 Spring Boot 2.x 配 JDK 8你硬用 JDK 17 去跑大概率在启动时抛InaccessibleObjectException这不是代码问题是模块化访问限制导致的。!-- pom.xml 关键依赖片段核对版本是否与你本地环境一致 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.x/version !-- 若本地是 JDK 17建议升到 3.x 并同步改 javax→jakarta -- /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-websocket/artifactId !-- 实时推送的核心依赖 -- /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.x/version /dependency /dependencies上面这段依赖里spring-boot-starter-websocket是实时监控的命脉没有它前端就只能靠定时器轮询接口车辆一多接口压力直接上来。mysql-connector-java的版本要和你的 MySQL 服务端对齐8.0 的驱动连 5.7 的库通常没问题反过来容易出时区报错。参数上重点看version标签改完记得在 IDE 里刷新 Maven 依赖别只改文件不重载。2.2 数据库建表与初始数据导入工程结构里src/main/resources下一般会有schema.sql或独立的.sql文件这是建表脚本。执行之前先建库字符集用utf8mb4排序规则用utf8mb4_general_ci避免车辆名称或站点名里有特殊字符时插入失败。-- 创建数据库字符集必须指定否则中文站点名会乱码 CREATE DATABASE bus_monitor DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 车辆实时位置表核心字段是经纬度和时间戳 CREATE TABLE bus_location ( id BIGINT AUTO_INCREMENT PRIMARY KEY, bus_no VARCHAR(32) NOT NULL COMMENT 公交车编号, line_id INT NOT NULL COMMENT 线路ID, lng DECIMAL(10,6) NOT NULL COMMENT 经度, lat DECIMAL(10,6) NOT NULL COMMENT 纬度, report_time DATETIME NOT NULL COMMENT 上报时间, INDEX idx_line_time (line_id, report_time) -- 按线路和时间查索引必须建 ) ENGINEInnoDB;建表时最容易忽略的是索引。bus_location表会随车辆上报不断膨胀如果没有idx_line_time这个联合索引前端查某条线路最近一分钟的轨迹时就是全表扫描数据量一上来查询直接卡死。字段类型上经纬度用DECIMAL(10,6)而不是FLOAT因为浮点精度在轨迹回放时会出现位置漂移这是血泪经验。导入初始数据后用SELECT COUNT(*)确认线路表和车辆表都有数据空表会导致前端地图上什么都没有。2.3 配置文件修改与服务启动application.yml是启动前的最后一道关卡。需要改的通常有四项数据库连接、端口、WebSocket 路径、地图 API 密钥。server: port: 8080 # 若被占用改成 8081前端请求地址要同步改 spring: datasource: url: jdbc:mysql://localhost:3306/bus_monitor?useSSLfalseserverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver jackson: time-zone: Asia/Shanghai # 不加这行上报时间会差 8 小时serverTimezoneAsia/Shanghai这个参数是必须的MySQL 8.0 驱动默认用 UTC不指定的话车辆上报时间会比实际早 8 小时前端看到的轨迹时间全是错的。改完配置后在 IDE 里找到主启动类右键运行。控制台出现Started Application in x seconds就算起来了。如果报Communications link failure先确认 MySQL 服务是否启动、端口是否被防火墙拦。启动成功后浏览器访问http://localhost:8080能看到地图页面就说明前后端链路通了。3. 实时数据链路打通模拟器、API 与 WebSocket 推送3.1 车辆位置模拟器的运行与参数调整真实公交车不可能拿来测试所以源码里会带一个模拟器定时生成经纬度并调用上报接口。模拟器一般是一个独立的 Java 类或一个main方法运行后按固定间隔往服务端发数据。// 车辆模拟器核心逻辑按固定间隔上报位置 Scheduled(fixedRate 3000) // 每 3 秒上报一次改这个值控制数据密度 public void reportLocation() { for (Bus bus : busList) { // 沿线路方向做微小偏移模拟车辆行驶 double newLng bus.getLng() (Math.random() - 0.5) * 0.001; double newLat bus.getLat() (Math.random() - 0.5) * 0.001; bus.setLng(newLng); bus.setLat(newLat); // 调用上报接口把数据推给服务端 restTemplate.postForObject(http://localhost:8080/api/location/report, bus, String.class); } }fixedRate 3000表示每 3 秒触发一次这个值决定了前端轨迹的平滑度。设太大车辆会「跳」设太小数据库写入压力大。我一般测试时用 3000演示时用 1000。Math.random()那两行是模拟车辆移动真实场景应该根据线路的站点序列计算下一位置但作为课程设计随机偏移足够展示效果。注意模拟器里的接口地址要和application.yml里的端口一致改了端口这里也要改否则模拟器发出去的数据全打到空气里。3.2 上报接口与 WebSocket 推送的衔接服务端收到上报数据后要做两件事写库、推送给前端。写库用 MyBatis 的insert推送用 WebSocket 的broadcast。这两步的顺序有讲究——先写库再推送保证前端看到的数据一定能从数据库查到如果先推送后写库推送成功但写库失败时前端会显示一条数据库里不存在的位置排查时就是黑匣子。PostMapping(/api/location/report) public Result report(RequestBody BusLocation location) { location.setReportTime(new Date()); busLocationMapper.insert(location); // 先落库 // 再通过 WebSocket 推送给所有订阅该线路的前端 webSocketServer.sendToLine(location.getLineId(), JSON.toJSONString(location)); return Result.success(); }RequestBody把前端传来的 JSON 自动映射成BusLocation对象字段名要一一对应大小写敏感。sendToLine是自定义方法按线路 ID 过滤订阅者避免把所有车辆数据推给所有人。如果前端收不到推送先检查 WebSocket 的连接地址是否和application.yml里配的一致再确认sendToLine里的线路 ID 匹配逻辑有没有写反。常见错误是把lineId当成busNo用结果一条线路的车推到了另一条线路的页面上。3.3 前端地图轨迹渲染与刷新频率控制前端拿到 WebSocket 推送的数据后调用地图 API 的setPosition或polyline更新车辆位置。这里的关键是刷新频率控制——如果每来一条数据就重绘整个地图车辆一多浏览器直接卡死。// WebSocket 接收消息后更新车辆标记用节流控制重绘频率 let pendingUpdates []; const socket new WebSocket(ws://localhost:8080/ws/bus); socket.onmessage function(event) { const data JSON.parse(event.data); pendingUpdates.push(data); // 先缓存不立即重绘 }; // 每 500ms 批量处理一次避免高频重绘 setInterval(() { if (pendingUpdates.length 0) return; pendingUpdates.forEach(item { updateMarker(item.busNo, item.lng, item.lat); // 更新对应车辆的标记 }); pendingUpdates []; // 清空缓存 }, 500);setInterval的 500ms 是节流窗口意思是无论收到多少条推送每半秒才重绘一次。这个值太小起不到节流作用太大轨迹会一顿一顿。updateMarker里要根据busNo找到已有的标记对象只改经纬度不要删了重建重建会导致标记闪烁。如果地图上车辆不动先看pendingUpdates有没有数据进来再看updateMarker里的busNo匹配逻辑——常见坑是推送里的busNo是数字前端存的是字符串比较永远为 false。4. 避坑与排查这套源码跑起来最容易卡在哪4.1 启动报错Table bus_monitor.xxx doesnt exist现象是 Spring Boot 启动时直接抛异常退出日志里明确说某张表不存在。原因通常是建表脚本没执行或者执行到了错误的数据库里。解决方法是登录 MySQL用SHOW TABLES确认当前库里有几张表缺哪张就单独补执行对应的CREATE TABLE语句。注意建表脚本里的USE语句可能指向了别的库名手动改成bus_monitor再跑。4.2 WebSocket 连接返回 404现象是前端控制台报WebSocket connection failed状态码 404。原因是 WebSocket 的服务端注册路径和前端连接路径不一致。解决方法是打开 WebSocket 配置类看registry.addHandler(server, /ws/bus)里的路径再对比前端new WebSocket(ws://...)里的路径两边必须完全一致。另外注意 Spring Boot 2.x 和 3.x 的 WebSocket 配置类包名不同2.x 用javax.websocket3.x 用jakarta.websocket混用直接编译不过。4.3 车辆位置在地图上偏移到国外现象是前端地图上车辆标记出现在完全错误的位置甚至跑到海上。原因是经纬度顺序搞反了。国内地图 API 普遍要求「经度在前、纬度在后」而有些 GPS 数据源是「纬度在前」。解决方法是检查上报接口里lng和lat的赋值顺序以及前端updateMarker调用时传参的顺序。一个快速验证办法把某个车辆的经纬度手动改成你所在城市的已知坐标看标记是否落在正确位置。4.4 数据库连接池耗尽导致接口超时现象是系统跑一段时间后上报接口响应越来越慢最后直接超时。原因是模拟器高频上报每次请求都从连接池拿连接池子被占满。解决方法是调大 HikariCP 的maximum-pool-size同时给上报接口加批量写入逻辑把多次单条插入合并成一次批量插入。常见做法是在application.yml里加spring.datasource.hikari.maximum-pool-size: 20但更根本的是降低上报频率或改批量。4.5 前端地图不显示但接口有数据现象是浏览器 Network 面板里能看到接口返回了车辆数据但地图上就是没有标记。原因是地图 API 的密钥没配或配额用尽。解决方法是打开浏览器控制台看有没有地图 API 的报错信息通常是Invalid Key或Quota Exceeded。换成自己申请的密钥并确认密钥绑定的域名或 IP 与当前访问地址匹配。本地开发时用localhost访问密钥要允许localhost。5. 二次开发与验证把课程设计改成能演示的完整项目5.1 增加线路查询与历史轨迹回放原始源码通常只展示实时位置但答辩或演示时评委最常问的是「能不能看历史轨迹」。加这个功能不难后端加一个按线路和时间范围查bus_location的接口前端用地图 API 的polyline把返回的点串起来。// 历史轨迹查询接口按线路和时间范围过滤 GetMapping(/api/location/history) public Result history(RequestParam int lineId, RequestParam String start, RequestParam String end) { // 时间格式必须是 yyyy-MM-dd HH:mm:ss否则 MyBatis 映射失败 ListBusLocation list busLocationMapper.selectByLineAndTime(lineId, start, end); return Result.success(list); }start和end参数用字符串接收MyBatis 的 XML 里用BETWEEN比较。注意 MySQL 的DATETIME和字符串比较时格式必须完全一致少一位秒都会查不到数据。前端拿到列表后按report_time排序依次addPoint到折线对象上。回放时可以用setInterval逐点显示速度控制在每点 100ms太快看不清太慢演示冷场。5.2 用 Postman 验证接口链路是否完整在改代码之前先用 Postman 把接口跑一遍确认服务端逻辑没问题。建一个 POST 请求地址http://localhost:8080/api/location/reportBody 选 raw JSON填一条车辆数据。发送后看返回是不是success再去数据库SELECT一下确认数据真的写进去了。这一步能帮你把「前端问题」和「后端问题」分开——如果 Postman 能写库但前端地图不动问题就在 WebSocket 或前端渲染如果 Postman 都写不进去问题在服务端或数据库。5.3 压力测试与性能边界确认课程设计通常不要求压测但如果你想让它看起来更专业可以用 JMeter 或简单的for循环模拟多辆车同时上报。观察两个指标接口平均响应时间、数据库 CPU 占用。我一般会跑 50 辆车、每 3 秒上报一次看响应时间是否稳定在 100ms 以内。如果超过 500ms说明连接池或索引有问题回头检查maximum-pool-size和idx_line_time索引。这个测试结果写在报告里比单纯说「系统能跑」有说服力得多。从那以后我每次拿到这类实时监控源码都强制先跑一遍 Postman 验证接口再开前端看推送最后才动代码改功能。顺序反了排查成本翻倍。希望帮到你。本文还有配套的精品资源点击获取 Java公交实时监控系统源码拆解：从环境搭建到WebSocket推送的完整链路
简介这份资源是基于Java实现的公交车实时监控系统设计源码面向具备一定Java基础、希望学习智能交通或微服务架构开发的学生与开发者可用于课程设计、毕业设计或二次开发参考。压缩包共43个文件约61KB以37个Java源文件为核心辅以2个XML配置、1个YAML配置、1个SQL建表脚本及gitignore、txt说明等分别承担业务逻辑、参数配置、数据持久化与项目说明等职责。系统采用Spring Boot构建微服务架构通过RESTful API通信并基于笑园实时公交API获取车辆位置、状态与运行轨迹等数据实现公交车的实时监控。目前已有279人学习浏览。读者可从中获取完整的后端工程结构、API对接思路、配置文件组织方式与数据库脚本理解实时数据流处理与模块化设计方法适合作为智能交通类项目的实践起点。1. 公交实时监控系统源码拆解Java 技术栈能跑出什么效果公交实时监控系统源码核心解决的是「车辆位置怎么实时上报、后台怎么稳定接收、前端怎么低延迟展示」这条链路。这套基于 Java 实现的公交车实时监控系统设计源码把车载终端模拟、服务端接收、数据存储、Web 端展示串成了一条完整可跑的链路适合做课程设计、毕业设计也适合想搞明白实时监控系统骨架的 Java 开发者拿来二次开发。它不是一个只贴几张截图的空壳而是有明确分层、有接口定义、有数据流转的工程结构。你拿到手能直接看到车辆模拟器怎么发数据、服务端怎么接、前端怎么刷。下面按「资源是什么 → 怎么用 → 坑在哪」的顺序把这份源码拆开讲透每一步都落到能复现的操作上。2. 环境搭建与工程结构从 JDK 到数据库的完整落地2.1 技术栈选型与依赖版本确认这套源码的技术栈是典型的 Java Web 组合后端用 Spring Boot 承载 REST API 和 WebSocket 推送持久层用 MyBatis 操作 MySQL前端是 HTML JavaScript 配合地图 API 做轨迹渲染。选这套组合的原因很直接——Spring Boot 内嵌 Tomcat省去单独部署容器的步骤MyBatis 对 SQL 的控制粒度细方便你改查询逻辑WebSocket 保证车辆位置推送不是靠前端轮询硬拉延迟能压到秒级以内。拿到源码包后先别急着导入 IDE。第一步是确认版本匹配这是最容易翻车的地方。常见做法是打开pom.xml核对三处Spring Boot 父版本、MySQL 驱动版本、JDK 编译级别。如果源码写的是 Spring Boot 2.x 配 JDK 8你硬用 JDK 17 去跑大概率在启动时抛InaccessibleObjectException这不是代码问题是模块化访问限制导致的。!-- pom.xml 关键依赖片段核对版本是否与你本地环境一致 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.x/version !-- 若本地是 JDK 17建议升到 3.x 并同步改 javax→jakarta -- /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-websocket/artifactId !-- 实时推送的核心依赖 -- /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.x/version /dependency /dependencies上面这段依赖里spring-boot-starter-websocket是实时监控的命脉没有它前端就只能靠定时器轮询接口车辆一多接口压力直接上来。mysql-connector-java的版本要和你的 MySQL 服务端对齐8.0 的驱动连 5.7 的库通常没问题反过来容易出时区报错。参数上重点看version标签改完记得在 IDE 里刷新 Maven 依赖别只改文件不重载。2.2 数据库建表与初始数据导入工程结构里src/main/resources下一般会有schema.sql或独立的.sql文件这是建表脚本。执行之前先建库字符集用utf8mb4排序规则用utf8mb4_general_ci避免车辆名称或站点名里有特殊字符时插入失败。-- 创建数据库字符集必须指定否则中文站点名会乱码 CREATE DATABASE bus_monitor DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 车辆实时位置表核心字段是经纬度和时间戳 CREATE TABLE bus_location ( id BIGINT AUTO_INCREMENT PRIMARY KEY, bus_no VARCHAR(32) NOT NULL COMMENT 公交车编号, line_id INT NOT NULL COMMENT 线路ID, lng DECIMAL(10,6) NOT NULL COMMENT 经度, lat DECIMAL(10,6) NOT NULL COMMENT 纬度, report_time DATETIME NOT NULL COMMENT 上报时间, INDEX idx_line_time (line_id, report_time) -- 按线路和时间查索引必须建 ) ENGINEInnoDB;建表时最容易忽略的是索引。bus_location表会随车辆上报不断膨胀如果没有idx_line_time这个联合索引前端查某条线路最近一分钟的轨迹时就是全表扫描数据量一上来查询直接卡死。字段类型上经纬度用DECIMAL(10,6)而不是FLOAT因为浮点精度在轨迹回放时会出现位置漂移这是血泪经验。导入初始数据后用SELECT COUNT(*)确认线路表和车辆表都有数据空表会导致前端地图上什么都没有。2.3 配置文件修改与服务启动application.yml是启动前的最后一道关卡。需要改的通常有四项数据库连接、端口、WebSocket 路径、地图 API 密钥。server: port: 8080 # 若被占用改成 8081前端请求地址要同步改 spring: datasource: url: jdbc:mysql://localhost:3306/bus_monitor?useSSLfalseserverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver jackson: time-zone: Asia/Shanghai # 不加这行上报时间会差 8 小时serverTimezoneAsia/Shanghai这个参数是必须的MySQL 8.0 驱动默认用 UTC不指定的话车辆上报时间会比实际早 8 小时前端看到的轨迹时间全是错的。改完配置后在 IDE 里找到主启动类右键运行。控制台出现Started Application in x seconds就算起来了。如果报Communications link failure先确认 MySQL 服务是否启动、端口是否被防火墙拦。启动成功后浏览器访问http://localhost:8080能看到地图页面就说明前后端链路通了。3. 实时数据链路打通模拟器、API 与 WebSocket 推送3.1 车辆位置模拟器的运行与参数调整真实公交车不可能拿来测试所以源码里会带一个模拟器定时生成经纬度并调用上报接口。模拟器一般是一个独立的 Java 类或一个main方法运行后按固定间隔往服务端发数据。// 车辆模拟器核心逻辑按固定间隔上报位置 Scheduled(fixedRate 3000) // 每 3 秒上报一次改这个值控制数据密度 public void reportLocation() { for (Bus bus : busList) { // 沿线路方向做微小偏移模拟车辆行驶 double newLng bus.getLng() (Math.random() - 0.5) * 0.001; double newLat bus.getLat() (Math.random() - 0.5) * 0.001; bus.setLng(newLng); bus.setLat(newLat); // 调用上报接口把数据推给服务端 restTemplate.postForObject(http://localhost:8080/api/location/report, bus, String.class); } }fixedRate 3000表示每 3 秒触发一次这个值决定了前端轨迹的平滑度。设太大车辆会「跳」设太小数据库写入压力大。我一般测试时用 3000演示时用 1000。Math.random()那两行是模拟车辆移动真实场景应该根据线路的站点序列计算下一位置但作为课程设计随机偏移足够展示效果。注意模拟器里的接口地址要和application.yml里的端口一致改了端口这里也要改否则模拟器发出去的数据全打到空气里。3.2 上报接口与 WebSocket 推送的衔接服务端收到上报数据后要做两件事写库、推送给前端。写库用 MyBatis 的insert推送用 WebSocket 的broadcast。这两步的顺序有讲究——先写库再推送保证前端看到的数据一定能从数据库查到如果先推送后写库推送成功但写库失败时前端会显示一条数据库里不存在的位置排查时就是黑匣子。PostMapping(/api/location/report) public Result report(RequestBody BusLocation location) { location.setReportTime(new Date()); busLocationMapper.insert(location); // 先落库 // 再通过 WebSocket 推送给所有订阅该线路的前端 webSocketServer.sendToLine(location.getLineId(), JSON.toJSONString(location)); return Result.success(); }RequestBody把前端传来的 JSON 自动映射成BusLocation对象字段名要一一对应大小写敏感。sendToLine是自定义方法按线路 ID 过滤订阅者避免把所有车辆数据推给所有人。如果前端收不到推送先检查 WebSocket 的连接地址是否和application.yml里配的一致再确认sendToLine里的线路 ID 匹配逻辑有没有写反。常见错误是把lineId当成busNo用结果一条线路的车推到了另一条线路的页面上。3.3 前端地图轨迹渲染与刷新频率控制前端拿到 WebSocket 推送的数据后调用地图 API 的setPosition或polyline更新车辆位置。这里的关键是刷新频率控制——如果每来一条数据就重绘整个地图车辆一多浏览器直接卡死。// WebSocket 接收消息后更新车辆标记用节流控制重绘频率 let pendingUpdates []; const socket new WebSocket(ws://localhost:8080/ws/bus); socket.onmessage function(event) { const data JSON.parse(event.data); pendingUpdates.push(data); // 先缓存不立即重绘 }; // 每 500ms 批量处理一次避免高频重绘 setInterval(() { if (pendingUpdates.length 0) return; pendingUpdates.forEach(item { updateMarker(item.busNo, item.lng, item.lat); // 更新对应车辆的标记 }); pendingUpdates []; // 清空缓存 }, 500);setInterval的 500ms 是节流窗口意思是无论收到多少条推送每半秒才重绘一次。这个值太小起不到节流作用太大轨迹会一顿一顿。updateMarker里要根据busNo找到已有的标记对象只改经纬度不要删了重建重建会导致标记闪烁。如果地图上车辆不动先看pendingUpdates有没有数据进来再看updateMarker里的busNo匹配逻辑——常见坑是推送里的busNo是数字前端存的是字符串比较永远为 false。4. 避坑与排查这套源码跑起来最容易卡在哪4.1 启动报错Table bus_monitor.xxx doesnt exist现象是 Spring Boot 启动时直接抛异常退出日志里明确说某张表不存在。原因通常是建表脚本没执行或者执行到了错误的数据库里。解决方法是登录 MySQL用SHOW TABLES确认当前库里有几张表缺哪张就单独补执行对应的CREATE TABLE语句。注意建表脚本里的USE语句可能指向了别的库名手动改成bus_monitor再跑。4.2 WebSocket 连接返回 404现象是前端控制台报WebSocket connection failed状态码 404。原因是 WebSocket 的服务端注册路径和前端连接路径不一致。解决方法是打开 WebSocket 配置类看registry.addHandler(server, /ws/bus)里的路径再对比前端new WebSocket(ws://...)里的路径两边必须完全一致。另外注意 Spring Boot 2.x 和 3.x 的 WebSocket 配置类包名不同2.x 用javax.websocket3.x 用jakarta.websocket混用直接编译不过。4.3 车辆位置在地图上偏移到国外现象是前端地图上车辆标记出现在完全错误的位置甚至跑到海上。原因是经纬度顺序搞反了。国内地图 API 普遍要求「经度在前、纬度在后」而有些 GPS 数据源是「纬度在前」。解决方法是检查上报接口里lng和lat的赋值顺序以及前端updateMarker调用时传参的顺序。一个快速验证办法把某个车辆的经纬度手动改成你所在城市的已知坐标看标记是否落在正确位置。4.4 数据库连接池耗尽导致接口超时现象是系统跑一段时间后上报接口响应越来越慢最后直接超时。原因是模拟器高频上报每次请求都从连接池拿连接池子被占满。解决方法是调大 HikariCP 的maximum-pool-size同时给上报接口加批量写入逻辑把多次单条插入合并成一次批量插入。常见做法是在application.yml里加spring.datasource.hikari.maximum-pool-size: 20但更根本的是降低上报频率或改批量。4.5 前端地图不显示但接口有数据现象是浏览器 Network 面板里能看到接口返回了车辆数据但地图上就是没有标记。原因是地图 API 的密钥没配或配额用尽。解决方法是打开浏览器控制台看有没有地图 API 的报错信息通常是Invalid Key或Quota Exceeded。换成自己申请的密钥并确认密钥绑定的域名或 IP 与当前访问地址匹配。本地开发时用localhost访问密钥要允许localhost。5. 二次开发与验证把课程设计改成能演示的完整项目5.1 增加线路查询与历史轨迹回放原始源码通常只展示实时位置但答辩或演示时评委最常问的是「能不能看历史轨迹」。加这个功能不难后端加一个按线路和时间范围查bus_location的接口前端用地图 API 的polyline把返回的点串起来。// 历史轨迹查询接口按线路和时间范围过滤 GetMapping(/api/location/history) public Result history(RequestParam int lineId, RequestParam String start, RequestParam String end) { // 时间格式必须是 yyyy-MM-dd HH:mm:ss否则 MyBatis 映射失败 ListBusLocation list busLocationMapper.selectByLineAndTime(lineId, start, end); return Result.success(list); }start和end参数用字符串接收MyBatis 的 XML 里用BETWEEN比较。注意 MySQL 的DATETIME和字符串比较时格式必须完全一致少一位秒都会查不到数据。前端拿到列表后按report_time排序依次addPoint到折线对象上。回放时可以用setInterval逐点显示速度控制在每点 100ms太快看不清太慢演示冷场。5.2 用 Postman 验证接口链路是否完整在改代码之前先用 Postman 把接口跑一遍确认服务端逻辑没问题。建一个 POST 请求地址http://localhost:8080/api/location/reportBody 选 raw JSON填一条车辆数据。发送后看返回是不是success再去数据库SELECT一下确认数据真的写进去了。这一步能帮你把「前端问题」和「后端问题」分开——如果 Postman 能写库但前端地图不动问题就在 WebSocket 或前端渲染如果 Postman 都写不进去问题在服务端或数据库。5.3 压力测试与性能边界确认课程设计通常不要求压测但如果你想让它看起来更专业可以用 JMeter 或简单的for循环模拟多辆车同时上报。观察两个指标接口平均响应时间、数据库 CPU 占用。我一般会跑 50 辆车、每 3 秒上报一次看响应时间是否稳定在 100ms 以内。如果超过 500ms说明连接池或索引有问题回头检查maximum-pool-size和idx_line_time索引。这个测试结果写在报告里比单纯说「系统能跑」有说服力得多。从那以后我每次拿到这类实时监控源码都强制先跑一遍 Postman 验证接口再开前端看推送最后才动代码改功能。顺序反了排查成本翻倍。希望帮到你。本文还有配套的精品资源点击获取