简介这是一份基于SpringBoot的家政服务管理平台Java毕业设计源码适合正在做前后端分离Web项目、需要学习企业级业务系统搭建的开发者。项目覆盖用户注册登录、服务预约、订单处理、工人管理、数据统计等典型模块代码按MVC模式组织包含前端Vue页面、Java后端、SQL脚本、Maven配置及部署脚本便于直接运行和二次开发。资源包共874个文件以java、vue、js、css、html为主辅以xml、yml、sql、png、svg等配置、样式与图片资源整体大小16.66MB结构较完整可对照学习权限认证、接口设计、订单状态流转等实现思路。目前已有108人学习浏览适合用于毕业设计参考、SpringBoot项目实践或作为个人作品集素材能帮助少走弯路、快速理解整体工程脉络。1. 从 zip 到手把手跑通Spring Boot 家政平台源码的正确打开方式拿到一份命名为“基于springboot的家政服务管理平台源码.zip”的压缩包第一反应往往是解压、导入 IDE、点运行。但做过几个类似项目的人都知道这条路径在“导入”和“运行”之间至少卡着三个坎Maven 依赖下载超时、数据库初始化脚本缺失、前端与后端端口衔接不上。这类家政服务管理平台是 Java 后端面试题和毕业设计里的高频命题核心场景无非是用户下单、服务人员接单、管理员审核结算技术栈基本锁定 Spring Boot MyBatis/MyBatis-Plus MySQL部分版本会带上 Vue 或 Thymeleaf 做前端渲染。这篇文章不评价任何具体源码包的优劣而是顺着这个标题把一套能落地的方案完整摊开源码解压后怎么确认结构、数据库表怎么设计、订单状态机怎么流转、哪些参数是必须调的以及运行起来后最先炸的 5 个坑。文中所有命令和代码都基于 Spring Boot 2.7.x 与 MySQL 5.7/8.0这是该类源码最常见的基线版本如果你的压缩包里是 Spring Boot 3.x注意 javax 到 jakarta 的命名空间变动即可。2. 源码结构梳理与最小启动路径一份家政服务管理平台的源码解压后先别急着双击 pom.xml。先用命令行把顶层结构看一遍判断它是单体应用还是前后端分离这决定了你要不要装 Node.js 和额外启动一个前端服务。2.1 解压后的标准目录结构常见的单体工程布局如下覆盖了controller、service、mapper三层外加config和entity/domain包unzip household-service-platform.zip cd household-service-platform find . -maxdepth 3 -type d | sort你一般会看到这样的输出src/main/java/com/example/housekeeping/ ├── controller ├── service │ └── impl ├── mapper ├── entity ├── dto ├── config └── common src/main/resources/ ├── application.yml ├── mapper/ # MyBatis XML 文件 └── sql/ └── housekeeping.sql说三个要点。第一sql/目录决定了这个项目能不能直接跑起来如果压缩包里没有初始化脚本你要么找说明文档要么根据实体类反推建表语句第二mapper目录下如果既有 Java 接口又有 XML说明走的是 MyBatis你需要在application.yml里配置mapper-locations第三common包里通常放着统一返回体、异常处理和工具类这是判断代码规范程度的第一现场先看Result或R这个类后续所有接口返回格式都从这里来。2.2 数据库初始化与账号密码修改拿到 SQL 脚本后按顺序执行mysql -u root -p -e CREATE DATABASE household_service DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p household_service src/main/resources/sql/housekeeping.sql这里用utf8mb4而不是utf8因为订单备注和用户评价里会出现表情符号utf8在 MySQL 5.7 下存emoji会直接报错。执行完脚本后检查三张核心表是否有初始数据SELECT COUNT(*) FROM sys_user; SELECT COUNT(*) FROM service_item; SELECT COUNT(*) FROM order_info;如果sys_user里没有任何记录说明脚本没有预置管理员账号你需要手动插入一条。这类平台的管理员密码一般都是 MD5 或 BCrypt 加密后入库的推荐用 Spring Boot 自带的安全工具类生成import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; public class PasswordGenerator { public static void main(String[] args) { BCryptPasswordEncoder encoder new BCryptPasswordEncoder(); System.out.println(encoder.encode(admin123)); } }把输出的密文写进sys_user表用户名设为admin角色设为1就可以准备启动应用了。关于加密方式BCrypt是首选因为同一明文每次生成的密文都不同自带盐值如果你的源码里校验逻辑写着MD5(password)那就在 SQL 里直接填入md5(admin123)的结果。2.3 application.yml 里必须改的三个配置项server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/household_service?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.housekeeping.entity logging: level: com.example.housekeeping.mapper: debug三个必改项依次是数据库密码、serverTimezone时区、MyBatis 的 mapper 扫描路径。时区不设置成Asia/Shanghai在 JDBC 8.x 驱动下会报空指针或时间偏差 8 小时日志级别开到 debug 是为了启动后能看到每条 SQL 的入参和出参排查问题时不用重新打包。如果你的源码里用的是application.properties对应写法是mybatis.mapper-locationsclasspath:mapper/*.xml mybatis.type-aliases-packagecom.example.housekeeping.entity启动命令也一并给出Maven 仓库缺依赖时用阿里云镜像加速mvn clean package -DskipTests -s /path/to/custom-settings.xml java -jar target/housekeeping-0.0.1-SNAPSHOT.jar提示-DskipTests跳过测试执行但仍然编译测试代码-Dmaven.test.skiptrue连测试代码都不编译。家用环境建议用前者因为后者的语义有时候在 CI 上会有歧义。3. 核心表设计与订单状态流转家政服务管理平台的关键不在前端页面多华丽而在订单生命周期能不能闭环。从用户提交预约到服务完成、结算、评价、售后每一步都对应着数据库表里的状态字段变化。这一章把表关系、状态枚举和状态机校验说透。3.1 五张核心表的关系与字段说明家政平台最少需要五张表sys_user用户/家政人员/管理员三合一、service_item服务项目、order_info订单主表、order_schedule服务排期/上门时间、review评价表。其中sys_user用role字段区分身份1为管理员2为注册用户3为家政服务人员。order_info表是最容易设计出问题的。字段上除了常规的id、user_id、service_item_id至少要包含以下列CREATE TABLE order_info ( id BIGINT AUTO_INCREMENT PRIMARY KEY, order_no VARCHAR(32) NOT NULL COMMENT 订单编号, user_id BIGINT NOT NULL COMMENT 下单用户ID, worker_id BIGINT DEFAULT NULL COMMENT 接单家政人员ID, service_item_id BIGINT NOT NULL COMMENT 服务项目ID, address VARCHAR(255) NOT NULL COMMENT 服务地址, service_time DATETIME NOT NULL COMMENT 期望服务时间, status TINYINT NOT NULL DEFAULT 0 COMMENT 状态: 0待支付 1待接单 2已接单 3服务中 4待验收 5已完成 6已取消 7退款中, amount DECIMAL(10,2) NOT NULL COMMENT 订单金额, pay_time DATETIME DEFAULT NULL COMMENT 支付时间, finish_time DATETIME DEFAULT NULL COMMENT 完成时间, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_order_no (order_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;说三个设计要点。第一order_no必须唯一且有业务含义常见做法是yyyyMMddHHmmss 用户ID 随机三位数不要用自增 ID 直接当订单号暴露给前端第二worker_id允许为空因为下单时还没有人接单第三amount用DECIMAL(10,2)禁止使用FLOAT和DOUBLE否则累计金额会出现精度漂移。余额结算时如果涉及分账金额单位统一为分数据库用BIGINT存储展示层再除以 100。3.2 订单状态机的正向流转与反向撤销状态机用枚举类定义重写fromCode方法做边界校验public enum OrderStatus { PENDING_PAYMENT(0, 待支付), PENDING_ACCEPT(1, 待接单), ACCEPTED(2, 已接单), IN_SERVICE(3, 服务中), PENDING_VERIFY(4, 待验收), COMPLETED(5, 已完成), CANCELED(6, 已取消), REFUNDING(7, 退款中); private final int code; private final String desc; OrderStatus(int code, String desc) { this.code code; this.desc desc; } public int getCode() { return code; } public static OrderStatus fromCode(int code) { for (OrderStatus status : OrderStatus.values()) { if (status.code code) { return status; } } throw new IllegalArgumentException(未知订单状态: code); } }状态流转不能只靠 if-else推荐用一个Map来定义合法转移路径后续加状态只用改这个映射不用动业务逻辑代码Component public class OrderStateMachine { private static final MapOrderStatus, ListOrderStatus TRANSITIONS new HashMap(); static { TRANSITIONS.put(OrderStatus.PENDING_PAYMENT, Arrays.asList(OrderStatus.PENDING_ACCEPT, OrderStatus.CANCELED)); TRANSITIONS.put(OrderStatus.PENDING_ACCEPT, Arrays.asList(OrderStatus.ACCEPTED, OrderStatus.CANCELED)); TRANSITIONS.put(OrderStatus.ACCEPTED, Arrays.asList(OrderStatus.IN_SERVICE, OrderStatus.CANCELED)); TRANSITIONS.put(OrderStatus.IN_SERVICE, Arrays.asList(OrderStatus.PENDING_VERIFY)); TRANSITIONS.put(OrderStatus.PENDING_VERIFY, Arrays.asList(OrderStatus.COMPLETED, OrderStatus.REFUNDING)); TRANSITIONS.put(OrderStatus.REFUNDING, Arrays.asList(OrderStatus.CANCELED, OrderStatus.COMPLETED)); } public boolean canTransit(OrderStatus current, OrderStatus target) { ListOrderStatus allowed TRANSITIONS.get(current); return allowed ! null allowed.contains(target); } }这里有个关键点状态更新 SQL 必须带条件WHERE status ?这是并发场景下防止重复操作的关键。如果用户和管理员同时操作同一条订单记录不带条件就会把状态写脏。正确写法Update(UPDATE order_info SET status #{newStatus}, update_time NOW() WHERE id #{orderId} AND status #{oldStatus}) int updateStatusWithLock(Long orderId, int oldStatus, int newStatus);返回值int如果为 0表示状态已被人改过直接抛异常提示“操作过于频繁请刷新后重试”。3.3 接单场景的乐观锁处理家政人员点击“接单”时会在order_info上做一次条件更新。接单动作要保证同一个订单只能被一个家政人员抢到。做法就是上面的updateStatusWithLock把oldStatus传PENDING_ACCEPTnewStatus传ACCEPTED同时更新worker_idUpdate(UPDATE order_info SET status 2, worker_id #{workerId}, update_time NOW() WHERE id #{orderId} AND status 1) int acceptOrder(Long orderId, Long workerId);如果返回值是 0说明订单已经被别人抢走前端提示“手慢了订单已被接走”。这套方案比在 Java 代码里用synchronized或分布式锁可靠得多因为数据库行锁天然防并发不需要额外引入 Redis。4. 后端接口实现与前端对接代码能启动、表能建出来只是走出了第一步。真正让平台“能用”需要把用户端和管理端的接口都打通。这一章选择家政平台里最有代表性的三个接口展开用户下单、管理员派单、服务人员更新服务进度。4.1 下单接口事务与库存扣减用户下单时要同时做三件事校验项目是否存在且上架、扣减服务项目的当日可约名额、插入订单记录。Service public class OrderServiceImpl implements OrderService { Autowired private ServiceItemMapper serviceItemMapper; Autowired private OrderInfoMapper orderInfoMapper; Override Transactional(rollbackFor Exception.class) public OrderInfo createOrder(OrderCreateDTO dto, Long userId) { ServiceItem item serviceItemMapper.selectById(dto.getServiceItemId()); if (item null || item.getStatus() ! 1) { throw new BusinessException(服务项目不存在或已下架); } int affected serviceItemMapper.deductStock(dto.getServiceItemId(), 1); if (affected 0) { throw new BusinessException(今日名额已约满); } OrderInfo order new OrderInfo(); order.setOrderNo(generateOrderNo(userId)); order.setUserId(userId); order.setServiceItemId(dto.getServiceItemId()); order.setAddress(dto.getAddress()); order.setServiceTime(dto.getServiceTime()); order.setAmount(item.getPrice()); order.setStatus(OrderStatus.PENDING_PAYMENT.getCode()); orderInfoMapper.insert(order); return order; } }三个说明。第一Transactional保证三个操作要么全成功要么全回滚库里不会出现扣了库存但没有订单的脏数据第二deductStock的 SQL 是UPDATE service_item SET stock stock - 1 WHERE id ? AND stock 0这里用库存剩余量做乐观锁判断防止超卖第三generateOrderNo不要用 UUID订单号要可读可排序示例实现是用时间戳加自增序列拼接用户 ID 后取模散列。4.2 管理端派单与工时统计接口管理员的典型操作是查看所有待接单订单然后手动指派给某一个家政人员。这里有一个技巧指派之前先检查该人员当天已有几单超过阈值就换人。GetMapping(/admin/orders/pending) public RListOrderVO pendingOrders( RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int size) { PageOrderInfo pageParam new Page(page, size); IPageOrderInfo result orderInfoMapper.selectPendingPage(pageParam); return R.ok(result.getRecords()); } PostMapping(/admin/orders/dispatch) public RVoid dispatch(RequestBody DispatchDTO dto) { int todayCount orderInfoMapper.countByWorkerAndDate(dto.getWorkerId(), LocalDate.now()); if (todayCount 3) { throw new BusinessException(该人员今日已满负荷); } int affected orderInfoMapper.dispatchWorker(dto.getOrderId(), dto.getWorkerId()); if (affected 0) { throw new BusinessException(订单已被处理); } return R.ok(); }说两个细节countByWorkerAndDate的 SQL 用COUNT(*)和日期范围查询注意service_time字段是DATETIME类型要转成当天 00:00:00 到 23:59:59 再比较不要用DATE_FORMAT包裹字段否则索引失效dispatchWorker对应的 SQL 就是上一章讲的带status条件的更新这里不再重复。4.3 服务人员端进度更新接口家政人员接单后需要依次上报“开始服务”“完成服务”两个动作。这个接口要处理的不是状态机正向流转而是身份校验只能操作指派给自己的订单。PostMapping(/worker/order/progress) public RVoid updateProgress(RequestBody ProgressDTO dto, RequestAttribute Long workerId) { OrderInfo order orderInfoMapper.selectById(dto.getOrderId()); if (order null) { throw new BusinessException(订单不存在); } if (!order.getWorkerId().equals(workerId)) { throw new BusinessException(无权操作他人订单); } OrderStatus current OrderStatus.fromCode(order.getStatus()); OrderStatus target OrderStatus.fromCode(dto.getTargetStatus()); if (!orderStateMachine.canTransit(current, target)) { throw new BusinessException( String.format(订单状态不允许从 %s 变更为 %s, current.getDesc(), target.getDesc())); } orderInfoMapper.updateStatusWithLock(order.getId(), current.getCode(), target.getCode()); return R.ok(); }这种写法的好处是状态机逻辑集中在一个类里接口层不需要关心哪个状态允许跳到哪个状态。后续如果增加“投诉”状态只需要往枚举和状态机映射里加两条记录业务代码零改动。4.4 Vue 前端对接的跨域与 Token 传递如果源码带前端大概率是 Vue 2 Element UI运行在 8081 端口。跨域配置在后端统一处理比前端代理更简单。Spring Boot 里加一个配置类Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowedHeaders(*) .allowCredentials(true) .maxAge(3600); } }前端请求拦截器里把登录后拿到的 Token 塞进请求头axios.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers[Authorization] Bearer token } return config })这里的allowedOriginPatterns(*)在 Spring Boot 2.5 中替代了已废弃的allowedOrigins可以匹配带端口的任意来源。实际生产部署时不要写*应该指定前端域名但本地联调时这是最省心的配置。5. 定时任务与系统监控的进阶扩展基础 CRUD 跑通后平台还缺两个能力超时未支付订单的自动取消以及给管理员的运营看板。这两个需求分别对应 Spring Boot 的Scheduled定时任务和简单的聚合统计查询。5.1 超时订单自动取消用户下单后 15 分钟不支付订单应该自动失效。用Scheduled实现最简单Component public class OrderTimeoutTask { Autowired private OrderInfoMapper orderInfoMapper; Scheduled(cron 0 */5 * * * ?) public void cancelExpiredOrders() { LocalDateTime deadline LocalDateTime.now().minusMinutes(15); ListOrderInfo expiredOrders orderInfoMapper.selectExpired(deadline); for (OrderInfo order : expiredOrders) { orderInfoMapper.updateStatusWithLock( order.getId(), OrderStatus.PENDING_PAYMENT.getCode(), OrderStatus.CANCELED.getCode()); serviceItemMapper.restoreStock(order.getServiceItemId(), 1); } } }两个要点Cron 表达式0 */5 * * * ?表示每 5 分钟跑一次秒固定为 0分钟字段用*/5?用于日和周字段避免互斥selectExpired的 SQL 里要带AND status 0只查待支付状态防止把已取消的订单又查出来。库存回补动作放在状态更新成功后保证不会出现取消失败但库存扣减的现象。5.2 运营看板聚合查询家政平台的运营在看什么当日订单量、营业额、各项目占比、人员接单排行。这些数据看单个页面时不需要实时计算用一条聚合 SQL 就能解决SELECT COUNT(*) AS total_orders, SUM(CASE WHEN status 5 THEN amount ELSE 0 END) AS total_revenue, COUNT(CASE WHEN status 1 THEN 1 END) AS pending_accept_count FROM order_info WHERE create_time CURDATE()这段 SQL 放在一个DashboardMapper接口里返回一个DashboardVO对象对应字段直接用as别名映射到驼峰属性上。需要注意CURDATE()在 MySQL 里返回的是日期字符串和DATETIME字段比较时会自动走索引这是正确做法如果写成DATE(create_time) CURDATE()全表扫描几乎必现。5.3 Heapdump 泄露与敏感信息脱敏Spring Boot Actuator 如果暴露了heapdump端点而数据源密码、Redis 密码都写在application.yml里明文存储攻击者下载 heap dump 后用 MAT 分析直接就能提取出密码字符串。这不是危言耸听常见的处理是management: endpoints: web: exposure: include: health,info只暴露health和info把beans、heapdump、env全部关掉。如果你需要保留env端点用于排查至少要对密码字段做脱敏处理自定义EnvironmentPostProcessor或者用jasypt-spring-boot-starter对配置密码加密启动时再解密注入。6. 部署与排错从开发机到服务器的最后一公里本地跑通之后部署到服务器时会遇到开发环境没暴露的问题。这一章给三个高频排错点和一套验证流程。6.1 内存参数与端口占用Spring Boot 默认启动后 JVM 会占用将近 1GB 内存1 核 2G 的云服务器如果不限制堆内存很容易 OOM。建议启动命令写成java -Xms256m -Xmx512m -jar housekeeping-app.jar --spring.profiles.activeprod-Xms256m让 JVM 启动时就分配 256M避免运行中频繁扩容-Xmx512m把上限压到 512M给操作系统留出余量。端口被占用时用lsof -i:8080找到进程确认是旧进程后kill再启动不要盲目重启服务器。6.2 NullPointerException 集中排查家政平台最常见的空指针出在查询结果上selectById返回的null直接调用.getName()。排查顺序是第一开启 MyBatis 的日志看 SQL 是否真的执行了第二确认application.yml里map-underscore-to-camel-case有没有设为true第三检查service层有没有统一包装返回体。6.3 验证流程一条命令判断服务是否健康启动后不要急着打开浏览器用 curl 验证接口curl -X POST http://localhost:8080/api/auth/login \ -H Content-Type: application/json \ -d {username:admin,password:admin123}正常会返回一段 JSON包含 token 字段和用户信息如果返回 404确认context-path是否设置过它会影响所有 URL 前缀如果返回 401检查拦截器是否放行了/api/auth/login这类源码通常把拦截器写在config包里登录接口必须加入白名单。Configuration public class WebConfig implements WebMvcConfigurer { Autowired private AuthInterceptor authInterceptor; Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(authInterceptor) .addPathPatterns(/**) .excludePathPatterns(/api/auth/login, /api/register); } }最后的建议是把spring.profiles.active按环境拆开application-dev.yml配本地数据库和调试日志application-prod.yml配线上地址并关闭 SQL 日志这两个文件的切换成本极低但能避免开发和部署时的很多误操作。本文还有配套的精品资源点击获取