1. 项目背景与核心价值这个车辆管理系统是我去年为一个中型物流公司做的内部管理平台。当时他们还在用Excel表格记录200多辆货车的调度、维修和年检信息经常出现数据丢失和版本混乱的问题。最夸张的一次因为司机看不到最新的年检到期提醒导致3辆货车被交管部门扣留直接损失了15万的运输合同。系统采用SpringBootVue的前后端分离架构实现了从车辆档案、司机管理到维修保养、违章记录的全生命周期管理。特别在数据可视化方面通过ECharts实现了车辆状态实时监控看板让调度主管能一眼看到哪些车可用、哪些在维修、哪些临近年检。提示这类管理系统最核心的价值不在于技术复杂度而在于如何通过合理的字段设计和状态流转把线下混乱的业务流程数字化。比如我们把年检提醒拆分成到期前30天到期前7天已超期三级预警直接降低了90%的逾期情况。2. 技术栈选型解析2.1 为什么选择SpringBootMyBatis组合后端选用SpringBoot 2.7 MyBatis-Plus主要基于三个考量快速响应需求变化物流行业政策调整频繁比如去年新增了冷链车辆消杀记录要求MyBatis的XML动态SQL比JPA的注解方式更灵活历史数据兼容客户原有部分数据在SQL Server中MyBatis的多数据源支持比JPA更友好性能优化空间针对车辆轨迹这种大数据量表可以直接手写优化SQL实测中发现一个有意思的现象使用MyBatis-Plus的LambdaQueryWrapper比原生MyBatis平均节省30%的代码量但在多表复杂查询时反而直接写XML更清晰。比如这个统计各车队维修成本的SQLselect idgetRepairCostByFleet resultTypemap SELECT f.fleet_name, SUM(r.cost) as total_cost FROM repair_records r JOIN vehicles v ON r.vehicle_id v.id JOIN fleets f ON v.fleet_id f.id WHERE r.repair_date BETWEEN #{startDate} AND #{endDate} GROUP BY f.id HAVING total_cost #{minCost} /select2.2 Vue前端的技术取舍前端用Vue3 Element Plus主要解决两个痛点表单复杂度高单个车辆新增表单包含78个字段通过动态表单组件实现步骤拆分权限粒度细不同角色看到不同的操作按钮如只有财务能看到成本分析特别推荐一个实用技巧用Vue的provide/inject实现跨层级组件通信。比如当在车辆列表页点击维修记录时维修模块需要知道当前选中车辆ID但两者隔着多层路由组件// 父组件提供数据 provide() { return { currentVehicleId: computed(() this.selectedVehicleId) } } // 孙子组件注入使用 inject: [currentVehicleId]3. 数据库设计关键点3.1 核心表结构设计车辆管理系统的数据库有12张核心表其中最复杂的是车辆状态变更记录表。最初设计时犯了个错误——把所有状态变更都放在一个json字段里导致无法做状态流转分析。后来拆分成这样CREATE TABLE vehicle_status_log ( id BIGINT PRIMARY KEY, vehicle_id BIGINT NOT NULL, old_status ENUM(IDLE,ON_ROUTE,MAINTENANCE,SCRAPPED), new_status ENUM(IDLE,ON_ROUTE,MAINTENANCE,SCRAPPED), change_reason VARCHAR(255), operator_id BIGINT, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (vehicle_id) REFERENCES vehicles(id), INDEX idx_vehicle (vehicle_id), INDEX idx_status_change (old_status, new_status) );这个设计带来了三个好处可以统计各状态的平均停留时间比如发现车辆平均维修周期是4.7天能追溯异常状态变更比如谁把报废车辆重新设为运营状态基于复合索引的查询性能提升5倍3.2 MySQL性能优化实践当车辆数据超过10万条时我们遇到了三个典型性能问题及解决方案模糊查询慢车牌号搜索LIKE %A123%用时3.2秒→ 解决方案增加倒排索引ALTER TABLE vehicles ADD FULLTEXT INDEX idx_plate_reverse (reverse_plate)统计报表超时月度运营报表计算超时→ 解决方案用物化视图提前计算CREATE MATERIALIZED VIEW mv_monthly_stats...并发更新冲突多个调度员同时抢单导致乐观锁重试→ 解决方案引入SELECT FOR UPDATE SKIP LOCKED4. 典型业务场景实现4.1 车辆维修流程状态机维修流程包含6个状态和11种转换规则我们用状态模式实现public interface RepairState { void startRepair(RepairContext context); void completeInspection(RepairContext context); // 其他动作... } Component Scope(prototype) public class WaitingInspectionState implements RepairState { Override public void completeInspection(RepairContext context) { if (context.getRepair().getInspectionResult() PASS) { context.setState(applicationContext.getBean(WaitingPartsState.class)); } else { context.setState(applicationContext.getBean(RejectedState.class)); } } }配合Spring的StateMachine框架最终实现了这样的转换配置states: - WAITING_INSPECTION - WAITING_PARTS - IN_REPAIR transitions: - source: WAITING_INSPECTION target: WAITING_PARTS event: INSPECTION_PASS4.2 基于规则引擎的年检提醒年检规则存在三个易变点不同车型年检周期不同货车1年客车6个月不同地区政策差异如京津冀要求额外环保检测临时政策调整如疫情期间延期我们采用Drools规则引擎实现动态配置rule TruckAnnualInspection when $v : Vehicle(type TRUCK, lastInspectionDate before[1y] today) then insert(new InspectionAlert($v, ANNUAL)); end管理员可以在后台直接修改规则文件实时生效无需重启服务。5. 踩坑与优化实录5.1 MyBatis分页缓存陷阱使用PageHelper分页时遇到一个隐蔽bug当连续执行两个不同条件的查询时第二个查询会错误地使用第一个查询的分页参数。原因是PageHelper的静态方法使用了ThreadLocal。解决方案有两种每次查询后手动清理PageHelper.clearPage()改用更安全的Lambda方式PageInfoVehicle page PageHelper.startPage(1, 10) .doSelectPageInfo(() - mapper.selectByExample(example));5.2 Vue表格内存泄漏在车辆列表页发现内存持续增长原因是每行使用了自定义组件组件内监听了window.resize事件切换页面时未正确销毁最终解决方案// 错误写法 - 会导致内存泄漏 mounted() { window.addEventListener(resize, this.handleResize) } // 正确写法 beforeUnmount() { window.removeEventListener(resize, this.handleResize) }6. 部署与监控方案6.1 基于Docker的部署架构生产环境采用多容器部署version: 3 services: app: image: openjdk:17-jdk volumes: - ./logs:/app/logs deploy: resources: limits: memory: 2g mysql: image: mysql:8.0 environment: MYSQL_MAX_CONNECTIONS: 200关键配置项MySQL连接池上限设为200根据压测结果JVM内存限制2GB避免容器OOM被杀日志卷映射到宿主机6.2 监控指标埋点通过Spring Boot Actuator暴露的指标中我们特别关注http.server.requests统计各API耗时jdbc.connections.active数据库连接池使用率cache.size本地缓存命中率配置Grafana看板时发现一个有用的小技巧对分页查询的耗时监控需要过滤掉page和size参数否则会产生大量时间序列http_server_requests_seconds_count{uri~/api/vehicles.*, uri!~.*[?](page|size).*}7. 源码结构与关键实现项目采用标准Maven多模块结构vehicle-system ├── vehicle-admin -- 后台管理模块 ├── vehicle-api -- REST接口模块 ├── vehicle-core -- 领域模型 └── vehicle-job -- 定时任务一个值得分享的设计在core模块中我们抽象出VehicleCommand和VehicleEvent两类对象实现CQRS模式public class VehicleCommand { private String plateNumber; private LocalDate purchaseDate; // 其他写操作字段 } public class VehicleEvent { private Long vehicleId; private EventType type; private String operator; // 其他读模型字段 }这样设计带来两个好处写模型可以保持精简只包含必要字段读模型可以自由扩展满足各种报表需求8. 扩展与演进方向目前系统已在三个物流公司稳定运行接下来计划接入ELK实现日志分析特别是对异常状态变更的审计用WebSocket实现调度指令的实时推送探索用TensorFlow预测车辆故障基于历史维修数据有个有趣的发现80%的车辆故障集中在20%的车型上这为我们做预防性维护提供了数据支持。比如某型号冷藏车的压缩机平均每8个月需要更换我们就在第7个月自动生成预防性维修工单。