基于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 反而会让答辩时的职责划分变模糊，三层足够覆盖。

这套分层的意义在于答辩时被问“出车时车辆状态被其他人改成维修怎么办”，可以明确回答：状态检查在 Service 完成，并发冲突由更新语句的条件兜底。常见反面写法是把 status 判断写在 Controller 里，或者 Service 里先查出实体、改完再 update，前者让接口层承担了业务规则，后者在并发场景必然丢更新。车辆管理系统的业务逻辑没有复杂到需要防腐层，三层是性价比最高的选择。

2.3 用目录结构固定代码边界

包结构可以直接复用这一组：

com.example.fleet ├── controller ├── service │ └── impl ├── mapper ├── entity ├── dto ├── vo ├── config ├── common │ ├── result │ └── exception └── interceptor

dto 放请求入参，vo 放响应结果。很多毕设项目图省事，用 Map 接收查询条件，车牌号、状态、日期范围、分页参数全塞进一个 Map，前端传错字段名时编译期发现不了。把新增车辆请求和车辆列表查询拆成CreateCarRequest和CarQuery两个类，接口签名一眼能看懂，答辩画类图也更好整理。

pom.xml 的关键依赖如下：

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.18</version> <relativePath/> </parent> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> </dependency> <dependency> <groupId>io.jsonwebtoken</groupId> <artifactId>jjwt-api</artifactId> <version>0.11.5</version> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> </dependencies>

SpringBoot 父工程选 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) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 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) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 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) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='出车记录表';

这两张表故意没有加物理外键约束，只用普通索引。原因是物理外键每次插入都会检查父表存在性，批量导入出车记录时会拖慢写入；车辆删除是逻辑删除，驾驶员离职也是逻辑删除，物理外键对此无能为力。在论文里写成“逻辑外键加索引，在应用层保证引用完整性”，比硬加 FOREIGN KEY 更符合实际工程习惯，答辩时也更能说清楚取舍。外键对应的 car_id、driver_id 都要建索引，否则按车辆查历史出车记录时全表扫描。

出车记录里的里程字段用 INT 存公里数，是整数类型里性价比最高的选择。start_km 在出车时写入，end_km 在归还时更新，两张表通过 trip_record.car_id 关联，不用在车辆表里冗余一个当前里程。车辆当前里程可以后期用一条聚合 SQL 查最近一条出车记录的 end_km 得到，避免数据冗余。

3.3 状态机：可用、出车中、维修中、报废

车辆状态必须是一个有限状态机，不能靠前端传什么就存什么。状态定义如下：

状态变更要在 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 Result<String> login(@RequestBody LoginRequest req) { // 密码用 BCrypt 存储，这里只用 spring-security-crypto 里的工具类 User user = userMapper.selectOne( new LambdaQueryWrapper<User>() .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 Result<Page<CarVO>> page(CarQuery query, @RequestParam(defaultValue = "1") long page, @RequestParam(defaultValue = "10") long size) { Page<Car> p = new Page<>(page, size); LambdaQueryWrapper<Car> 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); Page<Car> result = carMapper.selectPage(p, wrapper); // 实体转 VO，隐藏逻辑删除字段 Page<CarVO> 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 LambdaUpdateWrapper<Car>() .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: 8

prefix = "fleet.jwt"表示读取 yml 里fleet.jwt前缀下的所有配置，字段名与配置项名自动绑定。与@Value("${fleet.jwt.secret}")相比，@ConfigurationProperties 适合一组配置的整体注入，类型安全，还支持数据校验；@Value 更适合零散的一两个配置项。毕设项目里只要 JWT 配置超过一个字段，就值得用@ConfigurationProperties。接口清单在论文的“系统功能设计”表里，一般按下面这个结构整理：

5. 毕业论文答辩前的工程化补齐：接口文档、安全收敛与版本兼容

5.1 SpringBoot 3 的 javax 到 jakarta 迁移

如果指导老师要求必须用 SpringBoot 3，启动前先确认三件事：JDK 必须是 17 及以上；所有依赖里的javax.servlet要换成jakarta.servlet；MyBatis-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 大偏移量分页的优化技巧

车辆数据量超过十万条后，page=10000 时 MyBatis-Plus 的 LIMIT 100000, 10 会扫描十万行再丢弃，速度明显变慢。毕业论文系统的数据量通常到不了这个量级，但答辩时讲出这个优化点是加分项。做法是列表页改用游标分页：前端传最后一条记录的 id，后端用WHERE id < #{lastId} ORDER BY id DESC LIMIT 10取下一页，查询走主键索引，不需要扫描偏移量。缺点是不能再跳页，但车辆列表按时间倒序浏览，用户一般只看前几页，体验差异不大。在 CarQuery 里加一个 lastId 字段，分页拦截器只对 page 模式的请求生效，游标模式单独写一个方法即可。

本文还有配套的精品资源，点击获取