一个数学老师说要出一套期中考试卷从前几天就在后台选题、排版、调格式直到考试前一天晚上才定稿。我就是在那个时候意识到一个能自动组卷的web系统并不是把题目堆在一起那么简单。它要把题库、知识点、难度系数、题型分布、重复规避全部串起来还要让教研员能一键生成可打印的PDF。这个基于SpringBootVue的数学题库组卷系统就是围绕这些真实场景做的。如果你正想找一份能跑起来、能部署、能讲解代码的Java全栈练手项目或者你本身就在做在线教育相关的业务这篇东西能给你省不少事。下面我会把它的设计思路、核心代码、部署过程和我踩过的一些坑一次性讲透。1. 项目拆解数学题库组卷系统到底在解决什么问题1.1 组卷系统的业务痛点与核心流程先聊需求。数学组卷这个场景里最麻烦的不是“存题目”而是“按规则抽题”。一份正规的数学试卷有固定结构选择题、填空题、计算题、解答题每个大题下可能还有具体知识点要求。比如高一期中考试要求“函数单调性”出2道选择、1道填空、1道解答难度系数控制在0.65左右。如果靠人工翻题库眼睛都能看花。更烦的是组完卷还要检查有没有重复题、有没有超出大纲、各章节分值是否均衡。这些重复劳动正是系统要解决的核心问题。所以这个系统的主流程围绕四件事展开题库维护、知识点管理、组卷策略配置、试卷生成与导出。题库维护是最基础的需要支持批量导入题目题目至少要包含题干、答案、解析、知识点标签、题型、难度等级。知识点管理要按教材章节和知识点分层比如“必修一集合”下面再挂“子集”“交集”“补集”等小点。组卷策略配置是核心用户选择考试年级、教材版本、总分值、各题型题量、难度区间系统根据这些条件到题库里抽取题目。最后生成试卷预览支持调整题目顺序、替换题目再导出成Word或PDF。整个链路看起来很常规真正实现时细节特别多。1.2 技术选型为什么是SpringBootVue而不是其他组合有人问为什么非要SpringBootVue用Python的Flask加React不行吗行是行但在校招简历、课程设计和很多企业内部系统中SpringBootVue就是事实标准。学校或教育机构的服务器大多还是Windows Server或者Linux部署一个SpringBoot的Jar包非常省心自带Tomcat不需要额外装Apache。前端选Vue是因为它的生态成熟Element UI组件库直接能把后台管理的布局、表格、表单搞定开发效率比手动写jQuery高好几个档次。加上Vue的双向绑定在组卷的参数配置表单里改一个数字预览区马上刷新交互体验很直观。另外一个重要原因是JWT鉴权和RBAC权限模型在SpringBoot里的实现太方便了。SpringSecurity加一个注解就能控制接口权限配合Redis可以把用户会话集中管理。Vue侧用Vue Router的守卫判断路由访问权限配合Axios拦截器统一携带Token整套鉴权链路闭合。这种组合对“快速交付一个后台管理类系统”来说是经过大量项目验证的稳妥方案。如果你只是写个demo也可以用Mock.js造假数据但那只能应付演示经不起真实用户的使用。2. 系统核心模块设计与数据库建模2.1 题库管理题目模型、知识点标签与难度系数题目表是整个系统的主心骨。在建表之前我建议先理清两个关系题目与知识点的关系题目与试卷的关系。题目和知识点是多对多关系一道题可能同时考“二次函数”和“不等式”所以不能直接在题目表里塞一个“知识点”字段而是要单独建一个question_knowledge关联表。题目和试卷的关系也要用中间表因为同一道题可以出现在多张试卷里而且在不同试卷里它的题号、分值可能不同。下面是题目表的精简结构字段不多但每个都很关键CREATE TABLE question ( id BIGINT PRIMARY KEY AUTO_INCREMENT, type TINYINT COMMENT 题型1单选 2多选 3填空 4解答, difficulty DECIMAL(2,1) COMMENT 难度系数, stem TEXT COMMENT 题干, options TEXT COMMENT 选项JSON格式, answer TEXT COMMENT 参考答案, analysis TEXT COMMENT 解析, creator_id BIGINT COMMENT 录入人, audit_status TINYINT DEFAULT 0 COMMENT 审核状态, create_time DATETIME, update_time DATETIME );difficulty字段取0到1之间的小数0.3说明题目很简单0.8说明难度很高。很多新手在存难度时喜欢用“简单、中等、困难”这种字符串系统里比对和统计会很别扭。建议直接用数字查询时用BETWEEN 0.6 AND 0.75前端再映射成文字展示。options用JSON存是为了兼容选择题选项个数不固定的情况有的题3个选项有的5个冗余地设计成option1~option5反而死板。2.2 组卷算法手工组卷与智能随机抽题的实现思路组卷能力是系统的核心竞争力。这里我做了两种模式一种纯手工一个题目一个题目从题库挑选添加另一种按规则自动抽取也做了一套“先手工定框架、再自动填充”的混合模式。手工模式相对简单前端用一个题库检索列表支持按知识点、题型、难度筛选勾选后加到右侧试卷篮子。后端每次操作只维护”试卷题目明细表”不会频繁操作主表。混合模式就不一样了用户先配置一份“试卷蓝图”比如{ title: 高一数学期中测试, totalScore: 150, sections: [ {type: 1, questionCount: 8, eachScore: 5, difficultyRange: [0.5, 0.7], knowledgePoints: [集合, 函数]}, {type: 4, questionCount: 3, eachScore: 12, difficultyRange: [0.4, 0.8], knowledgePoints: [函数单调性, 指数函数]} ] }后端拿到这个蓝图后按题型和知识点分组去题库查询。因为这里涉及难度区间和知识点筛选不能简单地用SELECT * FROM question WHERE type1 LIMIT 8。还要考虑到同一个知识点下不能抽太多重复的题我当时的做法是对每个题干做MD5哈希存入题库表生成试卷时检查题目哈希是否重复。抽题采用“分知识点配额”比如选择题8道其中集合4道函数4道按配额去各个知识点池子内随机抽取。抽完后如果某配额不足就用相邻知识点或降低难度约束来补位并标记提醒。SQL层面随机抽题尽量用ORDER BY RAND()但题库数据量超过十万条后ORDER BY RAND()在MySQL里会全表扫描加临时排序性能很难看。工程上可以用“主键随机区间抽样”即先在应用层生成M个随机ID范围再用WHERE id IN (...)取题等数据大了再换ES。这是实际业务里很重要的一个性能决策。2.3 试卷管理与导出PDF/Word生成的坑生成试卷不是拼字符串那么简单。正反打印、选择题选项对齐、数学公式渲染、答案解析分离每一项都容易翻车。系统里我采用了两套导出方案。一套是后端用Apache POI生成Word文档匹配一个定制的docx模板。另一套是前端把试卷内容渲染到页面用户可以直接用浏览器“打印为PDF”。后者很适合校内使用不需要额外装Office组件。数学公式是最难搞的在Web端用MathJax渲染LaTeX保存时直接存LaTeX源码到了Word里还得让POI识别这些公式。老实说POI对复杂嵌套数学公式的支持还是有限所以我最终选择了折中方案在线预览用MathJax自动排版导出用纯文本的“题号题干选项答案”格式教研员拿到Word后再用自带的公式编辑器微调。这个方案虽然不那么“全自动”但在真实教育机构里反而是最实用的。还有页码和题号问题。多题型的试卷题号必须连续比如选择题1~8填空题9~15解答题16~18。类型之间题号不能断开也不能每个大题从1开始。实现时不能只在每道题上存一个内部ID要在“试卷题目明细表”里增加sort_no字段每次增减题目后重新跑一次编号逻辑。这个细节如果漏了导出的试卷就是乱的。3. 后端SpringBoot关键代码讲解与配置3.1 项目结构、依赖与统一返回体拿到一份源码第一件事是看目录结构。我这个项目是按四层结构分的controller、service、mapper、entity。很多培训项目喜欢把包名写成com.example.demo复制改改也能用但团队协作时包名不统一特别伤。建议直接按业务域命名比如com.school.mathbank.controller一眼能看出权限归属。pom.xml里的核心依赖就这几样spring-boot-starter-web、mybatis-plus-boot-starter、mysql-connector、jjwt、spring-boot-starter-data-redis。MyBatis-Plus别小看它在写单表CRUD时能帮你省掉一半的XML文件。不过组卷SQL比较复杂我还是保留了一些自定义Mapper方法把抽题逻辑写在XML里方便调整。统一返回体非常关键。如果没有统一封装Controller到处返回Map前端判断状态码得写一堆if-else。我是用了一个ResultT类字段包含code、message、data成功时code为200业务异常时用401、403、500。异常处理交给全局RestControllerAdvice把参数校验异常、业务异常、未知异常分开处理。这样前端Axios就可以只用一段拦截器代码搞定所有后端的成功和失败提示。3.2 鉴权与拦截器JWTRedis为什么能省很多事情管理系统的权限我用了Spring Security做基础框架但考虑到和Vue前端分离没有启用它的Session登录而是走JWT验证。登录接口校验用户名密码后生成Token并返回前端。Token里只放userId和userName不要把密码和角色权限都塞进去权限还是从数据库实时查更好避免用户角色变了Token里还留着旧权限。生成Token的代码很常见但有几个容易被忽略的设置。一是过期时间课堂项目喜欢设成24小时但真实场景建议2小时配合Redis存储Token做到“记住我”时再自动续期。二是签名密钥硬编码在代码里是明文泄漏风险应该放到application.yml的环境变量引用里。拦截器只需要一个OncePerRequestFilter从Header里取Authorization解析出userId后放到ThreadLocal供后续业务查询当前用户。对需要权限的接口加上PreAuthorize注解比如管理员才能审核题目。Vue前端拿到401状态码时跳转登录页并清空本地Token。这个链路清晰出问题也好排查。3.3 随机组卷的SQL与算法落地智能抽题最后落到Mapper层我用的是动态SQL。直接看这段Mapper的片段select idselectRandomQuestion resultTypeQuestion SELECT * FROM question where type #{type} AND audit_status 1 if testminDifficulty ! null AND difficulty gt; #{minDifficulty} /if if testmaxDifficulty ! null AND difficulty lt; #{maxDifficulty} /if if testknowledgePointIds ! null and knowledgePointIds.size() 0 AND id IN ( SELECT qk.question_id FROM question_knowledge qk WHERE qk.knowledge_id IN foreach collectionknowledgePointIds itemid open( separator, close) #{id} /foreach ) /if AND id gt; FLOOR(RAND() * (SELECT MAX(id) FROM question)) - 200 /where ORDER BY id ASC LIMIT #{count} /select注意我抽题时加了一个id FLOOR(RAND()*MAX(id))-200的条件这是让随机范围尽量落在靠近某些行的地方减少全表排序。它不能保证严格随机均匀但对组卷场景足够用了。真要更均匀可以把题目ID按区间切分比如分10个区间每个区间随机取几个再合到一起。这属于抽题算法的优化细节后文再展开。抽到题之后Service层要执行“重复检查”。我建了一张paper_question_temp临时表在生成正式试卷前先把本次候选题目存进去按question_hash做唯一校验。如果有重复就换一批候选题再抽。这个步骤看上去笨却是保证试卷质量的关键。4. 前端Vue核心页面与交互细节4.1 路由、状态管理与权限控制前端用的是Vue 2.6加Element UI没有太重装Vuex只在登录后拉取用户信息和动态菜单存到Vuex里。动态菜单是核心功能不同角色登录后侧边栏看到的项目不一样。管理员有题库审核、知识点管理、用户管理普通老师只有组卷中心和我的试卷。路由权限我推荐这么实现router.beforeEach里判断本地有没有Token没有就去登录页。有Token但访问的是动态路由里的地址就从后端权限列表里匹配匹配不到就跳401页面。注意不能只做前端隐藏菜单就算权限控制后端接口必须也校验权限否则用户直接在浏览器地址栏输入路由地址就能绕过。这一点我在代码讲解时一定强调。Element UI的el-menu用router模式菜单的index对应路由路径点击就能自动跳转。但菜单列表和权限列表有嵌套关系如果后端返回的权限数组是扁平结构前端要自己构建成树形菜单。我公共了一个buildMenuTree的工具函数按pid递归搞定之后侧边栏就能动态刷新了。4.2 组卷页面的动态表单与拖拽排序组卷配置页面是这个项目里最复杂的一个前端页面因为它不仅要收参数还要实时反馈可选题数量和试卷预览。页面结构分左中右三栏左边是题库筛选条件中间是试卷结构配置表右边是预览区。筛选条件区用el-form绑一个筛选对象点击“搜索”后调用后端接口获取符合条件题目的数量。这个数量反馈很重要不然用户配置了“选择题8道难度小于0.5”结果题库里只有5道最后生成时就会报错。试卷结构配置表用el-table展示一个个Section每一行都有题型的下拉、题数、分值、难度区间、知识点选择支持增加行、删除行。这个表格其实是“动态表单”每一项都要绑定v-model而且修改任何一项后都要重新向后端请求一次“可组卷性检查”让用户知道当前的配置能不能组出完整试卷。预览区我用了一个简单粗暴的做法不渲染真实的试题内容只显示题目编号、题号、知识点和题型预览避免把整张卷子的公式全部拉下来导致页面卡顿。用户觉得配置满意了再点“生成完整试卷”进入真正的预览页。拖拽排序是另一个亮点。因为实际出卷时老师经常会调整解答题的位置比如把压轴题放到最后。前端我用vuedraggable库把试卷题目列表封装成可拖拽组件。拖拽完成之后前端重新计算所有题目的solution order然后再保存到后端。要注意的是拖拽排序不能只改前端展示顺序后端明细表里的sort_no必须一起更新不然刷新页面排序就丢了。4.3 题目录入的富文本与数学公式处理题目录入页面的难度在数学公式上。普通textarea肯定不行因为数学公式有分式、根号、上标下标、求和符号必须用公式编辑器。系统里选用的是vue-quill-editor作为富文本同时集成MathQuill或MathJax处理公式。我的方案比较轻量在富文本工具栏上加了一个“插入公式”按钮点击后弹窗打开MathQuill编辑器用户在可视化区域写公式生成LaTeX字符串然后插入到富文本内容里。渲染时用MathJax把LaTeX转成HTML。这个流程最常见的坑是富文本编辑器会把LaTeX按HTML格式转义导致\frac{1}{2}被存成奇怪代码。解决方法是自定义富文本增量格式把公式内容包裹在一个自定义节点里保存时保留源码提取纯文本时用正则还原。题库批量导入功能我也做了。提供Excel模板列包含题干、选项、答案、解析、知识点、题型、难度。但Excel里的公式和特殊字符一定要检查比如、、这些符号在XML里会被解析器当标签处理导入时需要先做HTML实体转义。我在这里试过直接用EasyExcel解析但公式单元格的样式很难还原最后都是统一转换成纯文本再入库。如果你的题目里有大量图片建议先上传图片到OSS再把图片URL嵌入到题干字段不要直接塞base64不然数据库会爆炸。5. 部署流程与踩坑实录5.1 环境准备JDK、Node、Nginx的版本搭配在本地跑通项目和在服务器上跑通项目是两种完全不同的体验。我第一次把这份源码部署到云服务器时按照记忆直接装了个最新版JDK结果项目启动直接报错。原因很简单SpringBoot 2.7用的是JDK 8编译换到JDK 17后javax.servlet改成jakarta.servlet一大堆类找不到。所以部署前最好用项目pom.xml里指定的JDK版本不要自作聪明升级。常见搭配是组件推荐版本说明JDK1.8 或 11SpringBoot 2.x 默认支持Maven3.6打包用也可用IDE内置Node14 或 16Vue 2项目对Node版本有要求Nginx1.20做前端静态资源和反向代理MySQL5.7/8.0注意驱动版本Node版本太新也会出问题。Vue 2项目用Node 18以上打包时可能因为OpenSSL依赖报错我遇到的就是error:0308010C:digital envelope routines::unsupported。原因很经典解决方法是设置环境变量NODE_OPTIONS--openssl-legacy-provider或者在package.json里配置scripts。换成Node 16后没有丝毫问题。5.2 打包与部署前端构建到Nginx后端Jar包启动后端部署没什么神秘就是在项目根目录执行mvn clean package -DskipTests java -jar target/math-bank-server.jar --spring.profiles.activeprod生产环境的数据库连接、Redis地址写在application-prod.yml里用环境变量覆盖。这里我遇到过一个大坑打包后Jar包可以在本机运行但放到服务器上连不上MySQL。排查好久发现是Linux服务器防火墙放行了3306端口但MySQL配置里bind-address默认是127.0.0.1只允许本机连接。要把MySQL的bind-address改成0.0.0.0或者直接用内网IP连接。代码层面连接数据库的URL里也要加useSSLfalseserverTimezoneAsia/Shanghai不然时区报错。前端打包是npm install npm run build:prod打包后生成dist目录把这个目录整个上传到服务器Nginx的html路径下。然后配置Nginx反向代理到后端端口。我的Nginx配置大概是这样的server { listen 80; server_name example.com; root /var/www/html/dist; index index.html; location /api/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location / { try_files $uri $uri/ /index.html; } }重点在location /api/的转发和try_files的配置。Vue是单页应用如果用户直接刷新/paper/preview这个路由Nginx会把请求发给后端去找对应的Controller但后端没有这个路由就会返回404。加了try_files $uri $uri/ /index.html后所有不存在的路径都回退到index.html由前端路由接管。5.3 常见问题排查跨域、端口占用、数据库连接失败部署过程中最常碰到的就是跨域。前端地址是http://ip:80后端接口是http://ip:8080浏览器直接请求就会被CORS拦住。我在后端加了一个CorsFilter配置允许所有来源、所有请求头、所有方法。如果是生产环境更推荐用Nginx代理方式来避免跨域因为浏览器看到的域名只有一个就不存在跨域问题了。端口占用也是高频问题。后端Jar包启动报Port 8080 was already in use用lsof -i:8080找到占用进程再kill -9。更稳妥的做法是不要用固定端口让运维在启动时通过--server.port8081指定这样一台服务器可以跑多个项目实例。数据库连接失败还有一个隐蔽原因是数据库字符集。SQL文件里如果建表时没有指定字符集为utf8mb4插入题目里的数学符号、中文、甚至emoji可能报错Incorrect string value。我先在数据库建库时写上CREATE DATABASE math_bank DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;然后启动前检查show variables like %character%。这个步骤虽然基础但每次都要注意。还有一个被忽略的问题前端调接口时拿到的是后端返回的JSON中文乱码。这个一般不是编码问题而是SpringBoot的server.servlet.encoding.enabled没有开启或者响应体没有设置charsetUTF-8。用SpringBoot 2.x默认已经处理了但你要是自己写了HttpServletResponse输出字符串就必须手动加response.setContentType(application/json;charsetUTF-8)。很多课程作业源码在这里翻车。5.4 我建议你在源码基础上做的三个改造如果只是为了交作业或者跑demo拿到源码后建议先跑通再动手改。但我个人经验是光跑通没意义面试官一问就露馅。你至少要自己改三处地方第一把后端写死的上传文件路径和OSS配置改成本地存储或MinIO顺便学一下对象存储的对接第二把自动组卷的ORDER BY RAND()改成基于知识点分桶抽题并在Service层打印审计日志统计每次抽题耗时第三给前端增加一个“导出题目汇总表”的功能用后端Excel导出把本次试卷的答案和解析单独导出成教师版。这三个改造覆盖了文件存储、性能优化、复杂报表比一开始就想着加花哨的“在线考试倒计时”有用得多。还有一个容易被忽略的代码里的SQL文件很可能不包含初始管理员密码的明文而是MD5或BCrypt加密过的。你要先去application.yml里查看sql.init配置通常data.sql中预置了一条INSERT INTO sys_user语句。如果密码是BCrypt加密的可以在本地写一个测试类来生成加密串再替换掉。不改这个你连管理后台都登不进去。关于“源码文档”和“代码讲解”我的习惯是先让同事跑通部署文档运行过程中遇到问题就更新文档而不是等代码全部写完再补。因为部署文档是给人看的你自己觉得步骤清晰没用别人按着走一遍才作数。代码讲解时也是先讲流程图再贴核心代码不要一行行往下念那样没人听得下去。重点讲三块MyBatis-Plus的分页条件构造器、JWT的拦截逻辑、组卷算法里为什么要先查数量再抽ID。能把这三块讲明白这个项目你就真正吃透了。最后说一个和“数学题库组卷”不太相关但很实用的经验遇到Bug不要急着改代码先看日志。SpringBoot项目启动日志一级级往下翻看到Caused by这一行才是根因。前端页面空白打开浏览器开发者工具看Console的红字和Network请求的响应码。部署类问题八成是环境和文档不一致。把这篇里提到的坑都避开你的部署过程应该能一次通过。如果还有问题多半是版本差异或配置文件漏项顺着报错信息往源头查很快就能定位。