企业官网建设流程全解析

直接干。又是一年毕业设计季，每年这个时候总有同学在“做什么题目”和“怎么做完”之间反复横跳。车辆违章信息管理系统，这个题目在毕设圈子里算是常青树了，选它的人多，但做好的人少。原因倒不是技术多难，而是很多人拿到这个题目后不知道从哪下手，数据库怎么设计、前后端怎么分工、进度怎么排，全凭感觉。这篇文章我打算把这套基于SpringBoot+Vue+MySQL的车辆违章信息管理系统从头到尾给你拆一遍，从需求分析到数据库设计，从后端接口到前端页面，从部署上线到答辩准备，把你该踩的坑、该省的时间、该拿的分数都交代清楚。内容按完整项目流程走，带代码、带表结构、带避坑清单，照着做能给出一套能演示、能答辩、能过审的完整系统。

1. 项目要做什么：违章系统的真实需求拆解

1.1 毕设选题怎么定，怎么让“老题目”做出新意

车辆违章信息管理系统这个方向属于典型的管理信息系统（MIS），本质就是“一堆数据的增删改查加上统计报表”。这类题目的好处是业务逻辑清晰、技术栈成熟、资料丰富，适合在几个月内独立完成；坏处是太常见，如果只是把教材里的示例代码换个皮，答辩时老师一眼就能看穿。

我的建议是：认可这个方向，但要在“信息管理”之外加点差异化的东西。最简单的做法是把“统计分析”做深一层。普通系统会做“违章记录的总数统计”，你可以做到“按违章类型、按区域、按时段、按车辆类型多维度交叉分析，并生成可视化图表”。别小看这一步，它能让系统的业务深度明显超出“增删改查”的范畴，在答辩时也能成为你讲解的抓手。

另一种思路是加“规则引擎”的影子——比如设置某辆车累计扣分超过12分的自动预警、驾驶证状态与违章记录联动的提示信息，这些不需要复杂的算法，但能体现出你对业务流程的理解，比单纯写几个CRUD接口更能打动答辩老师。

这个项目的核心用户也值得提前想清楚。车辆违章系统的使用者不止“管理员”一个角色，至少应该分成“系统管理员”和“普通查询用户”。管理员负责违章记录的录入、审核、修改和统计，普通用户通过车牌号、驾驶证号查询自己的违章情况。如果你时间充裕，可以再加一个“交警/执法人员”角色，负责手机端移动录入违章，但建议量力而行，先保主干再谈扩展。

1.2 功能清单与角色划分：先列清楚再写代码

磨刀不误砍柴工，动手写代码之前，先把功能边界划清楚。否则写着写着就往里面堆功能，最后哪个都没做扎实。

标准版的功能清单我建议这样拆分：

• 用户登录与注册：支持管理员和普通用户两种身份，密码需要加密存储，不能明文入库。
• 车辆信息管理：录入车辆的基本信息（车牌号、车辆类型、车主姓名、驾驶证号等），支持按车牌号模糊搜索。
• 违章记录管理：违章记录是系统的核心数据，字段至少包含车牌号、违章时间、违章地点、违章类型（违停、超速、闯红灯等）、违章描述、罚款金额、扣分分值、处理状态（未处理/已处理），支持新增、编辑、删除、按多条件组合查询、分页展示。
• 违章统计与图表展示：按月份统计违章数量趋势、按违章类型统计占比、按车辆统计违章次数排行，用柱状图、折线图、饼图展示。
• 公告管理：管理员发布系统公告，比如“违章处理平台维护通知”，普通用户登录后可查看。
• 个人中心：修改密码、查看个人车辆信息和违章记录。

划分角色时注意一个容易忽略的细节：普通用户不应该能直接看到所有数据库里的违章记录，他只能通过“车牌号或驾驶证号”查到和自己相关的记录。这个逻辑在接口设计时就要通过查询条件限制好，不能在Service层把全表数据返回给前端再过滤。

功能不是越多越好，关键在于“闭环”——每一个操作都要有对应的数据支撑和界面入口，宁可功能少一点，也要保证每个功能完整可用。一个只写了半截功能的系统在演示时很容易翻车。

2. 技术选型：SpringBoot+Vue+MySQL的真实取舍

2.1 后端为什么选SpringBoot，版本怎么定

选择SpringBoot不是因为“大家都在用”，而是因为它确实最适合这样的单体管理系统。自动配置让你不用处理大量XML配置，内嵌Tomcat让项目可以在IDEA里一键启动，Spring生态的整合能力让后续加功能（比如整合Redis做缓存、整合EasyExcel做导出）都非常顺手。

技术栈的具体版本这里给你一个参考，是我自己用下来比较稳定的一套：

• JDK：1.8 或 11（建议1.8，很多学校的服务器环境对高版本JDK支持不太好，而且1.8的生态资料最全）。
• SpringBoot：2.7.x 系列（别用3.x，SpringBoot 3最低要求JDK17，很多初学者会在环境上卡很久；2.7.x既支持JDK8又比较新，足够用）。
• MyBatis-Plus：3.5.x（整合了通用CRUD、分页插件和代码生成器，能省下大量重复代码）。
• MySQL：5.7或8.x（建议用8.0以上，但注意驱动和时区配置，下面会专门讲）。

很多教程直接带你配最新版本，但“最新”不等于“最好调”。SpringBoot 3.x、JDK 17、MySQL 8.4的组合不是不行，而是如果你在配置上遇到问题，搜索引擎上能查到的解决方案大概率都是老版本的，这个隐性成本在赶毕设时非常致命。

2.2 前端为什么选Vue，用Vue2还是Vue3

Vue在前端框架里学习曲线相对平缓，而且非常适合做这类“页面多、状态交互不复杂”的管理系统。一个后台管理界面，无非就是登录页、表格页面、表单弹窗、统计图表页，Vue组件化的开发方式让每个页面都能独立维护，配合Element UI组件库，写出来的页面在不用手写复杂CSS的情况下也能达到比较专业的视觉效果。

这里要做一个明确的选择。如果你现在才开始学Vue，建议直接上“Vue3 + Vite + Element Plus + Pinia”。Vue3是当前主流，Vite的启动速度比Webpack快好几个量级，Element Plus是Element UI的Vue3版本，组件风格一致。

但如果你在毕设之前已经学过Vue2，而且拿到了一些Vue2的项目代码可以参考，那用“Vue2 + Vue CLI + Element UI”也完全可以。毕竟毕设的核心是完整地实现一个系统，技术栈新不新只是锦上添花。可怕的是学一会儿Vue2一会儿Vue3，最后把两者的语法混在一起用，代码风格乱七八糟。

2.3 数据库选型：MySQL安装与版本避坑指南

MySQL在这个项目里作为唯一的数据存储，你要处理的问题其实集中在“装得上、连得上、不乱存”这三个层面。

先说说MySQL 8.x的安装。Windows环境下推荐直接下载MSI安装包，安装时选择“Server only”即可，开发学习不需要装一堆附带工具。安装完成后设置root密码，这个密码一定记好，项目配置里要用。MySQL 5.7的安装稍微繁琐一点，因为官方已经不再提供Windows下的MSI安装包，需要用ZIP包手动初始化和注册服务。如果你没特殊要求，直接装MySQL 8.0。

装完之后大概率会遇到两个问题。第一个是服务启动失败，常见原因是3306端口被占用，netstat -ano | findstr 3306查一下，把占用进程清掉或改端口。第二个是连接时出现“Public Key Retrieval is not allowed”或SSL连接错误，这是MySQL 8默认的caching_sha2_password认证和SSL配置导致的。连接串里加上allowPublicKeyRetrieval=true&useSSL=false&serverTimezone=Asia/Shanghai即可解决，这个参数很多教程不写，但在实际开发中非常关键。

数据库连接串的完整配置给你参考：

spring.datasource.url=jdbc:mysql://localhost:3306/vehicle_violation?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&rewriteBatchedStatements=true spring.datasource.username=root spring.datasource.password=你的数据库密码 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

rewriteBatchedStatements=true这个参数建议加上，它能让MyBatis-Plus的批量插入性能提升非常明显，后面做数据初始化时你就知道有用了。

3. 数据库设计：六张表撑起违章管理业务

3.1 核心表结构与字段类型说明

车辆违章系统的数据库设计不需要很复杂，但要严谨。表数量控制在六张以内最合适，既覆盖了业务需求，又不会让建表和表关联变得失控。

我的设计是这样的：

sys_user用户表：id、username、password（加密存储）、real_name、role（admin/user）、phone、status（启用/禁用）、create_time。其中username设置唯一索引，密码字段长度至少64，用来容纳BCrypt加密后的字符串。

vehicle_info车辆信息表：id、plate_number、vehicle_type（小型汽车/大型汽车/摩托车）、owner_name、driver_license_no、phone、create_time。plate_number必须唯一，系统里所有违章记录都要通过这个车牌号关联车辆。

violation_record违章记录表：id、plate_number、violation_time、violation_location、violation_type（违停/超速/闯红灯/压线/逆行等）、violation_desc、fine_amount、deduct_points、status（0未处理/1已处理）、handler_name、handle_time、create_time。这个表是整个系统的核心，字段最多，也是查询条件最多的一张表。

violation_type违章类型表：id、type_name、fine_amount、deduct_points、description。这张表的作用是统一管理违章类型对应的罚款金额和扣分分值，避免在录入记录时手动填错。

sys_notice公告表：id、title、content、create_time。sys_log操作日志表：id、user_name、operation、method、params、ip、create_time。这一张不是必选项，但加上它对后面“系统亮点展示”很有帮助，答辩时你直接打开日志页面，演示“所有关键操作都有留痕”，这个细节非常加分。

建表的核心SQL我给出关键部分，字段类型和默认值可参考：

CREATE TABLE `violation_record` ( `id` bigint(20) NOT NULL AUTO_INCREMENT, `plate_number` varchar(20) NOT NULL COMMENT '车牌号', `violation_time` datetime NOT NULL COMMENT '违章时间', `violation_location` varchar(100) DEFAULT NULL COMMENT '违章地点', `violation_type` varchar(20) NOT NULL COMMENT '违章类型', `violation_desc` varchar(255) DEFAULT NULL COMMENT '违章描述', `fine_amount` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '罚款金额', `deduct_points` int(11) NOT NULL DEFAULT '0' COMMENT '扣分分值', `status` tinyint(1) NOT NULL DEFAULT '0' COMMENT '处理状态 0未处理 1已处理', `handler_name` varchar(50) DEFAULT NULL COMMENT '经办人', `handle_time` datetime DEFAULT NULL COMMENT '处理时间', `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`), KEY `idx_plate_number` (`plate_number`), KEY `idx_violation_time` (`violation_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='违章记录表';

注意到这里我特地在plate_number和violation_time上加了普通索引。别小看这一步，当表里数据量到几万条后，有没有索引的查询速度差距是几十倍的。在答辩时，老师如果问到“数据量大了性能怎么办”，你直接回答“对常用查询字段建立了联合索引”，就能在这个问题上拿到好印象。

3.2 表关系设计与事务处理的关键点

各表之间不要用物理外键，我强烈建议只保留逻辑关联。原因很简单：毕设项目的数据量小，物理外键带来的完整性约束意义不大，但它在删除、批量导入时带来的限制很多。比如你删除一个车辆信息，如果这个车牌号在违章表里还有记录，外键约束就会阻止删除或者需要复杂的级联配置。用逻辑关联的方式，在删除车辆前先手动检查一下是否有未处理完的违章，业务流程上更合理，编码上也更灵活。

事务处理是这个系统里容易出问题的地方。哪些操作需要事务？比如“处理违章”这个操作，它不只是把violation_record表的status从0改成1，还应该往处理记录表里写一条数据处理日志，这两个操作必须在一个事务里，否则会出现“状态改了但日志没记录”的数据不一致问题。在SpringBoot里用@Transactional注解即可，注意设置rollbackFor = Exception.class，否则运行时异常不会正常回滚。

再举一个例子：导入违章数据时，需要先判断车辆是否存在，不存在则自动插入车辆信息，同时再插入违章记录——三张表的写入操作放在同一个事务方法里。这样即使某一条数据有问题，也不会出现“车辆进了但违章记录没进”的半截状态。MyBatis-Plus的批量插入自带事务控制，但如果你用的是自定义的循环插入，一定记得在Service层方法上加事务。

4. 后端核心实现：从登录鉴权到违章记录增删改查

4.1 项目初始化与分层架构

我建议你把后端项目结构按经典的“Controller-Service-Mapper”三层来做，每个层分包清晰：

• controller：处理HTTP请求，参数校验，返回统一结果。
• service：业务逻辑，事务控制都在这一层。
• mapper：数据访问层，用MyBatis-Plus继承BaseMapper。
• entity：数据库表的实体类。
• vo：视图对象，给前端返回的数据模型。
• config：配置类，比如CORS跨域配置、MyBatis-Plus分页配置。
• common：公共类，比如统一返回结果Result、异常处理。

统一返回结果Result一定要在一开始就写好，格式固定为{ code, message, data }，其中code为200表示成功，401表示未登录或登录过期，500表示服务异常。这样前后端联调时能快速定位问题，不用到处打印日志看响应结构。

项目创建时，用IDEA的Spring Initializr最快。Group填com.example，Artifact填violation-system，依赖勾选Spring Web、MyBatis Framework、MySQL Driver、Lombok。创建完成后手动加入MyBatis-Plus依赖。

<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.1</version> </dependency>

MyBatis-Plus的分页插件配置在config包里：

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

4.2 用户登录与鉴权的两种实现方案

登录模块是所有功能入口，也是答辩时老师大概率会问的第一个点。密码绝不能明文存储，这一点是硬指标。SpringSecurity自带BCryptPasswordEncoder，但你如果嫌它配置繁琐，单独引入spring-security-crypto就可以用同样的加密器。

// 密码加密 String encoded = new BCryptPasswordEncoder().encode(rawPassword); // 密码校验 boolean matches = new BCryptPasswordEncoder().matches(rawPassword, encodedPassword);

登录鉴权有两种方案可选。方案一是用JWT（JSON Web Token），登录成功后生成一个带用户信息、过期时间的token返回给前端，前端存到localStorage里，每次请求放在请求头Authorization中；后端写一个拦截器，从token中解析用户信息。方案二是简单的Session方案，登录成功后将用户信息放进HttpSession，后续请求通过拦截器检查Session中是否存在用户。我的建议是：用JWT。虽然它比Session多一点代码量，但前后端分离的场景下JWT是无状态设计的标准做法，这个知识点也值得你在答辩中重点讲。

拦截器的核心逻辑供参考：

@Component public class JwtInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token = request.getHeader("Authorization"); if (StringUtils.hasText(token)) { Claims claims = JwtUtil.parseToken(token.replace("Bearer ", "")); if (claims != null) { request.setAttribute("userId", claims.get("userId")); request.setAttribute("role", claims.get("role")); return true; } } response.setStatus(401); response.setContentType("application/json;charset=UTF-8"); response.getWriter().write("{\"code\":401,\"message\":\"未登录或登录已过期\"}"); return false; } }

所有需要登录才能访问的接口都应在请求头中携带token，前端在axios的请求拦截器里统一添加。但注意：登录接口本身、注册接口、查询公告的接口需要放行，不需要拦截，否则会出现“自己人拦自己人”的尴尬。

4.3 违章记录核心接口：分页查询、条件组合与批量导入

分页查询是违章系统最核心的接口。查询条件通常包括：车牌号（模糊查询）、违章类型（精确匹配）、处理状态（精确匹配）、违章时间范围（起止日期）。MyBatis-Plus的LambdaQueryWrapper是首选，它能在编译期检查字段名，避免写错字符串。

@Override public PageResult<ViolationRecordVO> pageQuery(Integer pageNum, Integer pageSize, String plateNumber, String violationType, Integer status, String startTime, String endTime) { Page<ViolationRecord> page = new Page<>(pageNum, pageSize); LambdaQueryWrapper<ViolationRecord> wrapper = new LambdaQueryWrapper<>(); wrapper.like(StringUtils.hasText(plateNumber), ViolationRecord::getPlateNumber, plateNumber) .eq(StringUtils.hasText(violationType), ViolationRecord::getViolationType, violationType) .eq(status != null, ViolationRecord::getStatus, status) .between(StringUtils.hasText(startTime) && StringUtils.hasText(endTime), ViolationRecord::getViolationTime, startTime, endTime) .orderByDesc(ViolationRecord::getViolationTime); this.page(page, wrapper); // 将实体转换为VO返回 }

注意PageResult里要返回total、records两个字段，前端分页组件才能正常显示总页数。

批量导入这个功能很多同学会忽略，但在毕设答辩里它是演示效果最好的功能。找一张包含几百条违章记录的Excel表格，用EasyExcel或POI解析，一行行校验后批量插入数据库。你可以提前造一份8000条数据的测试表，演示时直接一个“导入”按钮，所有记录出现在列表里，再配合rewriteBatchedStatements=true，插入速度非常快，现场效果很震撼。

需要特别说明的是导入时的数据校验：车牌号必须符合规则（比如“京A12345”的格式），违章时间不能晚于当前时间，罚款金额和扣分分值必须是数字且大于等于0。任何一条数据校验不通过时，要记录错误原因，导入结束后把错误信息以文本的形式反馈给用户，而不是直接中断整个导入流程。

4.4 统计接口：设计一个能拿分的图表数据接口

统计模块是整个系统的加分项，它的接口设计其实不复杂，核心是SQL的GROUP BY聚合。举个例子，统计近12个月每个月的违章数量，SQL可以这样写：

SELECT DATE_FORMAT(violation_time, '%Y-%m') AS month, COUNT(*) AS count FROM violation_record WHERE violation_time >= DATE_SUB(CURDATE(), INTERVAL 12 MONTH) GROUP BY DATE_FORMAT(violation_time, '%Y-%m') ORDER BY month;

在MyBatis的Mapper里定义这个查询，返回List<Map<String, Object>>，前端拿到数据后直接塞进ECharts或者AntV的图表组件里即可。

建议做一个综合统计接口，同时返回四块数据：

• 总违章次数、当前未处理违章数、累计罚款金额、累计扣分总分（顶部卡片数据）。
• 近12个月违章数量趋势（折线图数据）。
• 违章类型占比（饼图数据）。
• 违章数量排名前10的车辆（柱状图数据）。

一个接口返回四块数据，前端一次请求全部搞定，页面加载体验好，后端代码逻辑也更集中。统计接口里的“累计扣分总分”这类数据，要在SQL里用SUM函数聚合，不要再循环累加，否则数据量大了性能会非常难看。

5. 前端页面实现：Vue3+Vite+Element Plus的实战过程

5.1 环境准备：Node和Vite的搭配细节

前端环境里最容易出问题的不是写代码，而是装的版本对不上。Node.js建议使用长期支持版本18或20，安装前先检查本机是否已有其他Node版本。如果你装了nvm，尽量用nvm来管理多个Node版本，避免项目之间因为Node版本不同导致依赖安装失败。

创建Vue3项目用Vite比Vue CLI快很多，命令也很简单：

npm create vite@latest violation-web -- --template vue cd violation-web npm install npm install axios vue-router@4 pinia element-plus @element-plus/icons-vue echarts

Element Plus的完整引入代码在main.js里：

import { createApp } from 'vue' import ElementPlus from 'element-plus' import 'element-plus/dist/index.css' import * as ElementPlusIconsVue from '@element-plus/icons-vue' import App from './App.vue' const app = createApp(App) app.use(ElementPlus) for (const [key, component] of Object.entries(ElementPlusIconsVue)) { app.component(key, component) } app.mount('#app')

Vite的默认端口是5173，SpringBoot后端默认端口是8080，开发环境下前端调后端接口必然会有跨域问题。解决跨域的最稳妥方案是后端配置CORS策略，写一个配置类允许所有来源访问。但记住一个细节：如果使用JWT并且请求头自定义了Authorization，后端的CORS配置中allowedHeaders("*")必须带上，否则前端发请求时自定义请求头会触发预检请求被后端拒绝。

5.2 Vue Router和页面结构：一个后台系统的路由怎么设计

后台管理系统的路由设计要遵循“登录页独立、主界面带左侧菜单”的典型布局。路由安排建议如下：

const routes = [ { path: '/login', component: LoginView }, { path: '/', component: LayoutView, redirect: '/dashboard', children: [ { path: 'dashboard', component: DashboardView, meta: { title: '数据统计' } }, { path: 'vehicle', component: VehicleView, meta: { title: '车辆管理' } }, { path: 'violation', component: ViolationView, meta: { title: '违章管理' } }, { path: 'violation-import', component: ViolationImportView, meta: { title: '违章导入' } }, { path: 'notice', component: NoticeView, meta: { title: '公告管理' } }, { path: 'profile', component: ProfileView, meta: { title: '个人中心' } } ] } ]

路由守卫是这里的关键，没登录的用户直接访问首页时必须被弹回登录页。Vue3里用router.beforeEach实现：

router.beforeEach((to, from, next) => { const token = localStorage.getItem('token') if (to.path !== '/login' && !token) { next('/login') } else { next() } })

如果你用了Vite构建，路由模式一定不要用createWebHistory的history模式，因为打包部署到Nginx或SpringBoot内置服务器后，刷新页面会出现404。改用createWebHashHistory的hash模式，路径中会带#号，难看一点但省心太多。这个坑我见过无数人踩，包括一些工作了几年的前端。

5.3 axios封装与核心页面交互逻辑

axios封装是前端工程质量的分水岭。不要在每个页面里直接写axios.get('/api/...')，而是封装一个request.js工具模块，统一处理baseURL、token注入、响应拦截和错误提示。

import axios from 'axios' import { ElMessage } from 'element-plus' const request = axios.create({ baseURL: '/api', timeout: 10000 }) request.interceptors.request.use(config => { const token = localStorage.getItem('token') if (token) { config.headers.Authorization = 'Bearer ' + token } return config }) request.interceptors.response.use( response => { const res = response.data if (res.code === 200) { return res } ElMessage.error(res.message || '请求失败') return Promise.reject(new Error(res.message)) }, error => { if (error.response && error.response.status === 401) { ElMessage.error('登录已过期，请重新登录') localStorage.removeItem('token') router.push('/login') } else { ElMessage.error('网络异常，请稍后重试') } return Promise.reject(error) } ) export default request

页面组件的逻辑，以违章管理页为例，核心就是“一个表格 + 一个查询表单 + 一个新增/编辑弹窗 + 一个分页器”。查询条件变化时触发重新查询，新增和编辑共用同一个表单弹窗，保存成功后刷新列表，删除前用ElMessageBox.confirm弹确认框，这是后台管理系统非常标准的交互模式。

统计页面的实现用ECharts的核心思路是：页面加载时调用统计接口，拿到数据后用echarts.init初始化图表实例，通过setOption填充数据。需要注意的点是ECharts图表容器需要有明确的高度，否则图表渲染不出来；以及多个图表切换数据时，要调用chart.dispose()销毁旧实例再重新初始化，避免内存泄漏。

6. 部署上线与常见问题排查实录

6.1 前后端分离构建：从IDEA到服务器的一键打包

毕设系统的演示环境大概率就是自己的电脑，但“能不能打包成一个可运行的jar包”依然是一个必考的点。老师看到你在本地IDE里能跑只能算基础操作，能把项目打包、部署、访问完整跑起来，才是真正“会做项目”的证明。

后端打包很简单。用IDEA自带Maven面板，先跑clean再跑package，在target目录下会生成一个violation-system-0.0.1-SNAPSHOT.jar。直接运行：

java -jar violation-system-0.0.1-SNAPSHOT.jar

但这里有个前端的坑：如果你把前端页面也放在SpringBoot里一起部署，需要先把Vue项目构建成静态资源。在vue项目根目录执行npm run build，dist目录下就是打包好的前端文件。把dist里的内容拷贝到SpringBoot的src/main/resources/static目录下，重新打包jar，就能实现“单jar包部署”。

但如果你用的是Vite，默认打包时资源路径是绝对路径/assets/，直接塞到static下部署会全部404，需要在vite.config.js里设置：

export default defineConfig({ base: './', server: { port: 5173 }, ... })

base: './'让构建出的HTML引用资源时使用相对路径，这样才能在SpringBoot内嵌服务器下正常加载。

如果你选择前后端完全分离部署（前端用Nginx），Nginx反向代理的配置核心是把/api前缀的请求转发给后端8080端口：

server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; index index.html; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; } }

try_files $uri $uri/ /index.html是避免前端路由刷新404的关键配置。改成hash模式后其实不太需要它，但保留也没坏处。

6.2 高频问题速查表：版本、端口、跨域、时区

把我在带毕设过程中遇到最多的几个问题整理成一张表，方便你对着排查。

6.3 数据初始化：演示效果最好的“隐藏技巧”

演示系统时最怕的就是数据太少。数据库里只有三五条违章记录，老师一看就觉得系统是“空壳”。我的做法是写一个DataInitializer配置类，在项目启动时自动往数据库里插入8000条测试数据，数据由程序随机生成，车牌号、违章类型、时间范围都保持真实的分布规律。

@Component public class DataInitializer implements ApplicationRunner { @Override public void run(ApplicationArguments args) { long count = violationRecordMapper.selectCount(null); if (count == 0) { String[] types = {"违停", "超速", "闯红灯", "压线", "逆行", "不按规定车道行驶"}; String[] locations = {"人民路与建设街交叉口", "中山路万达广场门前", "解放大道百花路段", "环城高速15KM处"}; for (int i = 0; i < 8000; i++) { // 生成随机违章记录插入数据库 } } } }

启动后打开统计页面，图表里有波峰波谷，分页列表有几千条数据可翻页，演示效果完全不一样。这个方法成本极低，但让系统从“能跑”变成了“真有用”，强烈建议每一步都照着做。

7. 答辩加分项与我的实操体会

7.1 操作日志与异常全局处理：主动给自己“搭台子”

操作日志模块很多人觉得是多余的，但它在答辩时的作用是实打实的。登录系统、录入违章、修改车辆信息、处理违章——每个关键操作都写入日志表，页面提供一个日志查询界面，按操作人、操作时间、操作类型筛选。演示时你就直接打开这个页面，告诉老师“系统里所有关键操作都留痕，这个模块完全是基于AOP和自定义注解实现的”，比空口说“安全”有说服力得多。

实现逻辑不复杂：定义一个@Log注解，标注在Controller方法上；写一个AOP切面对注解做拦截，把请求方法名、参数、当前用户、IP、耗时等信息保存到日志表。这一段代码大约50行，却能让系统在“工程化”层面的评分上一个台阶。

全局异常处理也是加分项。写一个@RestControllerAdvice，捕获MethodArgumentNotValidException、BusinessException、Exception三类异常，分别返回友好的提示信息。这样即使前端传参错误，用户看到的也不是一坨异常堆栈，而是“参数校验失败：违章时间不能为空”这样的规范提示。这属于企业级开发的标配，在毕设中主动做出来，很容易被老师注意到。

7.2 论文与演示录制的关键建议

答辩前的准备和系统本身一样重要。论文结构建议完全围绕着“系统从需求到实现”的过程来写：绪论部分把开发背景和意义讲清楚，不要写空话；技术选型部分把SpringBoot、Vue、MySQL各自的特性以及为什么组合在一起用讲透；系统设计部分放数据库E-R图和核心表结构设计；系统实现部分按功能模块截图配代码说明；系统测试部分放测试用例表格，包含正常操作和异常操作的测试过程与结果。写论文时注意每一章截图的统一性，最好用同一种浏览器窗口大小去截图，排版会整洁很多。

演示的时候建议录一段视频。具体来说就是把所有核心功能完整走一遍，从登录、新增违章、查询筛选、处理违章、查看统计图表、导入数据到退出登录，全程录屏。之后再用另一台设备拍一段“跑在本地”的画面作为佐证。视频的时长控制在5到8分钟。真到了答辩现场，如果网络环境好，直接现场演示效果最好；如果网络卡顿或环境出问题，一段流畅的演示视频就是你的底牌。

还有一个容易被忽视的点：答辩前把所有代码格式化一遍，把无用的注释和调试代码删干净，尤其是System.out.println，不要在答辩时让学生看到你的代码里还留着大把打印输出。这体现的是代码洁癖和专业素养，虽然不起眼，但在老师心里的分量不小。

7.3 个人体会：做毕设不是为了“做完”，是为了“讲清”

带过的学生多了，我越来越深的一个体会是：做毕设最大的价值不是那个系统本身，而是你能不能把“从需求到实现”的整个过程讲清楚。老师问的问题往往不深，但非常刁钻，比如“你的表为什么要这样设计”“这个查询为什么慢”“如果用户数量翻倍系统会不会卡”。这些问题本质上是看你是否真正理解了自己的项目。

所以我的建议是：在做完一个模块后，自己给自己提三个问题——为什么用这个技术？这个功能的核心逻辑是什么？如果出错了怎么排查？回答不出来就去看代码、去看教程，直到能用自己的话把逻辑讲清楚。这种“主动消化”的过程，比代码本身更值钱。

有个小技巧分享给大家：在答辩前一周，准备一张A4纸，把系统的功能架构图画出来，把数据库核心表的关系画出来，把关键接口的调用流程写上去，然后对着这张纸模拟讲解三五遍。不用背稿子，就按自己的理解讲，讲到自己觉得顺了为止。答辩的核心永远是“理解”二字，理解了就能讲，讲清楚了就一定能过。

最后如果说还有什么要嘱咐的，那就是：哪怕时间紧张，也一定要让自己亲手把代码敲一遍。网上现成的毕设源码很多，但直接复制粘贴的结果是答辩现场一紧张就露馅。亲手敲一遍，你会在过程中理解所有决定背后的原因——为什么这个字段要用datetime而不是timestamp，为什么这个接口要返回VO而不是直接返回实体类，为什么查询要用LambdaQueryWrapper而不是直接写SQL。这些“为什么”串起来，才是你在答辩场上真正的底气。