上个月接了个活儿把单位以前线下发手册、集中看视频的应急安全培训整体搬到浏览器里。需求描述短得可怜就一句话——让员工能随时刷应急知识点、看课件、在线考试拿学分。但真正动工后才发现这句话背后起码藏着四五个坑知识分类怎么设计才不用返工播放一个视频怎么判断员工是真学了还是挂机考试抽题怎么保证不固定、不重复考完的错题怎么回流成二次学习素材我后端用了Spring Boot前端选了Vue从原型到上线跑了三周这篇就把整个系统从数据模型、接口设计、前端交互到部署排坑的过程完整复盘一遍。无论是应急培训、企业内训还是知识科普站这套设计思路都能直接改造复用。1. 应急知识学习系统要解决什么需求拆解与边界划定1.1 传统应急培训的三个老大难应急知识类培训有一个特点内容多、场景杂、责任重。火灾逃生、地震避险、心肺复苏、防汛防台、化学品泄漏处置每个大项下面还有细分动作教职员工或一线作业人员根本不可能靠一次集中培训全部记住。以前的做法是发纸质手册集中放视频签到表签字表面看流程完整实际有三处硬伤覆盖不全。倒班人员和驻外人员赶不上集中场次永远在补训名单里循环。效果不可量化。签到只能证明人来了没法证明听进去了考核靠一张纸质卷子改卷和统计要耗费两三天。知识无法沉淀复用。资料都在档案柜里想回看只能翻纸质文档没有人会真的去翻。线上化之后这三块正好是系统的核心价值随时可学、学时可查、效果可测。这也是我一开始就和需求方对齐的三条主线后面所有设计都围绕它们展开。1.2 功能清单哪些先做哪些坚决砍掉我习惯在动手前先列一张功能清单并且明确标出MVP范围。下面这张表供参考实际做的时候可以根据业务裁剪模块功能点优先级用户端知识分类浏览、关键词搜索P0用户端知识点详情、视频课件播放P0用户端在线测评、交卷判分P0用户端错题回顾、个人学习记录P1管理端知识内容维护、分类维护P1管理端题库维护、学习数据统计P2系统学习时长记录、定时提醒P1我当时坚持砍掉的是管理端的复杂权限体系和报表可视化大屏。原因很简单第一版的核心是让学习闭环转起来内容维护用后端接口加简易页面就能顶住等数据积累了几万条再上报表不迟。权限这块先用Spring Security做最基础的用户/角色区分等到真正有十来个后台用户再说细粒度授权。1.3 为什么是Spring Boot Vue以及版本选择选型讨论比功能讨论还热烈。项目组有同事提议用Python Flask或者Go理由都是轻量。我还是坚持Spring Boot理由很实在应急知识学习系统这类项目通常部署在单位内网或者云服务器后续维护的人大概率是Java背景Spring Boot生态里的安全框架、定时任务、数据校验、事务管理都是现成的出了问题网上资料也多。前端不用多说Vue在国内的普及率摆在那里招人容易组件生态成熟。Vue 3 Vite的组合在2024年之后基本是标配了配合Element Plus做后台管理类界面效率很高。这里必须讲一个我最想强调的坑Spring Boot版本别追高。热搜词里常年有springboot版本太高这种问题我自己也遇到过。如果你用的是Spring Boot 3.x它强制要求JDK 17而且javax.servlet包全换成了jakarta.servlet很多老教程和老依赖直接失效如果你的服务器还是JDK 8那就老老实实用Spring Boot 2.7.x兼容性最稳。我这个项目最终选的是Spring Boot 2.7.18 JDK 8前端Vue 3.4 Vite 5。别觉得版本老跑业务系统稳定比什么都重要。2. 后端数据建模与核心接口实现2.1 知识分类体系用编码设计代替树形表应急知识最怕的就是分类设计不灵活。比如今天只有火灾逃生和地震避险下个月突然要加洪涝自救如果分类是写死在代码里的每次都要发版。我用的方案是分类编码表每条知识记录挂一个category_code分类表里维护code和name的一一对应关系。实际表结构如下只列出核心字段CREATE TABLE t_category ( id bigint(20) NOT NULL AUTO_INCREMENT, code varchar(32) NOT NULL COMMENT 分类编码如fire/quake/medical, name varchar(64) NOT NULL COMMENT 分类名称, sort_no int(11) DEFAULT 0, PRIMARY KEY (id), UNIQUE KEY uk_code (code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_knowledge ( id bigint(20) NOT NULL AUTO_INCREMENT, category_code varchar(32) NOT NULL, title varchar(128) NOT NULL, content text COMMENT 图文正文, video_url varchar(255) COMMENT 视频课件地址, study_minutes int(11) DEFAULT 5 COMMENT 预计学习时长(分钟), sort_no int(11) DEFAULT 0, status tinyint(4) DEFAULT 1, PRIMARY KEY (id), KEY idx_category (category_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有个经验分类不要用无限的父子层级最多两级就够了。应急知识学习系统里用户需要的是快速定位到某类知识比如发生地震了想知道怎么避险三步点进去看到答案而不是在一棵五级树里层层展开。两级结构分类知识点响应速度最快也最好维护。2.2 学习记录和测评记录闭环的核心数据光有知识内容还不够必须记录谁在什么时候学了什么、学了多少、考了多少分这才叫学习闭环。我设计了四张核心记录表CREATE TABLE t_learn_record ( id bigint(20) NOT NULL AUTO_INCREMENT, user_id bigint(20) NOT NULL, knowledge_id bigint(20) NOT NULL, start_time datetime DEFAULT NULL, end_time datetime DEFAULT NULL, duration_seconds int(11) DEFAULT 0 COMMENT 累计有效学习秒数, finish_flag tinyint(4) DEFAULT 0 COMMENT 1已完成 0进行中, PRIMARY KEY (id), KEY idx_user (user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_question ( id bigint(20) NOT NULL AUTO_INCREMENT, knowledge_id bigint(20) NOT NULL, category_code varchar(32) NOT NULL, question_type tinyint(4) DEFAULT 1 COMMENT 1单选 2多选 3判断, stem varchar(512) NOT NULL, options text COMMENT 选项JSON, answer varchar(64) NOT NULL, analysis varchar(512) COMMENT 答案解析, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_exam_record ( id bigint(20) NOT NULL AUTO_INCREMENT, user_id bigint(20) NOT NULL, question_id bigint(20) NOT NULL, user_answer varchar(64), correct_flag tinyint(4) DEFAULT 0, create_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_user_q (user_id, question_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;题目表里我刻意加了一个knowledge_id目的是让错题能直接反链回知识点。下面会讲到错题回顾的本质不是再做一遍题而是回到那个没掌握的知识点重新学习这个字段是关键桥梁。2.3 Controller-Service-Mapper分层别在Controller里写业务这个项目体量不大但我依然保持了Spring Boot经典的三层结构。最直观的好处后期加接口、加逻辑时不会互相踩脚。Controller只做参数接收和返回封装Service写业务规则Mapper负责SQL。举例说明获取知识点详情的接口RestController RequestMapping(/api/knowledge) public class KnowledgeController { Resource private KnowledgeService knowledgeService; GetMapping(/detail/{id}) public ResultKnowledgeDetailVO detail(PathVariable Long id) { return Result.success(knowledgeService.getDetail(id)); } }Service里做的事情就多了先查知识点基本信息再查当前用户有没有学习过、有没有考过这一节的题最后组装成详情VO返回。我习惯把返回给前端的对象单独建一个VO不要直接把实体类抛出去。原因有两点一是实体类里可能有冗余字段或者结构不适合前端渲染二是未来表结构调整时VO层可以挡住大部分前端修改。统一返回Result是我每个Spring Boot项目都会做的第一件事public class ResultT { private int code; private String msg; private T data; // 成功、失败静态方法 }配合一个全局异常处理器Controller里基本不用写try-catch代码清爽很多。2.4 学习时长统计怎么判断员工是真学不是挂机这是本项目争议最大、也最值得写的一个设计点。甲方一开始想得很简单点击播放就开始计时播完就算学完。我当然反对——那跟签到有什么区别挂机十分钟照样骗过系统。最终采用的方案是三段式心跳上报前端在页面加载时调用接口记录本次学习开始时间拿到一条learnRecordId播放过程中前端每30秒上报一次心跳附带当前播放进度百分比和视频是否处于播放状态用户关闭页面或视频播放完毕时上报结束事件后端计算总有效时长。后端只认一条规则累计有效时长达到预计学习时长的80%并且播放进度到达100%才算finish_flag1。这里的有效时长需要排除暂停、拖拽跳过的部分所以心跳报文里必须带当前播放位置{ recordId: 1024, progress: 67.5, playing: true, position: 402 }后端Compare前后两次position如果差值过大比如从400秒瞬间跳到350秒判定为拖动重置有效计时。这套逻辑做完甲方专门拿测试账号试着挂了一上午机下午看了一眼统计确认没骗过去才算验收通过。2.5 定时任务学习提醒与进度汇总Spring Boot自带的Scheduled足够应付这个场景。我配了两个任务每天早上9点查询过去一天没有任何学习记录且本月考核未完成的用户给他们生成一条站内信标题就叫您本月的应急知识学习任务尚未完成每周日晚12点把t_learn_record里的原始记录按用户汇总写入一张学习汇总表方便月底导出考核报表。核心代码就一句话Scheduled(cron 0 0 9 * * ?) public void sendStudyReminder() { studyReminderService.remindUnfinishedUsers(); }注意要加上EnableScheduling注解否则任务不会生效。另外一个经验定时任务里不要直接操作大量生产数据先把要处理的数据捞出来放到临时表跑批完成后再做汇总否则大循环很容易拖垮主库。初期数据量小无所谓但数据过万后这个习惯能救命。3. 前端工程搭建与核心页面交互3.1 Vue 3工程初始化目录和依赖前端我用了Vue 3 Vite 5 Element Plus Pinia Axios。初始化命令没什么好讲的重点讲目录组织。我第一次用Vue开发这种中等规模项目时把所有组件都塞在components下面结果两个星期后自己都找不到文件。这次吸取教训按功能模块分src/ ├── api/ # 接口请求层按模块拆分knowledge.js、exam.js、user.js ├── views/ │ ├── home/ # 首页、知识广场 │ ├── learning/ # 学习详情、视频播放 │ ├── exam/ # 在线考试、错题本 │ └── profile/ # 个人中心、学习记录 ├── components/ # 通用组件KnowledgeCard、VideoPlayer、QuestionItem ├── router/ # 路由配置 ├── stores/ # Pinia状态管理 └── utils/ # axios封装、格式化工具这里说一个来源非常广泛的痛点vue项目源码怎么发给别人——很多新手直接把自己本地整个node_modules打包发出去要么巨大要么缺包。正确做法是只发源码目录让同事或服务器端执行npm install或npm ci安装依赖node_modules永远不要进版本库。项目里要写清楚package.json中的scripts命令别人拿到存根就知道怎么运行。3.2 动态路由与菜单权限一版配置处处复用应急知识学习系统有两类用户学员和管理员。学员看到的是知识学习、在线测评、错题本管理员多出内容管理、题库管理、数据统计。菜单权限如果写死在路由表里加个角色就得改前端代码所以我用了动态路由方案。思路是后端根据当前用户角色返回可访问的菜单代码列表前端拿到之后在本地维护一张完整的路由映射表包含所有页面的路径和组件按需注册。// 完整路由映射 const allRoutes [ { path: /home, component: () import(/views/home/index.vue), meta: { code: home } }, { path: /exam, component: () import(/views/exam/index.vue), meta: { code: exam } }, { path: /admin/knowledge, component: () import(/views/admin/knowledge.vue), meta: { code: knowManage } } ]; // 根据菜单code过滤 function buildRoutes(menuCodes) { return allRoutes.filter(r menuCodes.includes(r.meta.code)); } // 注册动态路由 router.addRoute(route);这里有个细节容易忽略静态路由登录页、404页在初始化时就注册动态路由在用户登录拿到菜单后再注册。退出登录时必须遍历动态路由名逐个删除否则下一个用户登录会看到上个用户的菜单残留。我的做法是在store里记录一个dynamicRoutes数组登出时统一router.removeRoute。3.3 视频课件播放m3u8格式的接入经验应急知识课件很多是从内部培训系统导出的最常见的格式不是mp4而是m3u8流媒体切片。第一次接的时候我也有点懵查了一圈发现方案很成熟用hls.js插件把m3u8地址喂给浏览器它会自动分段拉取ts切片在页面上原生播放。实际接入步骤非常简单npm install hls.js然后在视频组件里判断浏览器是否原生支持HLSSafari可以直接播不支持的就走hls.jsimport Hls from hls.js; function initPlayer(url) { if (Hls.isSupported()) { const hls new Hls(); hls.loadSource(url); hls.attachMedia(videoElement); hls.on(Hls.Events.MANIFEST_PARSED, () videoElement.play()); } }需要注意m3u8地址存在CORS限制如果视频源和前端站点不在同一个域名后端网关要加上跨域响应头否则hls.js在拉取ts切片时会被浏览器拦截。这个坑我查了一个下午最后给Nginx加了一行add_header才解决。还有一个经验播放器的进度条事件要和前面说的心跳上报联动播放中每30秒拿一次currentTime封装成心跳对象发给后端。3.4 组件插槽知识卡片怎么做才灵活这个项目里有很多列表卡片知识列表、错题列表、考试记录结构都是标题 摘要 状态角标 操作按钮。如果每个页面复制粘贴一套模板改起来就要改四五个文件。我用Slot插槽做了一套通用卡片组件。组件里定义三个插槽位默认插槽展示卡片主内容标题、简介具名插槽status放右上角的角标比如已完成待学习87分作用域插槽action暴露当前数据对象给父组件调用方自己决定放什么按钮。template div classbase-card div classcard-body slot/slot div classcard-status slot namestatus/slot /div /div div classcard-footer slot nameaction :itemitem/slot /div /div /template调用方使用起来很干净BaseCard v-foritem in list :keyitem.id :itemitem template #default h3{{ item.title }}/h3 p{{ item.summary }}/p /template template #status el-tag v-ifitem.finished已完成/el-tag el-tag v-else typewarning待学习/el-tag /template template #action{ item } el-button clickgoDetail(item.id)开始学习/el-button /template /BaseCard插槽最大的价值是把卡片容器样式和业务内容解耦。设计师后面说卡片要加圆角阴影我一处改动所有列表同步生效省下来的时间足够我多写两个接口。3.5 Axios封装统一拦错误、统一带Token我用Axios做请求层封装了两层拦截器请求拦截器从Pinia store里取出token放到Header。没有token就跳登录页。响应拦截器判断后端返回的code。code0表示成功直接返回datacode401表示token过期清空登录态并跳登录其他code统一弹出ElMessage提示错误信息。const service axios.create({ baseURL: /api, timeout: 10000 }); service.interceptors.request.use(config { const token useUserStore().token; if (token) config.headers[Authorization] Bearer token; return config; }); service.interceptors.response.use( res { const { code, msg, data } res.data; if (code 0) return data; ElMessage.error(msg || 请求失败); return Promise.reject(new Error(msg)); }, err { if (err.response err.response.status 401) { useUserStore().logout(); router.push(/login); } return Promise.reject(err); } );Axios封装做得好整个项目里的页面代码会非常清爽每个接口函数只需要写一行return service.get(/url, { params })。做后端接口联动联调的时候也方便统一mock数据。4. 测评闭环组卷、判分与错题沉淀4.1 题库结构题目怎么关联知识点测评模块是应急学习系统里最容易做浅的部分——很多人做个单选题列表就开始判分。但应急知识的测评有个特殊要求考试不是为了难倒人而是为了检验知识掌握情况所以每道题必须和前面学的知识点强关联。设计题目时我强制要求每一题的knowledge_id必须填写题干内容必须能在对应知识点里找到出处。比如知识点火灾逃生下面可能会有三题浓烟中如何前行、灭火器使用步骤、逃生通道选择。学员如果答错系统能立刻知道他是哪个知识点没掌握这就是错题反链的基础。4.2 随机组卷逻辑按分类权重抽题组卷接口我放在后端做而不是前端从题库里拉全部题再自己选。原因很直接前端组卷的话把整个题库下发给浏览器既不安全也浪费流量。组卷逻辑按分类权重控制一次考试10题其中火灾3题、地震3题、急救2题、综合2题。每个分类内部随机抽题保证不同用户、不同次考试的题目不同public ListQuestion generatePaper(Long userId, int totalCount) { // 1. 查分类权重配置 // 2. 遍历每个分类按权重数量随机抽题 // 3. 汇总题目打乱顺序返回 }MySQL里的随机抽题不建议用ORDER BY RAND()表大了之后性能很差。我的做法是先SELECT id最小值和最大值用Math.random()生成随机id区间再去捞题目如果ID不连续就补捞一次。应急学习题库几百道题这个方案完全够用而且速度是毫秒级。4.3 判分与成绩落库答完立刻看到深度报告交卷接口是ExamController里逻辑最复杂的一个。前端把整个答题数组题目id用户答案一次性提交后端逐题判分把每一题的正误、用户答案、正确答案回传。好处是前端不用自己判分满分计算、答案校验都统一由后端负责。PostMapping(/submit) public ResultExamResultVO submit(RequestBody ExamSubmitDTO dto) { // 1. 遍历答题数组 // 2. 查标准答案比对 // 3. 写入t_exam_record // 4. 错题写入错题标记 // 5. 计算得分按知识点维度统计正确率 }返回给前端的ExamResultVO不只有得分还包含按知识点统计的掌握率。比如学员考了60分报告中会显示火灾知识点正确率40%、地震知识点正确率80%、急救知识点正确率50%。这让考试不再是冷冰冰的分数而是能指导后续学习的诊断报告。学员一眼看出自己火灾相关知识最薄弱回头重点刷那几篇课件学习闭环就真正转起来了。4.4 错题回顾从错题反链到知识点错题回顾模块我做的不是简单的把错题重新做一遍而是错题知识点联动。错题列表里每道错题旁边都有一个查看知识点按钮点击直接跳到对应的知识点详情页重新看课件再回来继续答题。实现上有个关键逻辑一道题如果连续两次答对就从错题本里自动移除避免已经掌握的题目反复出现在待办里。如果依然答错则保留并增加出现次数。这个业务逻辑写在Service层public void reviewWrongQuestion(Long userId, Long questionId, boolean correct) { if (correct) { // 如果最近两次都答对标记为已掌握 } else { // 更新错误次数重置最近连续答对次数 } }错题本页面还增加了筛选功能只看某个分类下的错题、只看最近一周的错题。这些功能看着不起眼但对学习型产品来说用户粘性往往就是靠这些细节点滴积累起来的。我见过太多学习系统做成了会移动的题库不关注错题沉淀学员永远在低效重复只有体验过错题自动归入待复习的人才知道这套设计有多省心。5. 部署上线与实战排坑5.1 打包细节前后端如何优雅交给服务器部署前要解决的最基本问题就是打包。后端我用Maven打包这里有个重要提醒Spring Boot项目打包时默认打的jar包内嵌了Tomcat这个jar是能独立运行的但Maven配置里如果同时引入了spring-boot-maven-plugin和普通repackage容易打出不可执行的普通jar。正确做法是把spring-boot-maven-plugin配置在插件列表里且要让repackage执行在package阶段。打包命令mvn clean package -DskipTests前端打包相对简单npm run build产物会生成在dist目录里面是纯静态文件。有一个新手特别常见的问题前端vue项目源码怎么发给别人——不是发node_modules也不是发整个工程而是发dist目录或者发源码依赖清单让对方自己构建。我一般两边都做源码进Gitdist打进服务器镜像确保服务器上随时能还原到线上版本。5.2 Nginx配置前端静态资源与后端接口分离我的部署架构是一台服务器Nginx托前端静态文件同时把/api前缀的请求反向代理到后端8080端口。这样前后端服务域名一致不存在跨域问题也省去CORS配置。Nginx核心配置如下server { listen 80; server_name your-domain.com; # 前端静态资源 location / { root /opt/emergency-web/dist; index index.html; try_files $uri $uri/ /index.html; } # 后端接口反代 location /api/ { proxy_pass http://127.0.0.1:8080/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }try_files那一行很重要它解决了Vue Router history模式下刷新页面404的问题。如果不加这一行用户访问/home时刷新一下Nginx找不到对应的物理文件会直接返回404对学习系统这种强导航应用来说这是不可接受的。5.3 三个让我印象深刻的部署坑第一个坑是跨域响应头。m3u8视频源放在另一个服务器上Nginx反代虽然加了/api代理但视频文件单独走文件服务器ts切片请求会被浏览器CORS拦截。排查了半天最后在视频源服务器的Nginx配置里加上这行才解决add_header Access-Control-Allow-Origin *;第二个坑是时区问题。后端服务器默认时区是UTC前台上报的学习记录时间比北京时间晚了8个小时导致今日学习时长统计一直是0。解决办法是在启动参数里强制指定时区java -jar -Duser.timezoneGMT08 emergency-system.jar第三个坑是上传大小限制。应急课件经常是大视频后端Spring Boot默认上传大小是1MB前端传课件报错。需要手动调整配置spring: servlet: multipart: max-file-size: 512MB max-request-size: 512MB这三点都不是高深技术但任何一个不提前处理上线当天都会变成事故现场。我建议在写部署文档时把环境变量、超时时间、上传限制、时区配置这些隐形参数单独列一节防止第二次部署时全部重新踩一遍。最后说一点个人体会。做完这个应急知识学习系统我最大的感受是这类业务系统的技术难度其实并不高难的是把学习闭环想透彻。你得让用户学得下去、学得有效、学完有反馈。Spring Boot和Vue只是工具真正的产品灵魂在数据模型的设计、在错题反链知识点的逻辑、在防挂机机制里的那几行心跳代码。如果你也在做类似的系统建议先花两天把业务闭环画清楚再打开IDEA写第一行代码——顺序反了后面一定会返工。
上个月接了个活儿把单位以前线下发手册、集中看视频的应急安全培训整体搬到浏览器里。需求描述短得可怜就一句话——让员工能随时刷应急知识点、看课件、在线考试拿学分。但真正动工后才发现这句话背后起码藏着四五个坑知识分类怎么设计才不用返工播放一个视频怎么判断员工是真学了还是挂机考试抽题怎么保证不固定、不重复考完的错题怎么回流成二次学习素材我后端用了Spring Boot前端选了Vue从原型到上线跑了三周这篇就把整个系统从数据模型、接口设计、前端交互到部署排坑的过程完整复盘一遍。无论是应急培训、企业内训还是知识科普站这套设计思路都能直接改造复用。1. 应急知识学习系统要解决什么需求拆解与边界划定1.1 传统应急培训的三个老大难应急知识类培训有一个特点内容多、场景杂、责任重。火灾逃生、地震避险、心肺复苏、防汛防台、化学品泄漏处置每个大项下面还有细分动作教职员工或一线作业人员根本不可能靠一次集中培训全部记住。以前的做法是发纸质手册集中放视频签到表签字表面看流程完整实际有三处硬伤覆盖不全。倒班人员和驻外人员赶不上集中场次永远在补训名单里循环。效果不可量化。签到只能证明人来了没法证明听进去了考核靠一张纸质卷子改卷和统计要耗费两三天。知识无法沉淀复用。资料都在档案柜里想回看只能翻纸质文档没有人会真的去翻。线上化之后这三块正好是系统的核心价值随时可学、学时可查、效果可测。这也是我一开始就和需求方对齐的三条主线后面所有设计都围绕它们展开。1.2 功能清单哪些先做哪些坚决砍掉我习惯在动手前先列一张功能清单并且明确标出MVP范围。下面这张表供参考实际做的时候可以根据业务裁剪模块功能点优先级用户端知识分类浏览、关键词搜索P0用户端知识点详情、视频课件播放P0用户端在线测评、交卷判分P0用户端错题回顾、个人学习记录P1管理端知识内容维护、分类维护P1管理端题库维护、学习数据统计P2系统学习时长记录、定时提醒P1我当时坚持砍掉的是管理端的复杂权限体系和报表可视化大屏。原因很简单第一版的核心是让学习闭环转起来内容维护用后端接口加简易页面就能顶住等数据积累了几万条再上报表不迟。权限这块先用Spring Security做最基础的用户/角色区分等到真正有十来个后台用户再说细粒度授权。1.3 为什么是Spring Boot Vue以及版本选择选型讨论比功能讨论还热烈。项目组有同事提议用Python Flask或者Go理由都是轻量。我还是坚持Spring Boot理由很实在应急知识学习系统这类项目通常部署在单位内网或者云服务器后续维护的人大概率是Java背景Spring Boot生态里的安全框架、定时任务、数据校验、事务管理都是现成的出了问题网上资料也多。前端不用多说Vue在国内的普及率摆在那里招人容易组件生态成熟。Vue 3 Vite的组合在2024年之后基本是标配了配合Element Plus做后台管理类界面效率很高。这里必须讲一个我最想强调的坑Spring Boot版本别追高。热搜词里常年有springboot版本太高这种问题我自己也遇到过。如果你用的是Spring Boot 3.x它强制要求JDK 17而且javax.servlet包全换成了jakarta.servlet很多老教程和老依赖直接失效如果你的服务器还是JDK 8那就老老实实用Spring Boot 2.7.x兼容性最稳。我这个项目最终选的是Spring Boot 2.7.18 JDK 8前端Vue 3.4 Vite 5。别觉得版本老跑业务系统稳定比什么都重要。2. 后端数据建模与核心接口实现2.1 知识分类体系用编码设计代替树形表应急知识最怕的就是分类设计不灵活。比如今天只有火灾逃生和地震避险下个月突然要加洪涝自救如果分类是写死在代码里的每次都要发版。我用的方案是分类编码表每条知识记录挂一个category_code分类表里维护code和name的一一对应关系。实际表结构如下只列出核心字段CREATE TABLE t_category ( id bigint(20) NOT NULL AUTO_INCREMENT, code varchar(32) NOT NULL COMMENT 分类编码如fire/quake/medical, name varchar(64) NOT NULL COMMENT 分类名称, sort_no int(11) DEFAULT 0, PRIMARY KEY (id), UNIQUE KEY uk_code (code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_knowledge ( id bigint(20) NOT NULL AUTO_INCREMENT, category_code varchar(32) NOT NULL, title varchar(128) NOT NULL, content text COMMENT 图文正文, video_url varchar(255) COMMENT 视频课件地址, study_minutes int(11) DEFAULT 5 COMMENT 预计学习时长(分钟), sort_no int(11) DEFAULT 0, status tinyint(4) DEFAULT 1, PRIMARY KEY (id), KEY idx_category (category_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有个经验分类不要用无限的父子层级最多两级就够了。应急知识学习系统里用户需要的是快速定位到某类知识比如发生地震了想知道怎么避险三步点进去看到答案而不是在一棵五级树里层层展开。两级结构分类知识点响应速度最快也最好维护。2.2 学习记录和测评记录闭环的核心数据光有知识内容还不够必须记录谁在什么时候学了什么、学了多少、考了多少分这才叫学习闭环。我设计了四张核心记录表CREATE TABLE t_learn_record ( id bigint(20) NOT NULL AUTO_INCREMENT, user_id bigint(20) NOT NULL, knowledge_id bigint(20) NOT NULL, start_time datetime DEFAULT NULL, end_time datetime DEFAULT NULL, duration_seconds int(11) DEFAULT 0 COMMENT 累计有效学习秒数, finish_flag tinyint(4) DEFAULT 0 COMMENT 1已完成 0进行中, PRIMARY KEY (id), KEY idx_user (user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_question ( id bigint(20) NOT NULL AUTO_INCREMENT, knowledge_id bigint(20) NOT NULL, category_code varchar(32) NOT NULL, question_type tinyint(4) DEFAULT 1 COMMENT 1单选 2多选 3判断, stem varchar(512) NOT NULL, options text COMMENT 选项JSON, answer varchar(64) NOT NULL, analysis varchar(512) COMMENT 答案解析, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_exam_record ( id bigint(20) NOT NULL AUTO_INCREMENT, user_id bigint(20) NOT NULL, question_id bigint(20) NOT NULL, user_answer varchar(64), correct_flag tinyint(4) DEFAULT 0, create_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_user_q (user_id, question_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;题目表里我刻意加了一个knowledge_id目的是让错题能直接反链回知识点。下面会讲到错题回顾的本质不是再做一遍题而是回到那个没掌握的知识点重新学习这个字段是关键桥梁。2.3 Controller-Service-Mapper分层别在Controller里写业务这个项目体量不大但我依然保持了Spring Boot经典的三层结构。最直观的好处后期加接口、加逻辑时不会互相踩脚。Controller只做参数接收和返回封装Service写业务规则Mapper负责SQL。举例说明获取知识点详情的接口RestController RequestMapping(/api/knowledge) public class KnowledgeController { Resource private KnowledgeService knowledgeService; GetMapping(/detail/{id}) public ResultKnowledgeDetailVO detail(PathVariable Long id) { return Result.success(knowledgeService.getDetail(id)); } }Service里做的事情就多了先查知识点基本信息再查当前用户有没有学习过、有没有考过这一节的题最后组装成详情VO返回。我习惯把返回给前端的对象单独建一个VO不要直接把实体类抛出去。原因有两点一是实体类里可能有冗余字段或者结构不适合前端渲染二是未来表结构调整时VO层可以挡住大部分前端修改。统一返回Result是我每个Spring Boot项目都会做的第一件事public class ResultT { private int code; private String msg; private T data; // 成功、失败静态方法 }配合一个全局异常处理器Controller里基本不用写try-catch代码清爽很多。2.4 学习时长统计怎么判断员工是真学不是挂机这是本项目争议最大、也最值得写的一个设计点。甲方一开始想得很简单点击播放就开始计时播完就算学完。我当然反对——那跟签到有什么区别挂机十分钟照样骗过系统。最终采用的方案是三段式心跳上报前端在页面加载时调用接口记录本次学习开始时间拿到一条learnRecordId播放过程中前端每30秒上报一次心跳附带当前播放进度百分比和视频是否处于播放状态用户关闭页面或视频播放完毕时上报结束事件后端计算总有效时长。后端只认一条规则累计有效时长达到预计学习时长的80%并且播放进度到达100%才算finish_flag1。这里的有效时长需要排除暂停、拖拽跳过的部分所以心跳报文里必须带当前播放位置{ recordId: 1024, progress: 67.5, playing: true, position: 402 }后端Compare前后两次position如果差值过大比如从400秒瞬间跳到350秒判定为拖动重置有效计时。这套逻辑做完甲方专门拿测试账号试着挂了一上午机下午看了一眼统计确认没骗过去才算验收通过。2.5 定时任务学习提醒与进度汇总Spring Boot自带的Scheduled足够应付这个场景。我配了两个任务每天早上9点查询过去一天没有任何学习记录且本月考核未完成的用户给他们生成一条站内信标题就叫您本月的应急知识学习任务尚未完成每周日晚12点把t_learn_record里的原始记录按用户汇总写入一张学习汇总表方便月底导出考核报表。核心代码就一句话Scheduled(cron 0 0 9 * * ?) public void sendStudyReminder() { studyReminderService.remindUnfinishedUsers(); }注意要加上EnableScheduling注解否则任务不会生效。另外一个经验定时任务里不要直接操作大量生产数据先把要处理的数据捞出来放到临时表跑批完成后再做汇总否则大循环很容易拖垮主库。初期数据量小无所谓但数据过万后这个习惯能救命。3. 前端工程搭建与核心页面交互3.1 Vue 3工程初始化目录和依赖前端我用了Vue 3 Vite 5 Element Plus Pinia Axios。初始化命令没什么好讲的重点讲目录组织。我第一次用Vue开发这种中等规模项目时把所有组件都塞在components下面结果两个星期后自己都找不到文件。这次吸取教训按功能模块分src/ ├── api/ # 接口请求层按模块拆分knowledge.js、exam.js、user.js ├── views/ │ ├── home/ # 首页、知识广场 │ ├── learning/ # 学习详情、视频播放 │ ├── exam/ # 在线考试、错题本 │ └── profile/ # 个人中心、学习记录 ├── components/ # 通用组件KnowledgeCard、VideoPlayer、QuestionItem ├── router/ # 路由配置 ├── stores/ # Pinia状态管理 └── utils/ # axios封装、格式化工具这里说一个来源非常广泛的痛点vue项目源码怎么发给别人——很多新手直接把自己本地整个node_modules打包发出去要么巨大要么缺包。正确做法是只发源码目录让同事或服务器端执行npm install或npm ci安装依赖node_modules永远不要进版本库。项目里要写清楚package.json中的scripts命令别人拿到存根就知道怎么运行。3.2 动态路由与菜单权限一版配置处处复用应急知识学习系统有两类用户学员和管理员。学员看到的是知识学习、在线测评、错题本管理员多出内容管理、题库管理、数据统计。菜单权限如果写死在路由表里加个角色就得改前端代码所以我用了动态路由方案。思路是后端根据当前用户角色返回可访问的菜单代码列表前端拿到之后在本地维护一张完整的路由映射表包含所有页面的路径和组件按需注册。// 完整路由映射 const allRoutes [ { path: /home, component: () import(/views/home/index.vue), meta: { code: home } }, { path: /exam, component: () import(/views/exam/index.vue), meta: { code: exam } }, { path: /admin/knowledge, component: () import(/views/admin/knowledge.vue), meta: { code: knowManage } } ]; // 根据菜单code过滤 function buildRoutes(menuCodes) { return allRoutes.filter(r menuCodes.includes(r.meta.code)); } // 注册动态路由 router.addRoute(route);这里有个细节容易忽略静态路由登录页、404页在初始化时就注册动态路由在用户登录拿到菜单后再注册。退出登录时必须遍历动态路由名逐个删除否则下一个用户登录会看到上个用户的菜单残留。我的做法是在store里记录一个dynamicRoutes数组登出时统一router.removeRoute。3.3 视频课件播放m3u8格式的接入经验应急知识课件很多是从内部培训系统导出的最常见的格式不是mp4而是m3u8流媒体切片。第一次接的时候我也有点懵查了一圈发现方案很成熟用hls.js插件把m3u8地址喂给浏览器它会自动分段拉取ts切片在页面上原生播放。实际接入步骤非常简单npm install hls.js然后在视频组件里判断浏览器是否原生支持HLSSafari可以直接播不支持的就走hls.jsimport Hls from hls.js; function initPlayer(url) { if (Hls.isSupported()) { const hls new Hls(); hls.loadSource(url); hls.attachMedia(videoElement); hls.on(Hls.Events.MANIFEST_PARSED, () videoElement.play()); } }需要注意m3u8地址存在CORS限制如果视频源和前端站点不在同一个域名后端网关要加上跨域响应头否则hls.js在拉取ts切片时会被浏览器拦截。这个坑我查了一个下午最后给Nginx加了一行add_header才解决。还有一个经验播放器的进度条事件要和前面说的心跳上报联动播放中每30秒拿一次currentTime封装成心跳对象发给后端。3.4 组件插槽知识卡片怎么做才灵活这个项目里有很多列表卡片知识列表、错题列表、考试记录结构都是标题 摘要 状态角标 操作按钮。如果每个页面复制粘贴一套模板改起来就要改四五个文件。我用Slot插槽做了一套通用卡片组件。组件里定义三个插槽位默认插槽展示卡片主内容标题、简介具名插槽status放右上角的角标比如已完成待学习87分作用域插槽action暴露当前数据对象给父组件调用方自己决定放什么按钮。template div classbase-card div classcard-body slot/slot div classcard-status slot namestatus/slot /div /div div classcard-footer slot nameaction :itemitem/slot /div /div /template调用方使用起来很干净BaseCard v-foritem in list :keyitem.id :itemitem template #default h3{{ item.title }}/h3 p{{ item.summary }}/p /template template #status el-tag v-ifitem.finished已完成/el-tag el-tag v-else typewarning待学习/el-tag /template template #action{ item } el-button clickgoDetail(item.id)开始学习/el-button /template /BaseCard插槽最大的价值是把卡片容器样式和业务内容解耦。设计师后面说卡片要加圆角阴影我一处改动所有列表同步生效省下来的时间足够我多写两个接口。3.5 Axios封装统一拦错误、统一带Token我用Axios做请求层封装了两层拦截器请求拦截器从Pinia store里取出token放到Header。没有token就跳登录页。响应拦截器判断后端返回的code。code0表示成功直接返回datacode401表示token过期清空登录态并跳登录其他code统一弹出ElMessage提示错误信息。const service axios.create({ baseURL: /api, timeout: 10000 }); service.interceptors.request.use(config { const token useUserStore().token; if (token) config.headers[Authorization] Bearer token; return config; }); service.interceptors.response.use( res { const { code, msg, data } res.data; if (code 0) return data; ElMessage.error(msg || 请求失败); return Promise.reject(new Error(msg)); }, err { if (err.response err.response.status 401) { useUserStore().logout(); router.push(/login); } return Promise.reject(err); } );Axios封装做得好整个项目里的页面代码会非常清爽每个接口函数只需要写一行return service.get(/url, { params })。做后端接口联动联调的时候也方便统一mock数据。4. 测评闭环组卷、判分与错题沉淀4.1 题库结构题目怎么关联知识点测评模块是应急学习系统里最容易做浅的部分——很多人做个单选题列表就开始判分。但应急知识的测评有个特殊要求考试不是为了难倒人而是为了检验知识掌握情况所以每道题必须和前面学的知识点强关联。设计题目时我强制要求每一题的knowledge_id必须填写题干内容必须能在对应知识点里找到出处。比如知识点火灾逃生下面可能会有三题浓烟中如何前行、灭火器使用步骤、逃生通道选择。学员如果答错系统能立刻知道他是哪个知识点没掌握这就是错题反链的基础。4.2 随机组卷逻辑按分类权重抽题组卷接口我放在后端做而不是前端从题库里拉全部题再自己选。原因很直接前端组卷的话把整个题库下发给浏览器既不安全也浪费流量。组卷逻辑按分类权重控制一次考试10题其中火灾3题、地震3题、急救2题、综合2题。每个分类内部随机抽题保证不同用户、不同次考试的题目不同public ListQuestion generatePaper(Long userId, int totalCount) { // 1. 查分类权重配置 // 2. 遍历每个分类按权重数量随机抽题 // 3. 汇总题目打乱顺序返回 }MySQL里的随机抽题不建议用ORDER BY RAND()表大了之后性能很差。我的做法是先SELECT id最小值和最大值用Math.random()生成随机id区间再去捞题目如果ID不连续就补捞一次。应急学习题库几百道题这个方案完全够用而且速度是毫秒级。4.3 判分与成绩落库答完立刻看到深度报告交卷接口是ExamController里逻辑最复杂的一个。前端把整个答题数组题目id用户答案一次性提交后端逐题判分把每一题的正误、用户答案、正确答案回传。好处是前端不用自己判分满分计算、答案校验都统一由后端负责。PostMapping(/submit) public ResultExamResultVO submit(RequestBody ExamSubmitDTO dto) { // 1. 遍历答题数组 // 2. 查标准答案比对 // 3. 写入t_exam_record // 4. 错题写入错题标记 // 5. 计算得分按知识点维度统计正确率 }返回给前端的ExamResultVO不只有得分还包含按知识点统计的掌握率。比如学员考了60分报告中会显示火灾知识点正确率40%、地震知识点正确率80%、急救知识点正确率50%。这让考试不再是冷冰冰的分数而是能指导后续学习的诊断报告。学员一眼看出自己火灾相关知识最薄弱回头重点刷那几篇课件学习闭环就真正转起来了。4.4 错题回顾从错题反链到知识点错题回顾模块我做的不是简单的把错题重新做一遍而是错题知识点联动。错题列表里每道错题旁边都有一个查看知识点按钮点击直接跳到对应的知识点详情页重新看课件再回来继续答题。实现上有个关键逻辑一道题如果连续两次答对就从错题本里自动移除避免已经掌握的题目反复出现在待办里。如果依然答错则保留并增加出现次数。这个业务逻辑写在Service层public void reviewWrongQuestion(Long userId, Long questionId, boolean correct) { if (correct) { // 如果最近两次都答对标记为已掌握 } else { // 更新错误次数重置最近连续答对次数 } }错题本页面还增加了筛选功能只看某个分类下的错题、只看最近一周的错题。这些功能看着不起眼但对学习型产品来说用户粘性往往就是靠这些细节点滴积累起来的。我见过太多学习系统做成了会移动的题库不关注错题沉淀学员永远在低效重复只有体验过错题自动归入待复习的人才知道这套设计有多省心。5. 部署上线与实战排坑5.1 打包细节前后端如何优雅交给服务器部署前要解决的最基本问题就是打包。后端我用Maven打包这里有个重要提醒Spring Boot项目打包时默认打的jar包内嵌了Tomcat这个jar是能独立运行的但Maven配置里如果同时引入了spring-boot-maven-plugin和普通repackage容易打出不可执行的普通jar。正确做法是把spring-boot-maven-plugin配置在插件列表里且要让repackage执行在package阶段。打包命令mvn clean package -DskipTests前端打包相对简单npm run build产物会生成在dist目录里面是纯静态文件。有一个新手特别常见的问题前端vue项目源码怎么发给别人——不是发node_modules也不是发整个工程而是发dist目录或者发源码依赖清单让对方自己构建。我一般两边都做源码进Gitdist打进服务器镜像确保服务器上随时能还原到线上版本。5.2 Nginx配置前端静态资源与后端接口分离我的部署架构是一台服务器Nginx托前端静态文件同时把/api前缀的请求反向代理到后端8080端口。这样前后端服务域名一致不存在跨域问题也省去CORS配置。Nginx核心配置如下server { listen 80; server_name your-domain.com; # 前端静态资源 location / { root /opt/emergency-web/dist; index index.html; try_files $uri $uri/ /index.html; } # 后端接口反代 location /api/ { proxy_pass http://127.0.0.1:8080/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }try_files那一行很重要它解决了Vue Router history模式下刷新页面404的问题。如果不加这一行用户访问/home时刷新一下Nginx找不到对应的物理文件会直接返回404对学习系统这种强导航应用来说这是不可接受的。5.3 三个让我印象深刻的部署坑第一个坑是跨域响应头。m3u8视频源放在另一个服务器上Nginx反代虽然加了/api代理但视频文件单独走文件服务器ts切片请求会被浏览器CORS拦截。排查了半天最后在视频源服务器的Nginx配置里加上这行才解决add_header Access-Control-Allow-Origin *;第二个坑是时区问题。后端服务器默认时区是UTC前台上报的学习记录时间比北京时间晚了8个小时导致今日学习时长统计一直是0。解决办法是在启动参数里强制指定时区java -jar -Duser.timezoneGMT08 emergency-system.jar第三个坑是上传大小限制。应急课件经常是大视频后端Spring Boot默认上传大小是1MB前端传课件报错。需要手动调整配置spring: servlet: multipart: max-file-size: 512MB max-request-size: 512MB这三点都不是高深技术但任何一个不提前处理上线当天都会变成事故现场。我建议在写部署文档时把环境变量、超时时间、上传限制、时区配置这些隐形参数单独列一节防止第二次部署时全部重新踩一遍。最后说一点个人体会。做完这个应急知识学习系统我最大的感受是这类业务系统的技术难度其实并不高难的是把学习闭环想透彻。你得让用户学得下去、学得有效、学完有反馈。Spring Boot和Vue只是工具真正的产品灵魂在数据模型的设计、在错题反链知识点的逻辑、在防挂机机制里的那几行心跳代码。如果你也在做类似的系统建议先花两天把业务闭环画清楚再打开IDEA写第一行代码——顺序反了后面一定会返工。
