最近在给一个学弟把关计算机毕业设计他选的就是“基于Web的交通违章管理系统”技术栈锁定JavaSpringBoot。说实话这种题目在毕设里很常见但正因为常见反而容易做得千篇一律、答辩时被老师追问得答不上来。借这个机会我把从需求梳理到部署上线的完整思考过程整理出来重点是那些代码里看不到的“为什么”以及踩坑之后才明白的细节。这篇内容适合正在做同类毕设、或者想快速上手SpringBoot开发Web管理系统的朋友参考。这套系统说白了就是给交管部门或驾校做的一个后台管理平台核心功能是车辆违章记录的录入、查询、处理和统计。车主可以查自己的违章管理员可以维护车辆和违章信息处理人员可以标记处理状态。听起来简单但把SpringBoot的MVC分层、MyBatis操作数据库、权限拦截、事务控制都串起来就是一个很完整的Web开发练手项目。更重要的是它对应的是一个真实的业务场景不是那种为了凑功能而凑功能的空壳答辩时有东西可以讲。1. 先理清需求这个毕设系统到底要做什么很多同学拿到题目第一件事就是打开IDE写代码结果写到一半发现逻辑混乱、表结构反复改。我的建议是先把需求切成三块有哪几类人用、每类人能做什么、数据怎么流转。这个系统涉及三种角色系统管理员、交通管理人员执法者、普通车主用户。管理员负责账号管理和基础数据维护执法人员负责录入和处理违章车主只能查询自己的违章信息。三者的核心诉求差别很大映射到代码里就是权限控制而不是所有人都能看到一个操作界面。1.1 业务角色的划分我习惯先把角色访问矩阵画出来再动手建表。管理员要看的菜单包括用户管理、车辆管理、违章记录管理和统计报表执法人员需要违章录入、违章审核、处理状态更新车主只需要查询页面和单条详情。三者的权限天然不同所以从一开始就应该用Spring Boot的拦截器或者Shiro、SpringSecurity来做访问控制。但毕设阶段不建议引入太重的安全框架SpringBoot自带的拦截器加一个Session或Token判断就足够了答辩时反而更容易说清楚原理。这个矩阵非常重要它决定了Controller层的接口该怎么拆。把所有请求路径按角色分开比如/admin/**、/officer/**、/user/**这样拦截器只需要判断路径前缀即可不用在每一个方法里写重复的角色判断代码。我见过很多同学把所有功能都塞到一个UserController里然后不停地用if判断当前用户是谁看起来能跑但后期维护极其痛苦答辩时也会被问“如果新增一个角色你要改多少代码”。这种问题没有标准答案但“路径前缀拦截器”是实际开发中最常见也最清晰的方案。1.2 技术栈选型为什么是SpringBootMyBatis Plus题目里写了JavaSpringBoot实际上不用纠结SpringBoot就是目前Java Web开发的绝对主流没有之一。它把Spring的XML配置全部自动化内嵌了Tomcat一个main方法就能启动整个项目这对毕设演示和答辩部署非常友好。如果还停留在ServletTomcat手动配置的时代不仅效率低而且显得技术栈太旧。MVVM、前后端分离这些概念可以提但不要为了追求新而把项目复杂度抬得太高毕设的评分逻辑是“完整、熟练、有思考”不是“用了多少冷门框架”。持久层我推荐MyBatis Plus而不是单纯用MyBatis。原因是它内置了通用的CRUD方法单表操作不需要写SQL比如违章记录的插入、分页查询几行代码就解决。但答辩时一定要能说清底层原理也就是MyBatis如何通过Mapper接口动态生成SQLMyBatis Plus又是怎么用MyBatis的插件机制实现分页的。我带的毕设里出现过这种情况学生用MyBatis Plus用得飞起老师问“你的分页怎么做的一对一SQL你写过吗”他答不上来。正确姿势是提前准备好这两个问题的说明把生成的SQL打印出来看看。2. 数据库与核心业务模块拆解数据库是整个系统最值得花时间的部分。很多人喜欢把字段一股脑建完然后发现查询列表时要关联五张表。实际上交通违章管理系统的主线就两条一条是“车辆-违章记录”另一条是“用户-处理记录”。只要把这两条线理顺表结构就清晰了。我的建议是至少设计五张核心表系统用户表sys_user、车辆信息表vehicle_info、违章记录表violation_record、处理流水表handling_record再加上一个违章类型表violation_type用来存“超速”“违停”“闯红灯”这些字典数据。2.1 表结构设计要点车辆信息表不要只放车牌号还要有车辆类型、车主姓名、联系方式、注册日期因为违章处理往往需要通知车主或核对身份。车牌号字段建议设置唯一索引违章查询时最常用的条件就是车牌号。违章记录表是关键表字段包括违章编号、车牌号、违章类型ID、违章时间、地点、罚款金额、扣分、违章照片URL、处理状态、处理时间。这里有一个很容易被忽略的点违章照片URL不要直接存Base64字符串到数据库否则数据库会非常臃肿正确做法是把图片上传到服务器某个目录或OSS数据库中只存访问路径。违章记录表里的状态字段需要仔细设计。我见过有人用一个String类型直接写“未处理”“已处理”“已缴费”这种设计不太靠谱因为业务一旦扩展就麻烦。更合理的做法是status字段用Integer类型0表示未处理、1表示已处理待缴费、2表示已完成。这样不仅查询时索引效率高而且扩展状态时不需要改表结构。数据库字段类型的选择也是一种值得在答辩时讲的设计细节。2.2 状态机设计未处理到已完成这个系统的核心业务流其实是一个状态机状态机这个词听起来高级实际就三句话违章记录刚录入时是“未处理”执法人员确认处罚、填了处理意见后变成“已处理待缴费”车主或系统标记缴费完成后是“已完成”。状态的每一次变化都要记录在handling_record表里包括操作人、操作时间、处理意见。这样做的好处是当老师问“如果处理到一半发现填错了怎么办”你可以回答“做一个状态回退接口但必须保留流水记录”这就展示了你的工程思维。状态变更必须放在事务里尤其是“违章处理”这个动作。比如执法人员点“处理违章”系统要去更新违章记录的状态、插入一条处理流水、可能还要给车主发送通知这三个操作任何一个失败都要回滚否则数据就不一致了。这个点理论上属于Spring声明式事务的经典应用场景代码就一行Transactional但很多人听说过没用过落到项目里就知道它的价值了。3. 关键功能实现与代码细节前面铺垫了这么多接下来进入实操。我会把登录权限、违章查询、违章处理这三个核心功能的实现思路展开代码不会贴完整项目但关键片段会给出并解释每一步为什么这样做。3.1 登录拦截与权限控制登录模块不要用复杂的加密方案毕设阶段用MD5加盐或者Spring Security的BCrypt都行。我建议用BCrypt因为MD5在答辩时容易被老师指出安全性问题。实现上可以用spring-security-crypto这个单独依赖不需要引入完整的Spring Security只调用它的BCryptPasswordEncoder做密码哈希和校验。登录成功后把用户ID和角色放进HttpSession拦截器去读Session判断是否登录。核心代码如下Configuration public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object userId session.getAttribute(userId); if (userId null) { response.sendRedirect(/login); return false; } // 角色校验判断路径前缀是否匹配当前用户角色 String uri request.getRequestURI(); if (uri.startsWith(/admin/) !ADMIN.equals(session.getAttribute(role))) { response.sendRedirect(/error/403); return false; } return true; } }拦截器注册时需要注意排除路径比如/login、/css/**、/js/**、/images/**这些静态资源和登录接口要放行。很多同学第一次做拦截器页面样式全丢了就是因为忘了放行静态资源。另外Session失效时间建议设成30分钟在application.yml里配置即可太长有安全隐患太短影响演示体验。权限这块还要配合前端菜单动态渲染不同角色登录后看到的菜单项不同这个可以在渲染页面时根据Session中的角色变量进行判断。3.2 违章查询与分页查询优化违章查询是整个系统最核心的场景也是数据量增长最快的模块。如果不做分页数据一旦上千条页面就会卡顿答辩时导师一般都会问“数据量大怎么办”。MyBatis Plus的分页插件用起来非常简单PageViolationRecord page new Page(current, size); LambdaQueryWrapperViolationRecord wrapper new LambdaQueryWrapper(); wrapper.eq(StringUtils.hasText(plateNumber), ViolationRecord::getPlateNumber, plateNumber); wrapper.orderByDesc(ViolationRecord::getViolationTime); IPageViolationRecord result violationRecordMapper.selectPage(page, wrapper);这里的LambdaQueryWrapper要注意条件判断要写成StringUtils.hasText(plateNumber)的形式也就是当查询参数为空时不要拼接条件。否则用户不填车牌号时查询条件就变成了where plate_number 查出来的数据自然不对。这个细节非常典型出自真实开发中的“动态SQL拼接”场景。MyBatis Plus的判断逻辑其实底层帮你做了if判断但理解原理会更好。分页大小建议设为10因为违章记录是列表展示10条一页查看体验最好。同时使用orderByDesc按违章时间倒序排列让最新的违章出现在最前面。如果查询比较慢优先检查数据库里有没有建索引。直接在vehicle_info和violation_record的关联字段上加普通索引就行这个SQL优化手段简单且见效快。3.3 违章处理与事务管理执法人员点击“提交处理”时前端会POST一个表单到后台包含违章记录ID和处理意见。后台的逻辑分三步查询违章记录是否存在修改违章记录的状态为“已处理待缴费”插入一条处理流水。这三步必须用Transactional包起来。实际代码大致是Transactional(rollbackFor Exception.class) public void handleViolation(Long violationId, String officerId, String comment) { ViolationRecord record violationRecordMapper.selectById(violationId); if (record null) { throw new BusinessException(违章记录不存在); } if (record.getStatus() ! 0) { throw new BusinessException(该违章已处理请勿重复操作); } record.setStatus(1); record.setHandleTime(new Date()); violationRecordMapper.updateById(record); HandlingRecord handlingRecord new HandlingRecord(); handlingRecord.setViolationId(violationId); handlingRecord.setOfficerId(officerId); handlingRecord.setComment(comment); handlingRecord.setCreateTime(new Date()); handlingRecordMapper.insert(handlingRecord); }注意rollbackFor Exception.class这个属性Spring的默认事务回滚只针对RuntimeException如果你抛了一个自定义业务异常但没继承RuntimeException事务就不会回滚。这个坑相当隐蔽很多人在项目快做完时才踩到。自定义异常类BusinessException最好继承RuntimeException这样代码简洁且保证回滚。还有一个常见问题是重复提交。前端按钮点击后不置灰用户连续点两次就会出现两条处理流水。解决方法是前端提交成功后disable按钮后端做一次幂等判断比如在处理前先查该违章是否已处于处理中状态。上面代码中if (record.getStatus() ! 0)那一段就是在做后端幂等判断比纯前端控制可靠得多。4. 前端页面与SpringBoot集成实现很多同学卡在前端其实这个系统的前端不需要太炫重点是交互逻辑。有两种主流方案一是用SpringBoot内置的Thymeleaf模板引擎直接服务端渲染二是完全前后端分离Vue写页面、后端只提供JSON接口。对于计算机毕设我两种都带过各有利弊。4.1 Thymeleaf还是前后端分离用Thymeleaf的优势是项目结构简单不用单独启动前端服务代码里直接使用th:each遍历数据渲染表格。适合时间紧、本来就不擅长前端的同学。缺点就是页面交互逻辑复杂时写JavaScript会比较别扭比如多个条件组合查询、弹窗表单提交需要把表单数据手动拼接后提交。前后端分离的优势是后期扩展Web端和App端时可以直接复用后端接口但缺点是要维护两套代码打包配置也要折腾。而且如果前端能力一般VueVite打包再整合进SpringBoot部署时会遇到不少麻烦比如sass编译报错和路由history模式刷新404。我的个人建议如果目标是快速完成一个看起来完整、答辩能用就选Thymeleaf后端人员最稳妥。如果目标是展示自己在校招简历写的技能是“熟悉Vue”那就选前后端分离。不过要注意毕设答辩重点还是后端逻辑不会因为前端用了Vue就加分很多。4.2 车辆违章查询页面的快速实现用Thymeleaf实现一个查询页面其实很快。页面结构很简单一个输入框输入车牌号、一个查询按钮、一个表格展示结果、一个分页栏。关键是Controller返回的Model要带两个变量一个是当前页数据列表一个是分页信息总页数、当前页、是否有上一页下一页。GetMapping(/user/violations) public String myViolations(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, Model model, HttpSession session) { Long userId (Long) session.getAttribute(userId); PageViolationRecord page violationService.queryMyViolations(userId, pageNum, pageSize); model.addAttribute(pageInfo, page); return user/violation-list; }页面里分页栏可以用th:if判断pageInfo.total pageInfo.size再展现页码链接。这个地方要注意如果分页参数是从请求里来的Controller一定要加defaultValue否则用户不传参数时直接空指针。前端表格中的违章状态列建议用th:switch输出中文状态而不是直接显示0/1/2这样演示时观感更好。另外查询后页面要保留查询参数不然用户翻到第二页时查询条件丢失了这个坑在开发中很常见。还有一个很实用的小功能Web页面PDF打印。很多系统需要打印违章告知单让用户点一个按钮直接打印当前页面。实现方式有纯浏览器打印window.print()配合CSS设置打印区域和生成PDF文件两种。纯打印实现成本低适合毕设演示。如果要用Java后端生成PDF依赖较多而且模板调整费劲不是特别必要。5. 部署测试与常见问题排查到这一步系统基本能跑通了。但是我在带毕设的过程中发现很多人在自己电脑上运行没问题一到换电脑演示或部署到服务器就各种报错。这部分把最容易踩的坑集中说一下都是真实案例建议对照排查。5.1 本地运行环境搭建基础环境准备好三样JDK 8或更高版本、Maven 3.6以上、MySQL 5.7或8.0。SpringBoot 2.7.x是当前比较稳定的版本不建议一上来就用SpringBoot 3.x因为3.x要求JDK17如果老师的电脑装的是JDK8没法运行。这一点务必注意。数据库初始化建议用spring.sql.init或者直接在启动时执行一个init.sql脚本把建表语句和数据都放在项目里。这样换电脑演示时只需改一下数据库连接密码运行项目就能自动建表非常省事。如果手工在Navicat里一句一句执行容易漏掉某个表导致系统启动后查询报“表不存在”。数据库配置我一般放在application.yml中并加上时区参数serverTimezoneAsia/Shanghai不然数据库连接经常报时区错误。5.2 典型报错与解决方案排查第一个问题是端口被占用。SpringBoot默认端口是8080如果你已经启动了一个项目又重复运行会报Address already in use。解决办法是在application.yml里改掉server.port比如设成8081。这种问题机制简单但现场特别容易慌。第二个问题是数据库连接驱动版本不一致。项目用了MySQL 8.0数据库pom里却引入的是5.1.49的mysql-connector-java启动时会报Public Key Retrieval is not allowed。解决方法是改成com.mysql.cj.jdbc.Driver驱动并加上allowPublicKeyRetrievaltrueuseSSLfalse参数。这个坑经常出现而且报错信息不一定直观需要提前引起注意。第三个问题是SQL语句日志看不到。如果SQL出了问题但控制台不打印SQL排查效率极低。在MyBatis Plus中可以在application.yml里配置mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl这个配置等于把SQL语句实时打印到控制台是调试阶段的神器。答辩现场出现临时SQL问题可以用它快速定位。但注意演示结束后最好关掉避免日志刷屏影响性能。第四个问题是前端JS报错导致查询按钮无响应。这个最不好定位因为SpringBoot后台不会打印前端错误。建议浏览器按F12打开控制台看Network请求如果是500再看后台日志如果是JS函数未定义十有八九是因为Thymeleaf渲染时变量名拼错了。这里分享一个经验所有动态渲染的字段先在控制台用console.log打印出来看结构而不是直接上来写代码。6. 这个系统还能怎么扩展毕设及格容易拿高分难。如果你的系统已经做完想再往里面加一些亮点下面这几个方向优先级最高而且都是基于现有代码的自然演进不是凭空重写。6.1 引入Redis缓存与接口限流违章查询是典型读多写少的场景可以把热点查询结果缓存到Redis缓存key设计成violation:plate:{plateNumber}首次查询数据库之后直接查缓存。同时利用Redis的过期策略比如设置5分钟过期保证违章处理状态更新后能及时刷新。这样设计的好处是答辩时你能跟老师解释缓存穿透、缓存雪崩、缓存一致性这三个经典问题随便展开一个都是加分项。接口限流也可以做比如利用Redis的INCR命令对某个IP的查询次数计数在1分钟内超过30次就返回“访问过于频繁”。这个功能在后端代码里只需要写个拦截器但体现了对系统防护的思考很值得加进去。6.2 对接地图服务与短信通知违章记录里的地点字段只是文本比如“XX路与XX街路口”如果可以调用地图API把坐标转成经纬度就能在地图上展示违章分布。这个功能做起来不难后端接一个地图Web服务前端引入地图组件展示标注。不过在毕设阶段不需要真的调用外部服务完全可以假装调用了一个接口把经纬度字段存入数据库页面展示时直接读就行。但这里要注意不能在实际项目中伪造接口毕设演示也要说清楚是模拟数据。短信通知这个功能建议作为“加分功能”写在README里而不一定实际实现。因为真正接短信服务需要付费和审核成本高。可以预留一个sendMessage()方法里面用System.out.println(模拟发送短信)代替让导师明白你有这个设计意识。这也是很常见的做法。最后说点实实在在的体会这个系统如果真的认真做完整从业务理解、数据库设计到SpringBoot实践涉及的知识点足以覆盖校招面试中最常问的JavaWeb问题。关键是不要只当“代码搬运工”每一个方法为什么要写、每一个表字段为什么要建都要能讲出道理。把上面这些思路消化掉哪怕是同一道题目你的答辩也会比别人更有底气。