简介《大型汽车4s店维修管理系统》是一套基于C#与.NET框架开发的完整项目资源包面向汽车4S店信息化管理人员、软件开发学习者以及毕业设计团队。系统覆盖维修服务、配件库存、客户关系与报表分析等核心业务包含车辆管理、维修进度跟踪、配件采购与库存监控、满意度调查等功能模块可用于支撑门店日常运营管理全流程。资源为rar压缩包大小约49.36MB适合直接在Windows环境下进行部署与代码研读目前已有479人浏览学习。资源包内的项目源码与数据库设计相互配套并通过数据字典对车型、故障类型、维修工时、配件库存等关键字段进行了详细定义便于理解表间关系与业务数据流同时清晰分层的功能模块和人性化界面布局也为学习C#桌面应用开发、ADO.NET数据库交互以及SQL Server数据库设计提供了直观范本。无论是用于课程设计、毕业设计参考还是实际4S店管理系统的二次开发这套资源都能提供完整、可复用的系统骨架与开发思路。1. 大型汽车4S店维修管理系统从接车到结算的数字化闭环一个服务顾问每天最头疼的事不是客户难缠而是工单、配件单、结算单散落在不同本子和Excel里。月底财务对不上账配件库存到底少没少全凭感觉。这套大型汽车4S店维修管理系统解决的正是从客户进店接车、车间派工、配件出库、完工质检到财务结算的完整闭环问题。它不像普通进销存那样只管配件流水而是把维修业务的主线全打通了——一个工单从创建到归档每一步都有迹可循适合4S店、综合维修厂做信息化改造也适合拿来学习一套典型的企业级Java Web项目是怎么组织的。2. 技术选型与总体架构前后端分离的Spring Boot单体应用2.1 技术栈与选型理由整套系统采用前后端分离的单体应用架构后端用Spring Boot 2.x搭建ORM层用MyBatis Plus数据库用的MySQL 5.7前端是Vue 2配合Element UI组件库权限控制用Spring Security加JWT Token。这种组合在4S店这类企业内部管理系统里非常常见原因很直接技术栈成熟、招人容易、部署简单。为什么选单体而不是微服务因为4S店维修业务虽然有工单、配件、客户、财务多个模块但实际并发量和数据规模远没到需要拆微服务的程度。一个门店几百个工单同时流转单体完全扛得住反而微服务带来的分布式事务、链路追踪问题会把小团队拖垮。这也是我拆完这套系统后最大的感受——架构选型要匹配业务复杂度这套系统在技术选型上没有为了炫技而过度设计。2.2 目录结构与分层职责项目结构上采用标准的Maven多模块或单模块分层核心目录如下4s-repair-system/ ├── src/main/java/com/repair/ │ ├── controller/ # REST接口层 │ ├── service/ # 业务逻辑层 │ │ └── impl/ # 业务实现 │ ├── mapper/ # MyBatis Plus数据访问层 │ ├── entity/ # 数据库实体映射 │ ├── dto/ # 前后端交互对象 │ ├── config/ # 配置类 │ ├── security/ # JWT认证与权限 │ └── common/ # 通用工具类、统一返回体 └── src/main/resources/ ├── mapper/ # XML SQL文件 ├── application.yml # 数据源配置 └── sql/ # 初始化脚本前端部分单独维护4s-repair-web/ ├── src/ │ ├── api/ # 接口请求封装 │ ├── views/ # 页面组件 │ │ ├── workorder/ # 工单管理页面 │ │ ├── parts/ # 配件库存页面 │ │ └── finance/ # 财务结算页面 │ ├── router/ # 前端路由 │ ├── store/ # Vuex状态管理 │ └── utils/ # 请求拦截器这种分层的设计逻辑很清晰Controller只负责参数接收和返回封装不写业务Service里写入库逻辑和事务控制Mapper只做数据查询。我见过不少管理项目在Controller里直接写SQL的那基本就是在给后续维护埋雷。这套系统在分层约束上做得比较规范二次开发时改一个业务点基本能定位到对应层不需要翻完整个项目才能动手。3. 核心模块拆解维修工单从进入到归档的完整链路3.1 接车登记与工单创建的数据流客户把车开进车间服务顾问登记车辆信息、客户诉求和故障描述系统生成一张维修工单。工单号按日期加流水号生成同时创建客户的维修档案。后端工单创建模块核心代码如下PostMapping(/workorder) public Result createWorkOrder(RequestBody Valid WorkOrderCreateDTO dto) { // 生成工单号日期当日流水号如 WO20240510001 String workOrderNo WorkOrderNoGenerator.generate(dto.getStoreId()); WorkOrder order new WorkOrder(); // DTO转实体这里用Spring BeanUtils做属性拷贝 BeanUtils.copyProperties(dto, order); order.setOrderNo(workOrderNo); order.setOrderStatus(OrderStatusEnum.PENDING_CONFIRM.getValue()); // 从JWT上下文拿到当前用户ID记录开单人 Long userId SecurityUtils.getCurrentUserId(); order.setCreatedBy(userId); // 保存工单主表 workOrderMapper.insert(order); // 同时生成一条初始流转记录便于日后追踪操作日志 WorkOrderTrace trace new WorkOrderTrace(); trace.setOrderId(order.getId()); trace.setAction(CREATE); trace.setOperatorId(userId); trace.setRemark(服务顾问创建工单); workOrderTraceMapper.insert(trace); return Result.success(workOrderNo); }这段代码里最关键的是工单状态和流转记录。OrderStatusEnum.PENDING_CONFIRM定义了工单的第一步状态之后每一次状态变更都会插入一条WorkOrderTrace记录。这样做的好处是出了问题可以回溯整个工单生命周期——几点接车、几点派工、几点完工都清清楚楚4S店处理客诉时这类操作留痕至关重要。这里的参数说明WorkOrderCreateDTO包含车牌号、客户ID、车型、故障描述、预约时间等字段校验注解会保证车架号和手机号格式正确generate方法内部通过Redis计数当天流水号避免高并发下工单号重复。3.2 车间派工与进度状态机工单确认后车间主管根据当前的维修技师排班和技能标签进行派工。系统用状态机管理工单的流转待确认、已派工、维修中、待质检、已完工、已结算、已归档。每个状态之间的跳转都有权限校验比如只有车间主管角色才能执行派工操作PreAuthorize(hasRole(WORKSHOP_MANAGER)) PostMapping(/workorder/{orderNo}/dispatch) public Result dispatchWorkOrder(PathVariable String orderNo, RequestBody DispatchDTO dto) { // 乐观锁防并发只有状态为PENDING_CONFIRM时才能更新为已派工 LambdaUpdateWrapperWorkOrder wrapper new LambdaUpdateWrapper(); wrapper.eq(WorkOrder::getOrderNo, orderNo) .eq(WorkOrder::getOrderStatus, OrderStatusEnum.PENDING_CONFIRM.getValue()); WorkOrder update new WorkOrder(); update.setOrderStatus(OrderStatusEnum.DISPATCHED.getValue()); update.setTechnicianId(dto.getTechnicianId()); update.setDispatchTime(LocalDateTime.now()); // 影响行数为0说明状态已被其他操作改变直接报错提醒刷新 int rows workOrderMapper.update(update, wrapper); if (rows 0) { throw new BizException(工单状态已发生变化请刷新后重试); } return Result.success(); }这个场景里最常见的问题是多人同时操作同一张工单导致状态覆盖。解决方法就是上面代码里的乐观锁策略——用状态字段作为更新条件如果执行SQL影响行数为0说明这张单子在你操作之前已经被别人改过了不再强行覆盖而是提示前端刷新重新确认。这种做法虽然牺牲了一点并发度但换来了数据一致性。派工之后维修技师在自己的待办列表看到任务点击开工时再次走类似的更新逻辑把状态从已派工改成维修中同时记录start_time用于核算工时。每完成一个维修项目技师可以标记单项完成全部完成后再推到质检环节。3.3 配件出库与库存扣减的一致性问题维修过程中使用配件这是最容易出问题的环节。很多管理系统的翻车现场都在这里出库单创建成功但库存没扣或者扣了库存但没留出库记录月底盘点对不上。这套系统的做法是用Spring的Transactional保证出库记录和库存扣减在同一事务里完成Transactional(rollbackFor Exception.class) public void partOutbound(PartOutboundDTO dto) { // 1. 校验工单是否处于维修中状态 WorkOrder order workOrderMapper.selectByOrderNo(dto.getOrderNo()); if (order null || !OrderStatusEnum.REPAIRING.getValue() .equals(order.getOrderStatus())) { throw new BizException(工单状态异常不允许出库); } // 2. 逐条扣减配件库存 for (PartItemDTO item : dto.getItems()) { // 这里的扣减SQL带了库存数量条件避免超卖 int rows partsStockMapper.deductStock( item.getPartId(), item.getQuantity()); if (rows 0) { throw new BizException(配件 item.getPartName() 库存不足); } } // 3. 写流出库明细表记录操作人和用途 PartOutboundLog log new PartOutboundLog(); log.setOrderNo(dto.getOrderNo()); log.setOperatorId(SecurityUtils.getCurrentUserId()); log.setOutboundTime(LocalDateTime.now()); partOutboundLogMapper.insert(log); }对应的扣减SQL写在XML里UPDATE parts_stock SET stock_quantity stock_quantity - #{quantity} WHERE part_id #{partId} AND stock_quantity #{quantity}这个SQL做了条件扣减加了AND stock_quantity #{quantity}的判断数据库层面保证了不会出现负库存。三层保障——事务控制、条件更新、出库日志——缺一不可。我在实际项目里见过只加了Transactional却没写条件判断的结果并发请求直接把库存扣成负数所以这个细节比事务本身更值得注意。4. 部署与避坑从本地跑通到上线常见的五个坑4.1 本地环境搭建与启动步骤代码拿到手先在本地跑起来才不会越改越乱。这套系统需要准备的环境是JDK 1.8、Maven 3.6以上、Node.js 14以上、MySQL 5.7。数据库初始化直接用项目里附带的sql/init.sql脚本里面包含了建库语句、基础表结构和默认管理员账号数据。后端启动步骤如下# 1. 创建数据库并导入初始化脚本 mysql -u root -p src/main/resources/sql/init.sql # 2. 修改application.yml里的数据源配置 # url: jdbc:mysql://localhost:3306/4s_repair?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai # 3. 启动后端服务 mvn spring-boot:run前端启动cd 4s-repair-web npm install npm run dev启动完成后浏览器访问localhost:8080默认管理员账号密码在初始化脚本里写好了。值得注意的是serverTimezoneAsia/Shanghai这个配置MySQL 5.7和Java 8的时区问题极其常见少了这个参数后端和数据库的时间字段会差8个小时工单创建时间和实际时间对不上排查起来非常折磨人。4.2 常见问题与踩坑记录第一坑端口被占用。Spring Boot默认端口8080如果本机有别的服务占了端口后端启动会直接报Port already in use。解决办法是在application.yml里改server.port或者用netstat -ano | findstr 8080找出占用进程干掉。我习惯于把开发环境的端口改成8081避免和本地其他项目冲突。第二坑IDEA里运行后端报Invalid bound statement。这个问题的原因通常是MyBatis的XML文件没有被Maven打包进target/classes目录。解决方式是检查pom.xml里有没有配置resources把src/main/resources下的XML文件包含进去或者确认application.yml里mapper-locations路径是否写对了。第三坑前端请求接口报跨域错误。虽然开发环境用了Vue的proxy代理但如果直接拿IP访问或者端口不一致就会触发浏览器的跨域拦截。这套系统后端有CORS过滤器只要把允许的origin配置成你的前端地址就行。第四坑Redis没启动导致登录接口超时。工单号生成用到了Redis计数如果本地没有启动Redis登录会成功但创建工单时generate方法会抛RedisConnectionFailureException。搭建第一步就把Redis装好并且设成开机自启能省不少事。第五坑导入数据库脚本后出现中文字符乱码。原因一般是MySQL命令行客户端默认字符集不对导入前先执行set names utf8mb4;或者在导入命令里加--default-character-setutf8mb4。这个不处理好后面查数据全是问号修数据可比导数据麻烦多了。5. 二次开发实战把单店版改造成多门店架构拿到这套系统后最常见的改造需求就是把只支持一个门店的模式扩展成集团多门店版本。核心改动集中在三个方面数据隔离、权限模型、业务编号。数据隔离的常见做法是给核心表增加store_id字段然后在MyBatis的SQL中统一拼接门店条件。我不会直接去改每个Mapper的方法签名而是实现一个DataScopeInterceptor拦截器自动在查询SQL上附加AND store_id 当前用户门店Override public void intercept(Invocation invocation) throws Throwable { // 通过JWT上下文拿到当前用户的门店ID Long storeId SecurityUtils.getCurrentStoreId(); MappedStatement ms (MappedStatement) invocation.getArgs()[0]; // 只对工单、配件等核心表做数据隔离 // SQL拼接在原有SQL后面追加 store_id #{storeId} BoundSql boundSql ms.getBoundSql(parameter); String newSql boundSql.getSql() AND store_id storeId; // 重新构造BoundSql并替换 }数据权限的粒度可以按角色区分总部角色不过滤门店能看全集团数据门店角色只能看到自己门店的数据。这种拦截器方案比在每一条Service代码里手动传storeId要优雅得多缺点是排查问题时SQL不如手写的好读需要在日志里打印完整SQL方便调试。业务编号的改造相对简单把工单号和出库单号统一加上门店前缀例如BJ002-WO20240510001其中BJ002是门店编码。改完这个注意检查报表统计模块因为门店维度的业绩汇总就是靠编号前缀来拆分的。改造完的验证方法是准备两个门店账号分别创建工单确认互相看不到对方数据再用总部账号看汇总报表是否包含全部工单。如果这两个场景都过了基本可以放心上线。5.1 从一次上线事故总结的教训上次我帮一位服务顾问朋友做门店独立核算改造时只改了工单主表的数据权限漏掉了配件出入库明细表。结果上线第二天发现A门店的技师居然在B门店的工单里领了配件查了半天才发现是配件的Mapper没走拦截器。从那以后我每做一个数据敏感型的功能改造都会强制走一遍跨门店验证清单建两个测试账号、分别操作一条核心业务数据、再交叉查询确认隔离生效。这套系统虽然已经把主流程做得很完整但数据权限这类问题永远是改业务时最容易翻车的地方希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/17 9:18:07 · 阅读 1.2k 基于Spring Boot的4S店维修管理系统：从接车到结算的数字化闭环
简介《大型汽车4s店维修管理系统》是一套基于C#与.NET框架开发的完整项目资源包面向汽车4S店信息化管理人员、软件开发学习者以及毕业设计团队。系统覆盖维修服务、配件库存、客户关系与报表分析等核心业务包含车辆管理、维修进度跟踪、配件采购与库存监控、满意度调查等功能模块可用于支撑门店日常运营管理全流程。资源为rar压缩包大小约49.36MB适合直接在Windows环境下进行部署与代码研读目前已有479人浏览学习。资源包内的项目源码与数据库设计相互配套并通过数据字典对车型、故障类型、维修工时、配件库存等关键字段进行了详细定义便于理解表间关系与业务数据流同时清晰分层的功能模块和人性化界面布局也为学习C#桌面应用开发、ADO.NET数据库交互以及SQL Server数据库设计提供了直观范本。无论是用于课程设计、毕业设计参考还是实际4S店管理系统的二次开发这套资源都能提供完整、可复用的系统骨架与开发思路。1. 大型汽车4S店维修管理系统从接车到结算的数字化闭环一个服务顾问每天最头疼的事不是客户难缠而是工单、配件单、结算单散落在不同本子和Excel里。月底财务对不上账配件库存到底少没少全凭感觉。这套大型汽车4S店维修管理系统解决的正是从客户进店接车、车间派工、配件出库、完工质检到财务结算的完整闭环问题。它不像普通进销存那样只管配件流水而是把维修业务的主线全打通了——一个工单从创建到归档每一步都有迹可循适合4S店、综合维修厂做信息化改造也适合拿来学习一套典型的企业级Java Web项目是怎么组织的。2. 技术选型与总体架构前后端分离的Spring Boot单体应用2.1 技术栈与选型理由整套系统采用前后端分离的单体应用架构后端用Spring Boot 2.x搭建ORM层用MyBatis Plus数据库用的MySQL 5.7前端是Vue 2配合Element UI组件库权限控制用Spring Security加JWT Token。这种组合在4S店这类企业内部管理系统里非常常见原因很直接技术栈成熟、招人容易、部署简单。为什么选单体而不是微服务因为4S店维修业务虽然有工单、配件、客户、财务多个模块但实际并发量和数据规模远没到需要拆微服务的程度。一个门店几百个工单同时流转单体完全扛得住反而微服务带来的分布式事务、链路追踪问题会把小团队拖垮。这也是我拆完这套系统后最大的感受——架构选型要匹配业务复杂度这套系统在技术选型上没有为了炫技而过度设计。2.2 目录结构与分层职责项目结构上采用标准的Maven多模块或单模块分层核心目录如下4s-repair-system/ ├── src/main/java/com/repair/ │ ├── controller/ # REST接口层 │ ├── service/ # 业务逻辑层 │ │ └── impl/ # 业务实现 │ ├── mapper/ # MyBatis Plus数据访问层 │ ├── entity/ # 数据库实体映射 │ ├── dto/ # 前后端交互对象 │ ├── config/ # 配置类 │ ├── security/ # JWT认证与权限 │ └── common/ # 通用工具类、统一返回体 └── src/main/resources/ ├── mapper/ # XML SQL文件 ├── application.yml # 数据源配置 └── sql/ # 初始化脚本前端部分单独维护4s-repair-web/ ├── src/ │ ├── api/ # 接口请求封装 │ ├── views/ # 页面组件 │ │ ├── workorder/ # 工单管理页面 │ │ ├── parts/ # 配件库存页面 │ │ └── finance/ # 财务结算页面 │ ├── router/ # 前端路由 │ ├── store/ # Vuex状态管理 │ └── utils/ # 请求拦截器这种分层的设计逻辑很清晰Controller只负责参数接收和返回封装不写业务Service里写入库逻辑和事务控制Mapper只做数据查询。我见过不少管理项目在Controller里直接写SQL的那基本就是在给后续维护埋雷。这套系统在分层约束上做得比较规范二次开发时改一个业务点基本能定位到对应层不需要翻完整个项目才能动手。3. 核心模块拆解维修工单从进入到归档的完整链路3.1 接车登记与工单创建的数据流客户把车开进车间服务顾问登记车辆信息、客户诉求和故障描述系统生成一张维修工单。工单号按日期加流水号生成同时创建客户的维修档案。后端工单创建模块核心代码如下PostMapping(/workorder) public Result createWorkOrder(RequestBody Valid WorkOrderCreateDTO dto) { // 生成工单号日期当日流水号如 WO20240510001 String workOrderNo WorkOrderNoGenerator.generate(dto.getStoreId()); WorkOrder order new WorkOrder(); // DTO转实体这里用Spring BeanUtils做属性拷贝 BeanUtils.copyProperties(dto, order); order.setOrderNo(workOrderNo); order.setOrderStatus(OrderStatusEnum.PENDING_CONFIRM.getValue()); // 从JWT上下文拿到当前用户ID记录开单人 Long userId SecurityUtils.getCurrentUserId(); order.setCreatedBy(userId); // 保存工单主表 workOrderMapper.insert(order); // 同时生成一条初始流转记录便于日后追踪操作日志 WorkOrderTrace trace new WorkOrderTrace(); trace.setOrderId(order.getId()); trace.setAction(CREATE); trace.setOperatorId(userId); trace.setRemark(服务顾问创建工单); workOrderTraceMapper.insert(trace); return Result.success(workOrderNo); }这段代码里最关键的是工单状态和流转记录。OrderStatusEnum.PENDING_CONFIRM定义了工单的第一步状态之后每一次状态变更都会插入一条WorkOrderTrace记录。这样做的好处是出了问题可以回溯整个工单生命周期——几点接车、几点派工、几点完工都清清楚楚4S店处理客诉时这类操作留痕至关重要。这里的参数说明WorkOrderCreateDTO包含车牌号、客户ID、车型、故障描述、预约时间等字段校验注解会保证车架号和手机号格式正确generate方法内部通过Redis计数当天流水号避免高并发下工单号重复。3.2 车间派工与进度状态机工单确认后车间主管根据当前的维修技师排班和技能标签进行派工。系统用状态机管理工单的流转待确认、已派工、维修中、待质检、已完工、已结算、已归档。每个状态之间的跳转都有权限校验比如只有车间主管角色才能执行派工操作PreAuthorize(hasRole(WORKSHOP_MANAGER)) PostMapping(/workorder/{orderNo}/dispatch) public Result dispatchWorkOrder(PathVariable String orderNo, RequestBody DispatchDTO dto) { // 乐观锁防并发只有状态为PENDING_CONFIRM时才能更新为已派工 LambdaUpdateWrapperWorkOrder wrapper new LambdaUpdateWrapper(); wrapper.eq(WorkOrder::getOrderNo, orderNo) .eq(WorkOrder::getOrderStatus, OrderStatusEnum.PENDING_CONFIRM.getValue()); WorkOrder update new WorkOrder(); update.setOrderStatus(OrderStatusEnum.DISPATCHED.getValue()); update.setTechnicianId(dto.getTechnicianId()); update.setDispatchTime(LocalDateTime.now()); // 影响行数为0说明状态已被其他操作改变直接报错提醒刷新 int rows workOrderMapper.update(update, wrapper); if (rows 0) { throw new BizException(工单状态已发生变化请刷新后重试); } return Result.success(); }这个场景里最常见的问题是多人同时操作同一张工单导致状态覆盖。解决方法就是上面代码里的乐观锁策略——用状态字段作为更新条件如果执行SQL影响行数为0说明这张单子在你操作之前已经被别人改过了不再强行覆盖而是提示前端刷新重新确认。这种做法虽然牺牲了一点并发度但换来了数据一致性。派工之后维修技师在自己的待办列表看到任务点击开工时再次走类似的更新逻辑把状态从已派工改成维修中同时记录start_time用于核算工时。每完成一个维修项目技师可以标记单项完成全部完成后再推到质检环节。3.3 配件出库与库存扣减的一致性问题维修过程中使用配件这是最容易出问题的环节。很多管理系统的翻车现场都在这里出库单创建成功但库存没扣或者扣了库存但没留出库记录月底盘点对不上。这套系统的做法是用Spring的Transactional保证出库记录和库存扣减在同一事务里完成Transactional(rollbackFor Exception.class) public void partOutbound(PartOutboundDTO dto) { // 1. 校验工单是否处于维修中状态 WorkOrder order workOrderMapper.selectByOrderNo(dto.getOrderNo()); if (order null || !OrderStatusEnum.REPAIRING.getValue() .equals(order.getOrderStatus())) { throw new BizException(工单状态异常不允许出库); } // 2. 逐条扣减配件库存 for (PartItemDTO item : dto.getItems()) { // 这里的扣减SQL带了库存数量条件避免超卖 int rows partsStockMapper.deductStock( item.getPartId(), item.getQuantity()); if (rows 0) { throw new BizException(配件 item.getPartName() 库存不足); } } // 3. 写流出库明细表记录操作人和用途 PartOutboundLog log new PartOutboundLog(); log.setOrderNo(dto.getOrderNo()); log.setOperatorId(SecurityUtils.getCurrentUserId()); log.setOutboundTime(LocalDateTime.now()); partOutboundLogMapper.insert(log); }对应的扣减SQL写在XML里UPDATE parts_stock SET stock_quantity stock_quantity - #{quantity} WHERE part_id #{partId} AND stock_quantity #{quantity}这个SQL做了条件扣减加了AND stock_quantity #{quantity}的判断数据库层面保证了不会出现负库存。三层保障——事务控制、条件更新、出库日志——缺一不可。我在实际项目里见过只加了Transactional却没写条件判断的结果并发请求直接把库存扣成负数所以这个细节比事务本身更值得注意。4. 部署与避坑从本地跑通到上线常见的五个坑4.1 本地环境搭建与启动步骤代码拿到手先在本地跑起来才不会越改越乱。这套系统需要准备的环境是JDK 1.8、Maven 3.6以上、Node.js 14以上、MySQL 5.7。数据库初始化直接用项目里附带的sql/init.sql脚本里面包含了建库语句、基础表结构和默认管理员账号数据。后端启动步骤如下# 1. 创建数据库并导入初始化脚本 mysql -u root -p src/main/resources/sql/init.sql # 2. 修改application.yml里的数据源配置 # url: jdbc:mysql://localhost:3306/4s_repair?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai # 3. 启动后端服务 mvn spring-boot:run前端启动cd 4s-repair-web npm install npm run dev启动完成后浏览器访问localhost:8080默认管理员账号密码在初始化脚本里写好了。值得注意的是serverTimezoneAsia/Shanghai这个配置MySQL 5.7和Java 8的时区问题极其常见少了这个参数后端和数据库的时间字段会差8个小时工单创建时间和实际时间对不上排查起来非常折磨人。4.2 常见问题与踩坑记录第一坑端口被占用。Spring Boot默认端口8080如果本机有别的服务占了端口后端启动会直接报Port already in use。解决办法是在application.yml里改server.port或者用netstat -ano | findstr 8080找出占用进程干掉。我习惯于把开发环境的端口改成8081避免和本地其他项目冲突。第二坑IDEA里运行后端报Invalid bound statement。这个问题的原因通常是MyBatis的XML文件没有被Maven打包进target/classes目录。解决方式是检查pom.xml里有没有配置resources把src/main/resources下的XML文件包含进去或者确认application.yml里mapper-locations路径是否写对了。第三坑前端请求接口报跨域错误。虽然开发环境用了Vue的proxy代理但如果直接拿IP访问或者端口不一致就会触发浏览器的跨域拦截。这套系统后端有CORS过滤器只要把允许的origin配置成你的前端地址就行。第四坑Redis没启动导致登录接口超时。工单号生成用到了Redis计数如果本地没有启动Redis登录会成功但创建工单时generate方法会抛RedisConnectionFailureException。搭建第一步就把Redis装好并且设成开机自启能省不少事。第五坑导入数据库脚本后出现中文字符乱码。原因一般是MySQL命令行客户端默认字符集不对导入前先执行set names utf8mb4;或者在导入命令里加--default-character-setutf8mb4。这个不处理好后面查数据全是问号修数据可比导数据麻烦多了。5. 二次开发实战把单店版改造成多门店架构拿到这套系统后最常见的改造需求就是把只支持一个门店的模式扩展成集团多门店版本。核心改动集中在三个方面数据隔离、权限模型、业务编号。数据隔离的常见做法是给核心表增加store_id字段然后在MyBatis的SQL中统一拼接门店条件。我不会直接去改每个Mapper的方法签名而是实现一个DataScopeInterceptor拦截器自动在查询SQL上附加AND store_id 当前用户门店Override public void intercept(Invocation invocation) throws Throwable { // 通过JWT上下文拿到当前用户的门店ID Long storeId SecurityUtils.getCurrentStoreId(); MappedStatement ms (MappedStatement) invocation.getArgs()[0]; // 只对工单、配件等核心表做数据隔离 // SQL拼接在原有SQL后面追加 store_id #{storeId} BoundSql boundSql ms.getBoundSql(parameter); String newSql boundSql.getSql() AND store_id storeId; // 重新构造BoundSql并替换 }数据权限的粒度可以按角色区分总部角色不过滤门店能看全集团数据门店角色只能看到自己门店的数据。这种拦截器方案比在每一条Service代码里手动传storeId要优雅得多缺点是排查问题时SQL不如手写的好读需要在日志里打印完整SQL方便调试。业务编号的改造相对简单把工单号和出库单号统一加上门店前缀例如BJ002-WO20240510001其中BJ002是门店编码。改完这个注意检查报表统计模块因为门店维度的业绩汇总就是靠编号前缀来拆分的。改造完的验证方法是准备两个门店账号分别创建工单确认互相看不到对方数据再用总部账号看汇总报表是否包含全部工单。如果这两个场景都过了基本可以放心上线。5.1 从一次上线事故总结的教训上次我帮一位服务顾问朋友做门店独立核算改造时只改了工单主表的数据权限漏掉了配件出入库明细表。结果上线第二天发现A门店的技师居然在B门店的工单里领了配件查了半天才发现是配件的Mapper没走拦截器。从那以后我每做一个数据敏感型的功能改造都会强制走一遍跨门店验证清单建两个测试账号、分别操作一条核心业务数据、再交叉查询确认隔离生效。这套系统虽然已经把主流程做得很完整但数据权限这类问题永远是改业务时最容易翻车的地方希望帮到你。本文还有配套的精品资源点击获取