简介这是一套面向计算机相关专业毕业设计或课程作业的车辆管理系统完整项目基于Java与SpringBoot框架实现涵盖管理员与员工双角色包含证件信息、车辆信息、业务单据、事故登记、维修、保养、加油、违章等核心业务模块既可用于实际车辆管理场景也能帮助学习者掌握从需求分析、数据库设计到前后端编码的整体流程同时清晰展示了系统各功能模块的划分依据与交互流程。包内共427个文件包含114个Java后端源码、44个Vue前端组件、16个JS脚本及多个页面样式文件另有数据库初始化脚本、项目构建配置以及大量SVG图标和图片素材压缩包整体仅10.04MB目录结构清晰便于本地运行、调试与二次开发能够覆盖从数据初始化到前端展示的完整链路。目前已有111人学习浏览适合需要快速搭建同类型管理系统或撰写系统设计文档的开发者可重点参考其模块划分、权限控制与数据表设计思路。1. 车辆管理-java-基于springBoot车辆管理系统设计与实现从选题到可运行闭环“车辆管理-java-基于springBoot车辆管理系统设计与实现毕业论文”是毕业设计里出现频率最高的管理信息系统选题之一。它交付的不是算法而是一个能运行、能演示、能答辩的完整闭环车辆档案、驾驶员、出车记录、维修记录、统计报表加登录和权限控制。业务本身不复杂复杂度集中在 SpringBoot 分层怎么落、数据库表怎么设计状态流转、接口怎么写才能挡住并发问题。这套做法对两类人有用正在做毕业设计、需要从零搭一个 SpringBoot 车辆管理系统的同学以及接手评审类似论文项目、想快速判断实现边界的工程师。下文按毕业论文工程的验收标准给出建表语句、核心接口代码和关键配置可以直接抄表名和字段按自己的业务重命名一遍更稳。2. SpringBoot 车辆管理系统分层架构与自动装配的落地解读2.1 为什么是 SpringBoot从起步依赖到自动装配车辆管理系统与高并发互联网项目的差别在于业务规则密而技术栈标准。核心模块是车辆档案、驾驶员、出车记录和维修记录操作以增删改查加状态流转为主不存在自研框架的必要。SpringBoot 在这里最大的价值是把 Spring MVC、事务管理、连接池、JSON 序列化这些组件用起步依赖打包让项目以最少配置启动这也是 SpringBoot 项目能在毕业设计里快速跑起来的原因。自动装配原理是这类论文“系统实现”一章的必写点。启动类上的SpringBootApplication由EnableAutoConfiguration触发Spring 工厂会加载META-INF/spring.factories或META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports里声明的自动配置类再通过ConditionalOnClass、ConditionalOnProperty等条件注解决定是否生效。这一机制决定了 starter 引对了功能就自动可用引错了启动报错时第一反应是查依赖而不是查代码。Java 面试八股里问 SpringBoot 自动装配考的就是这层条件注册逻辑而不是“SpringBoot 简化了配置”这种空话。2.2 车辆管理系统的最小分层Controller / Service / Mapper把接口、业务、数据访问切成三层是论文项目最稳妥的代码边界。对车辆管理系统这种规模引入更复杂的 DDD 分层或 CQRS 反而会让答辩时的职责划分变模糊三层足够覆盖。层次职责必须避免的事Controller接收参数、调用服务、返回统一结果不写业务判断不直接操作 MapperService事务边界、状态校验、业务规则编排不把实体直接暴露给接口层MapperSQL 或 MyBatis-Plus 的 BaseMapper 通用方法不在循环里逐条查库这套分层的意义在于答辩时被问“出车时车辆状态被其他人改成维修怎么办”可以明确回答状态检查在 Service 完成并发冲突由更新语句的条件兜底。常见反面写法是把 status 判断写在 Controller 里或者 Service 里先查出实体、改完再 update前者让接口层承担了业务规则后者在并发场景必然丢更新。车辆管理系统的业务逻辑没有复杂到需要防腐层三层是性价比最高的选择。2.3 用目录结构固定代码边界包结构可以直接复用这一组com.example.fleet ├── controller ├── service │ └── impl ├── mapper ├── entity ├── dto ├── vo ├── config ├── common │ ├── result │ └── exception └── interceptordto 放请求入参vo 放响应结果。很多毕设项目图省事用 Map 接收查询条件车牌号、状态、日期范围、分页参数全塞进一个 Map前端传错字段名时编译期发现不了。把新增车辆请求和车辆列表查询拆成CreateCarRequest和CarQuery两个类接口签名一眼能看懂答辩画类图也更好整理。pom.xml 的关键依赖如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-api/artifactId version0.11.5/version /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependenciesSpringBoot 父工程选 2.7.18 而不是 3.x主要原因有两个SpringBoot 3 强制要求 JDK 17而毕业论文机房或老师演示环境的 JDK 版本往往不可控SpringBoot 3 把 javax.* 包全部迁到 jakarta.*网上大量 SpringBoot 2 教程里的拦截器、Servlet 相关代码不能直接迁移。mybatis-plus-boot-starter 3.5.5 兼容 SpringBoot 2分页插件和逻辑删除的配置方式稳定。jjwt 用 0.11.5原因是 0.12.x 之后包结构变动较大教程对不上时会多花半小时调 import。每个版本都显式写清楚是为了保证在另一台机器上能复现而不是盲目追新。3. 车辆管理系统的数据模型设计与车辆状态流转3.1 车辆档案表用状态字段而不是数据库枚举车辆档案表是系统的核心表字段要覆盖车辆身份信息、状态和逻辑删除标记。建表语句如下CREATE TABLE fleet_car ( id BIGINT AUTO_INCREMENT PRIMARY KEY, plate_no VARCHAR(20) NOT NULL COMMENT 车牌号, brand VARCHAR(50) NOT NULL COMMENT 品牌, model VARCHAR(50) NOT NULL COMMENT 型号, vin VARCHAR(50) COMMENT 车架号, engine_no VARCHAR(50) COMMENT 发动机号, buy_date DATE COMMENT 购置日期, status VARCHAR(20) NOT NULL DEFAULT AVAILABLE COMMENT 车辆状态, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, deleted TINYINT NOT NULL DEFAULT 0, UNIQUE KEY uk_plate_no (plate_no), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT车辆档案表;plate_no 加唯一索引防止重复建档status 加普通索引是因为车辆列表页最常见的筛选条件就是状态。deleted 字段配合 MyBatis-Plus 的TableLogic做逻辑删除车辆档案不建议物理删除因为出车记录还关联着它。这里有一个实际运行会踩的坑唯一索引与逻辑删除冲突。删除一辆浙A12345的车后再插入同车牌号的新车deleted 字段不同但 plate_no 违反唯一索引插入直接失败。常见做法是把唯一索引改成(plate_no, deleted)或者在删除时额外更新一个 deleted_time 参与唯一约束。前一种改法最简单适合毕业论文场景。status 字段用 VARCHAR 而不是数据库 enum 或 int原因有两个MySQL 的 enum 类型后续想加“年检中”一类状态需要执行 ALTER TABLE 改字段定义代价高int 存状态在代码里可读性差容易把 1 和 2 写反。用 VARCHAR 存可读的状态码在 Java 侧再定义一个常量类或枚举类约束取值是管理信息系统里最常见、也最好维护的做法。3.2 驾驶员表和出车台账外键的取舍车辆管理不能只有车还要有驾驶员和出车记录。两张关联表的建表语句如下CREATE TABLE fleet_driver ( id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(30) NOT NULL COMMENT 姓名, license_no VARCHAR(30) NOT NULL COMMENT 驾驶证号, phone VARCHAR(20) COMMENT 联系电话, hire_date DATE COMMENT 入职日期, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, deleted TINYINT NOT NULL DEFAULT 0, UNIQUE KEY uk_license_no (license_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT驾驶员表; CREATE TABLE fleet_trip_record ( id BIGINT AUTO_INCREMENT PRIMARY KEY, car_id BIGINT NOT NULL COMMENT 车辆ID, driver_id BIGINT NOT NULL COMMENT 驾驶员ID, start_km INT NOT NULL COMMENT 出发里程, end_km INT COMMENT 结束里程, start_time DATETIME NOT NULL COMMENT 出发时间, end_time DATETIME COMMENT 归还时间, purpose VARCHAR(255) COMMENT 出车事由, status VARCHAR(20) NOT NULL DEFAULT ONGOING COMMENT ONGOING/FINISHED, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, KEY idx_car_id (car_id), KEY idx_driver_id (driver_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT出车记录表;这两张表故意没有加物理外键约束只用普通索引。原因是物理外键每次插入都会检查父表存在性批量导入出车记录时会拖慢写入车辆删除是逻辑删除驾驶员离职也是逻辑删除物理外键对此无能为力。在论文里写成“逻辑外键加索引在应用层保证引用完整性”比硬加 FOREIGN KEY 更符合实际工程习惯答辩时也更能说清楚取舍。外键对应的 car_id、driver_id 都要建索引否则按车辆查历史出车记录时全表扫描。出车记录里的里程字段用 INT 存公里数是整数类型里性价比最高的选择。start_km 在出车时写入end_km 在归还时更新两张表通过 trip_record.car_id 关联不用在车辆表里冗余一个当前里程。车辆当前里程可以后期用一条聚合 SQL 查最近一条出车记录的 end_km 得到避免数据冗余。3.3 状态机可用、出车中、维修中、报废车辆状态必须是一个有限状态机不能靠前端传什么就存什么。状态定义如下状态码含义允许迁移到触发操作AVAILABLE可用OUT / REPAIRING出车、送修OUT出车中AVAILABLE归还REPAIRING维修中AVAILABLE维修完成入库RETIRED报废无批量报废状态变更要在 Service 层提供语义化方法比如tripOut()、tripBack()、toRepair()、backToAvailable()而不是直接暴露setStatus。原因有两个状态迁移往往伴随其他表的操作出车时要同时插入 trip_record归还时要更新 end_km 和 end_time放 Service 里才能用Transactional把两件事包在同一个事务里直接 setStatus 会让非法迁移比如把维修中的车直接置为出车中无处拦截。状态机规则不需要引入状态机框架在 Service 方法里用条件更新实现即可具体写法在第四章展开。这里只需要在建表阶段把状态码统一成大写字符串避免出现 “available”“Out” 这类大小写不一致的数据。4. SpringBoot 车辆管理核心接口JWT 登录、分页查询与状态变更4.1 登录签发 JWT 和拦截器注册管理系统需要一个登录接口。这里选择 JWT 而不是 Session是因为毕业论文系统通常前后端分离前端部署在独立端口JWT 无状态、跨域友好。登录接口如下RestController RequestMapping(/api/auth) public class AuthController { PostMapping(/login) public ResultString login(RequestBody LoginRequest req) { // 密码用 BCrypt 存储这里只用 spring-security-crypto 里的工具类 User user userMapper.selectOne( new LambdaQueryWrapperUser() .eq(User::getUsername, req.getUsername())); if (user null || !BCrypt.checkpw(req.getPassword(), user.getPassword())) { throw new BizException(用户名或密码错误); } String token JwtUtil.createToken(user.getId(), user.getRole()); return Result.ok(token); } }密码绝不能明文存也不需要自己写 MD5。BCrypt 是spring-security-crypto里现成的类单独引入这个模块即可不用把整个 Spring Security 拉进来。JWT 里只放 userId 和 role不放手机号、身份证这类敏感字段因为 JWT 的 payload 只是 Base64Url 编码不是加密任何人都能解码看到内容。JWT 工具类里需要两个关键参数secret 密钥和过期时间。过期时间一般设在 2 到 8 小时毕设系统做登出的常见做法是前端直接删除 token后端不做状态管理这点在论文里要写清楚。然后是拦截器注册Component public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String token request.getHeader(Authorization); if (token null || !JwtUtil.verify(token)) { response.setStatus(401); return false; } return true; } }拦截器注册到 WebMvcConfigurer 时放行路径要写全/api/auth/login、/doc.html、/webjars/**、/v3/api-docs/**、/swagger-ui/**。漏掉任意一个Swagger 页面就会 401这是配置拦截器最常见的坑。4.2 用 MyBatis-Plus 实现车辆分页与条件过滤车辆列表页需要支持按车牌号模糊查询、按状态精确过滤、分页返回。Controller 层写法如下GetMapping(/cars) public ResultPageCarVO page(CarQuery query, RequestParam(defaultValue 1) long page, RequestParam(defaultValue 10) long size) { PageCar p new Page(page, size); LambdaQueryWrapperCar wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(query.getPlateNo()), Car::getPlateNo, query.getPlateNo()) .eq(StringUtils.hasText(query.getStatus()), Car::getStatus, query.getStatus()) .orderByDesc(Car::getCreateTime); PageCar result carMapper.selectPage(p, wrapper); // 实体转 VO隐藏逻辑删除字段 PageCarVO voPage result.convert(CarVO::from); return Result.ok(voPage); }like和eq的第一个参数是布尔条件false 时该条件不拼进 SQL避免了在 Java 代码里堆 if。Page对象是 MyBatis-Plus 的分页模型selectPage会自动执行 count 查询和 limit 拼接。分页不生效的最常见原因是没有配置分页插件selectPage会把全表数据查出来然后在内存里截取。拦截器配置如下Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }PaginationInnerInterceptor的DbType.MYSQL参数决定 limit 语句的方言格式。少了这个 Bean分页接口返回的总条数和数据都对不上而且这个问题只会在运行时报错或性能异常时暴露编译期完全无感知。本地排查时可以把 MyBatis-Plus 的 SQL 日志打开确认打印出来的语句确实带 LIMIT。4.3 状态变更接口条件更新当乐观锁车辆出车是一个经典并发场景两个操作员同时看到车辆可用同时点出车。如果先查状态再 update两次请求都会成功车辆被开出两次。正确做法是在 UPDATE 语句的条件里带上当前状态让数据库来做原子判断Transactional public void tripOut(Long carId, Long driverId, Integer startKm) { // 条件更新只有状态是 AVAILABLE 时才能更新为 OUT int rows carMapper.update(null, new LambdaUpdateWrapperCar() .eq(Car::getId, carId) .eq(Car::getStatus, AVAILABLE) .set(Car::getStatus, OUT)); if (rows 0) { throw new BizException(车辆状态已变化请刷新后重试); } TripRecord record new TripRecord(); record.setCarId(carId); record.setDriverId(driverId); record.setStartKm(startKm); record.setStartTime(LocalDateTime.now()); record.setStatus(ONGOING); tripRecordMapper.insert(record); }返回的 rows 是受影响行数0 表示当前状态不是 AVAILABLE说明车辆已经被别人开出或送去维修。这种方式叫“条件更新即乐观锁”比单独维护 version 字段更直观答辩时把 SQL 语句讲明白就能说清并发问题。Transactional保证车辆状态更新和出车记录插入要么都成功要么都失败不会出现车已出但记录没写上的情况。归还接口tripBack用同样的思路条件是 status OUT同时更新 end_km、end_time 和记录状态。4.4 ConfigurationProperties 管理 JWT 配置JWT 的 secret 和过期时间不该硬编码在 Java 类里。用 ConfigurationProperties 把一组配置映射到配置类是 SpringBoot 官方推荐的方式Component ConfigurationProperties(prefix fleet.jwt) Data public class JwtProperties { private String secret; private long expireHours; }application.yml 中对应配置fleet: jwt: secret: your-256bit-secret-key-here expire-hours: 8prefix fleet.jwt表示读取 yml 里fleet.jwt前缀下的所有配置字段名与配置项名自动绑定。与Value(${fleet.jwt.secret})相比ConfigurationProperties 适合一组配置的整体注入类型安全还支持数据校验Value 更适合零散的一两个配置项。毕设项目里只要 JWT 配置超过一个字段就值得用ConfigurationProperties。接口清单在论文的“系统功能设计”表里一般按下面这个结构整理方法路径参数说明POST/api/auth/loginLoginRequest登录获取 tokenGET/api/carspage, size, plateNo, status车辆分页查询POST/api/carsCreateCarRequest新增车辆PUT/api/cars/{id}UpdateCarRequest修改车辆信息POST/api/cars/{id}/trip-outTripOutRequest出车POST/api/cars/{id}/trip-backTripBackRequest归还DELETE/api/cars/{id}无逻辑删除车辆5. 毕业论文答辩前的工程化补齐接口文档、安全收敛与版本兼容5.1 SpringBoot 3 的 javax 到 jakarta 迁移如果指导老师要求必须用 SpringBoot 3启动前先确认三件事JDK 必须是 17 及以上所有依赖里的javax.servlet要换成jakarta.servletMyBatis-Plus 要改用mybatis-plus-spring-boot3-starter而不是mybatis-plus-boot-starter。最常见启动失败日志是ClassNotFoundException: javax.servlet.Filter原因就是直接从网上复制了 SpringBoot 2 项目的拦截器或过滤器代码。SpringBoot 版本太高导致的依赖不兼容在脚手架阶段暴露比在答辩前暴露好得多所以没有特殊要求时2.7.18 仍是车辆管理系统最稳的选择。5.2 全局异常处理与统一返回结构Controller 层不能让异常直接抛到前端。写一个RestControllerAdvice捕获业务异常和未知异常统一返回 Result 结构前端只需要处理{ code, message, data }三种字段。业务异常BizException返回 code 400未知异常返回 code 500 并记录日志不做任何堆栈信息外抛。这个设计在论文测试章节里可以作为“系统健壮性测试”的验收点。5.3 收掉 actuator 与 heapdump 敏感信息泄露风险毕设系统如果引了 spring-boot-starter-actuator 做健康检查默认会把 /actuator 下多个端点暴露出来其中 heapdump 端点会导出 JVM 堆内存快照里面包含用户密码、token、数据库连接串等敏感信息。这类问题在网络安全面试里常被拿来考论文里的安全设计部分最好直接写明收敛方案。生产环境配置如下management: endpoints: web: exposure: include: health,info jmx: exposure: exclude: *只暴露 health 和 info其余端点全部关闭。本地调试需要看配置时临时放开 env 端点调试完必须改回。这个配置放在 application-prod.yml 里和开发环境配置分开。5.4 大偏移量分页的优化技巧车辆数据量超过十万条后page10000 时 MyBatis-Plus 的 LIMIT 100000, 10 会扫描十万行再丢弃速度明显变慢。毕业论文系统的数据量通常到不了这个量级但答辩时讲出这个优化点是加分项。做法是列表页改用游标分页前端传最后一条记录的 id后端用WHERE id #{lastId} ORDER BY id DESC LIMIT 10取下一页查询走主键索引不需要扫描偏移量。缺点是不能再跳页但车辆列表按时间倒序浏览用户一般只看前几页体验差异不大。在 CarQuery 里加一个 lastId 字段分页拦截器只对 page 模式的请求生效游标模式单独写一个方法即可。本文还有配套的精品资源点击获取 基于SpringBoot的车辆管理系统设计与实现：分层架构到状态机实战
简介这是一套面向计算机相关专业毕业设计或课程作业的车辆管理系统完整项目基于Java与SpringBoot框架实现涵盖管理员与员工双角色包含证件信息、车辆信息、业务单据、事故登记、维修、保养、加油、违章等核心业务模块既可用于实际车辆管理场景也能帮助学习者掌握从需求分析、数据库设计到前后端编码的整体流程同时清晰展示了系统各功能模块的划分依据与交互流程。包内共427个文件包含114个Java后端源码、44个Vue前端组件、16个JS脚本及多个页面样式文件另有数据库初始化脚本、项目构建配置以及大量SVG图标和图片素材压缩包整体仅10.04MB目录结构清晰便于本地运行、调试与二次开发能够覆盖从数据初始化到前端展示的完整链路。目前已有111人学习浏览适合需要快速搭建同类型管理系统或撰写系统设计文档的开发者可重点参考其模块划分、权限控制与数据表设计思路。1. 车辆管理-java-基于springBoot车辆管理系统设计与实现从选题到可运行闭环“车辆管理-java-基于springBoot车辆管理系统设计与实现毕业论文”是毕业设计里出现频率最高的管理信息系统选题之一。它交付的不是算法而是一个能运行、能演示、能答辩的完整闭环车辆档案、驾驶员、出车记录、维修记录、统计报表加登录和权限控制。业务本身不复杂复杂度集中在 SpringBoot 分层怎么落、数据库表怎么设计状态流转、接口怎么写才能挡住并发问题。这套做法对两类人有用正在做毕业设计、需要从零搭一个 SpringBoot 车辆管理系统的同学以及接手评审类似论文项目、想快速判断实现边界的工程师。下文按毕业论文工程的验收标准给出建表语句、核心接口代码和关键配置可以直接抄表名和字段按自己的业务重命名一遍更稳。2. SpringBoot 车辆管理系统分层架构与自动装配的落地解读2.1 为什么是 SpringBoot从起步依赖到自动装配车辆管理系统与高并发互联网项目的差别在于业务规则密而技术栈标准。核心模块是车辆档案、驾驶员、出车记录和维修记录操作以增删改查加状态流转为主不存在自研框架的必要。SpringBoot 在这里最大的价值是把 Spring MVC、事务管理、连接池、JSON 序列化这些组件用起步依赖打包让项目以最少配置启动这也是 SpringBoot 项目能在毕业设计里快速跑起来的原因。自动装配原理是这类论文“系统实现”一章的必写点。启动类上的SpringBootApplication由EnableAutoConfiguration触发Spring 工厂会加载META-INF/spring.factories或META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports里声明的自动配置类再通过ConditionalOnClass、ConditionalOnProperty等条件注解决定是否生效。这一机制决定了 starter 引对了功能就自动可用引错了启动报错时第一反应是查依赖而不是查代码。Java 面试八股里问 SpringBoot 自动装配考的就是这层条件注册逻辑而不是“SpringBoot 简化了配置”这种空话。2.2 车辆管理系统的最小分层Controller / Service / Mapper把接口、业务、数据访问切成三层是论文项目最稳妥的代码边界。对车辆管理系统这种规模引入更复杂的 DDD 分层或 CQRS 反而会让答辩时的职责划分变模糊三层足够覆盖。层次职责必须避免的事Controller接收参数、调用服务、返回统一结果不写业务判断不直接操作 MapperService事务边界、状态校验、业务规则编排不把实体直接暴露给接口层MapperSQL 或 MyBatis-Plus 的 BaseMapper 通用方法不在循环里逐条查库这套分层的意义在于答辩时被问“出车时车辆状态被其他人改成维修怎么办”可以明确回答状态检查在 Service 完成并发冲突由更新语句的条件兜底。常见反面写法是把 status 判断写在 Controller 里或者 Service 里先查出实体、改完再 update前者让接口层承担了业务规则后者在并发场景必然丢更新。车辆管理系统的业务逻辑没有复杂到需要防腐层三层是性价比最高的选择。2.3 用目录结构固定代码边界包结构可以直接复用这一组com.example.fleet ├── controller ├── service │ └── impl ├── mapper ├── entity ├── dto ├── vo ├── config ├── common │ ├── result │ └── exception └── interceptordto 放请求入参vo 放响应结果。很多毕设项目图省事用 Map 接收查询条件车牌号、状态、日期范围、分页参数全塞进一个 Map前端传错字段名时编译期发现不了。把新增车辆请求和车辆列表查询拆成CreateCarRequest和CarQuery两个类接口签名一眼能看懂答辩画类图也更好整理。pom.xml 的关键依赖如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-api/artifactId version0.11.5/version /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependenciesSpringBoot 父工程选 2.7.18 而不是 3.x主要原因有两个SpringBoot 3 强制要求 JDK 17而毕业论文机房或老师演示环境的 JDK 版本往往不可控SpringBoot 3 把 javax.* 包全部迁到 jakarta.*网上大量 SpringBoot 2 教程里的拦截器、Servlet 相关代码不能直接迁移。mybatis-plus-boot-starter 3.5.5 兼容 SpringBoot 2分页插件和逻辑删除的配置方式稳定。jjwt 用 0.11.5原因是 0.12.x 之后包结构变动较大教程对不上时会多花半小时调 import。每个版本都显式写清楚是为了保证在另一台机器上能复现而不是盲目追新。3. 车辆管理系统的数据模型设计与车辆状态流转3.1 车辆档案表用状态字段而不是数据库枚举车辆档案表是系统的核心表字段要覆盖车辆身份信息、状态和逻辑删除标记。建表语句如下CREATE TABLE fleet_car ( id BIGINT AUTO_INCREMENT PRIMARY KEY, plate_no VARCHAR(20) NOT NULL COMMENT 车牌号, brand VARCHAR(50) NOT NULL COMMENT 品牌, model VARCHAR(50) NOT NULL COMMENT 型号, vin VARCHAR(50) COMMENT 车架号, engine_no VARCHAR(50) COMMENT 发动机号, buy_date DATE COMMENT 购置日期, status VARCHAR(20) NOT NULL DEFAULT AVAILABLE COMMENT 车辆状态, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, deleted TINYINT NOT NULL DEFAULT 0, UNIQUE KEY uk_plate_no (plate_no), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT车辆档案表;plate_no 加唯一索引防止重复建档status 加普通索引是因为车辆列表页最常见的筛选条件就是状态。deleted 字段配合 MyBatis-Plus 的TableLogic做逻辑删除车辆档案不建议物理删除因为出车记录还关联着它。这里有一个实际运行会踩的坑唯一索引与逻辑删除冲突。删除一辆浙A12345的车后再插入同车牌号的新车deleted 字段不同但 plate_no 违反唯一索引插入直接失败。常见做法是把唯一索引改成(plate_no, deleted)或者在删除时额外更新一个 deleted_time 参与唯一约束。前一种改法最简单适合毕业论文场景。status 字段用 VARCHAR 而不是数据库 enum 或 int原因有两个MySQL 的 enum 类型后续想加“年检中”一类状态需要执行 ALTER TABLE 改字段定义代价高int 存状态在代码里可读性差容易把 1 和 2 写反。用 VARCHAR 存可读的状态码在 Java 侧再定义一个常量类或枚举类约束取值是管理信息系统里最常见、也最好维护的做法。3.2 驾驶员表和出车台账外键的取舍车辆管理不能只有车还要有驾驶员和出车记录。两张关联表的建表语句如下CREATE TABLE fleet_driver ( id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(30) NOT NULL COMMENT 姓名, license_no VARCHAR(30) NOT NULL COMMENT 驾驶证号, phone VARCHAR(20) COMMENT 联系电话, hire_date DATE COMMENT 入职日期, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, deleted TINYINT NOT NULL DEFAULT 0, UNIQUE KEY uk_license_no (license_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT驾驶员表; CREATE TABLE fleet_trip_record ( id BIGINT AUTO_INCREMENT PRIMARY KEY, car_id BIGINT NOT NULL COMMENT 车辆ID, driver_id BIGINT NOT NULL COMMENT 驾驶员ID, start_km INT NOT NULL COMMENT 出发里程, end_km INT COMMENT 结束里程, start_time DATETIME NOT NULL COMMENT 出发时间, end_time DATETIME COMMENT 归还时间, purpose VARCHAR(255) COMMENT 出车事由, status VARCHAR(20) NOT NULL DEFAULT ONGOING COMMENT ONGOING/FINISHED, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, KEY idx_car_id (car_id), KEY idx_driver_id (driver_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT出车记录表;这两张表故意没有加物理外键约束只用普通索引。原因是物理外键每次插入都会检查父表存在性批量导入出车记录时会拖慢写入车辆删除是逻辑删除驾驶员离职也是逻辑删除物理外键对此无能为力。在论文里写成“逻辑外键加索引在应用层保证引用完整性”比硬加 FOREIGN KEY 更符合实际工程习惯答辩时也更能说清楚取舍。外键对应的 car_id、driver_id 都要建索引否则按车辆查历史出车记录时全表扫描。出车记录里的里程字段用 INT 存公里数是整数类型里性价比最高的选择。start_km 在出车时写入end_km 在归还时更新两张表通过 trip_record.car_id 关联不用在车辆表里冗余一个当前里程。车辆当前里程可以后期用一条聚合 SQL 查最近一条出车记录的 end_km 得到避免数据冗余。3.3 状态机可用、出车中、维修中、报废车辆状态必须是一个有限状态机不能靠前端传什么就存什么。状态定义如下状态码含义允许迁移到触发操作AVAILABLE可用OUT / REPAIRING出车、送修OUT出车中AVAILABLE归还REPAIRING维修中AVAILABLE维修完成入库RETIRED报废无批量报废状态变更要在 Service 层提供语义化方法比如tripOut()、tripBack()、toRepair()、backToAvailable()而不是直接暴露setStatus。原因有两个状态迁移往往伴随其他表的操作出车时要同时插入 trip_record归还时要更新 end_km 和 end_time放 Service 里才能用Transactional把两件事包在同一个事务里直接 setStatus 会让非法迁移比如把维修中的车直接置为出车中无处拦截。状态机规则不需要引入状态机框架在 Service 方法里用条件更新实现即可具体写法在第四章展开。这里只需要在建表阶段把状态码统一成大写字符串避免出现 “available”“Out” 这类大小写不一致的数据。4. SpringBoot 车辆管理核心接口JWT 登录、分页查询与状态变更4.1 登录签发 JWT 和拦截器注册管理系统需要一个登录接口。这里选择 JWT 而不是 Session是因为毕业论文系统通常前后端分离前端部署在独立端口JWT 无状态、跨域友好。登录接口如下RestController RequestMapping(/api/auth) public class AuthController { PostMapping(/login) public ResultString login(RequestBody LoginRequest req) { // 密码用 BCrypt 存储这里只用 spring-security-crypto 里的工具类 User user userMapper.selectOne( new LambdaQueryWrapperUser() .eq(User::getUsername, req.getUsername())); if (user null || !BCrypt.checkpw(req.getPassword(), user.getPassword())) { throw new BizException(用户名或密码错误); } String token JwtUtil.createToken(user.getId(), user.getRole()); return Result.ok(token); } }密码绝不能明文存也不需要自己写 MD5。BCrypt 是spring-security-crypto里现成的类单独引入这个模块即可不用把整个 Spring Security 拉进来。JWT 里只放 userId 和 role不放手机号、身份证这类敏感字段因为 JWT 的 payload 只是 Base64Url 编码不是加密任何人都能解码看到内容。JWT 工具类里需要两个关键参数secret 密钥和过期时间。过期时间一般设在 2 到 8 小时毕设系统做登出的常见做法是前端直接删除 token后端不做状态管理这点在论文里要写清楚。然后是拦截器注册Component public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String token request.getHeader(Authorization); if (token null || !JwtUtil.verify(token)) { response.setStatus(401); return false; } return true; } }拦截器注册到 WebMvcConfigurer 时放行路径要写全/api/auth/login、/doc.html、/webjars/**、/v3/api-docs/**、/swagger-ui/**。漏掉任意一个Swagger 页面就会 401这是配置拦截器最常见的坑。4.2 用 MyBatis-Plus 实现车辆分页与条件过滤车辆列表页需要支持按车牌号模糊查询、按状态精确过滤、分页返回。Controller 层写法如下GetMapping(/cars) public ResultPageCarVO page(CarQuery query, RequestParam(defaultValue 1) long page, RequestParam(defaultValue 10) long size) { PageCar p new Page(page, size); LambdaQueryWrapperCar wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(query.getPlateNo()), Car::getPlateNo, query.getPlateNo()) .eq(StringUtils.hasText(query.getStatus()), Car::getStatus, query.getStatus()) .orderByDesc(Car::getCreateTime); PageCar result carMapper.selectPage(p, wrapper); // 实体转 VO隐藏逻辑删除字段 PageCarVO voPage result.convert(CarVO::from); return Result.ok(voPage); }like和eq的第一个参数是布尔条件false 时该条件不拼进 SQL避免了在 Java 代码里堆 if。Page对象是 MyBatis-Plus 的分页模型selectPage会自动执行 count 查询和 limit 拼接。分页不生效的最常见原因是没有配置分页插件selectPage会把全表数据查出来然后在内存里截取。拦截器配置如下Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }PaginationInnerInterceptor的DbType.MYSQL参数决定 limit 语句的方言格式。少了这个 Bean分页接口返回的总条数和数据都对不上而且这个问题只会在运行时报错或性能异常时暴露编译期完全无感知。本地排查时可以把 MyBatis-Plus 的 SQL 日志打开确认打印出来的语句确实带 LIMIT。4.3 状态变更接口条件更新当乐观锁车辆出车是一个经典并发场景两个操作员同时看到车辆可用同时点出车。如果先查状态再 update两次请求都会成功车辆被开出两次。正确做法是在 UPDATE 语句的条件里带上当前状态让数据库来做原子判断Transactional public void tripOut(Long carId, Long driverId, Integer startKm) { // 条件更新只有状态是 AVAILABLE 时才能更新为 OUT int rows carMapper.update(null, new LambdaUpdateWrapperCar() .eq(Car::getId, carId) .eq(Car::getStatus, AVAILABLE) .set(Car::getStatus, OUT)); if (rows 0) { throw new BizException(车辆状态已变化请刷新后重试); } TripRecord record new TripRecord(); record.setCarId(carId); record.setDriverId(driverId); record.setStartKm(startKm); record.setStartTime(LocalDateTime.now()); record.setStatus(ONGOING); tripRecordMapper.insert(record); }返回的 rows 是受影响行数0 表示当前状态不是 AVAILABLE说明车辆已经被别人开出或送去维修。这种方式叫“条件更新即乐观锁”比单独维护 version 字段更直观答辩时把 SQL 语句讲明白就能说清并发问题。Transactional保证车辆状态更新和出车记录插入要么都成功要么都失败不会出现车已出但记录没写上的情况。归还接口tripBack用同样的思路条件是 status OUT同时更新 end_km、end_time 和记录状态。4.4 ConfigurationProperties 管理 JWT 配置JWT 的 secret 和过期时间不该硬编码在 Java 类里。用 ConfigurationProperties 把一组配置映射到配置类是 SpringBoot 官方推荐的方式Component ConfigurationProperties(prefix fleet.jwt) Data public class JwtProperties { private String secret; private long expireHours; }application.yml 中对应配置fleet: jwt: secret: your-256bit-secret-key-here expire-hours: 8prefix fleet.jwt表示读取 yml 里fleet.jwt前缀下的所有配置字段名与配置项名自动绑定。与Value(${fleet.jwt.secret})相比ConfigurationProperties 适合一组配置的整体注入类型安全还支持数据校验Value 更适合零散的一两个配置项。毕设项目里只要 JWT 配置超过一个字段就值得用ConfigurationProperties。接口清单在论文的“系统功能设计”表里一般按下面这个结构整理方法路径参数说明POST/api/auth/loginLoginRequest登录获取 tokenGET/api/carspage, size, plateNo, status车辆分页查询POST/api/carsCreateCarRequest新增车辆PUT/api/cars/{id}UpdateCarRequest修改车辆信息POST/api/cars/{id}/trip-outTripOutRequest出车POST/api/cars/{id}/trip-backTripBackRequest归还DELETE/api/cars/{id}无逻辑删除车辆5. 毕业论文答辩前的工程化补齐接口文档、安全收敛与版本兼容5.1 SpringBoot 3 的 javax 到 jakarta 迁移如果指导老师要求必须用 SpringBoot 3启动前先确认三件事JDK 必须是 17 及以上所有依赖里的javax.servlet要换成jakarta.servletMyBatis-Plus 要改用mybatis-plus-spring-boot3-starter而不是mybatis-plus-boot-starter。最常见启动失败日志是ClassNotFoundException: javax.servlet.Filter原因就是直接从网上复制了 SpringBoot 2 项目的拦截器或过滤器代码。SpringBoot 版本太高导致的依赖不兼容在脚手架阶段暴露比在答辩前暴露好得多所以没有特殊要求时2.7.18 仍是车辆管理系统最稳的选择。5.2 全局异常处理与统一返回结构Controller 层不能让异常直接抛到前端。写一个RestControllerAdvice捕获业务异常和未知异常统一返回 Result 结构前端只需要处理{ code, message, data }三种字段。业务异常BizException返回 code 400未知异常返回 code 500 并记录日志不做任何堆栈信息外抛。这个设计在论文测试章节里可以作为“系统健壮性测试”的验收点。5.3 收掉 actuator 与 heapdump 敏感信息泄露风险毕设系统如果引了 spring-boot-starter-actuator 做健康检查默认会把 /actuator 下多个端点暴露出来其中 heapdump 端点会导出 JVM 堆内存快照里面包含用户密码、token、数据库连接串等敏感信息。这类问题在网络安全面试里常被拿来考论文里的安全设计部分最好直接写明收敛方案。生产环境配置如下management: endpoints: web: exposure: include: health,info jmx: exposure: exclude: *只暴露 health 和 info其余端点全部关闭。本地调试需要看配置时临时放开 env 端点调试完必须改回。这个配置放在 application-prod.yml 里和开发环境配置分开。5.4 大偏移量分页的优化技巧车辆数据量超过十万条后page10000 时 MyBatis-Plus 的 LIMIT 100000, 10 会扫描十万行再丢弃速度明显变慢。毕业论文系统的数据量通常到不了这个量级但答辩时讲出这个优化点是加分项。做法是列表页改用游标分页前端传最后一条记录的 id后端用WHERE id #{lastId} ORDER BY id DESC LIMIT 10取下一页查询走主键索引不需要扫描偏移量。缺点是不能再跳页但车辆列表按时间倒序浏览用户一般只看前几页体验差异不大。在 CarQuery 里加一个 lastId 字段分页拦截器只对 page 模式的请求生效游标模式单独写一个方法即可。本文还有配套的精品资源点击获取