做毕设最怕的不是不会写代码而是打开一个项目发现看不懂、跑不起来、改不动。这款基于Spring Boot的洗衣店订单管理系统刚好避开了这些坑——技术栈主流、业务逻辑清晰、代码量适中非常适合Java方向的毕业设计、课程设计甚至是刚开始接触企业级项目开发的新手拿来练手。整个系统围绕洗衣店真实的接单、洗衣、取衣流程设计把订单管理、洗衣项目维护、会员管理和营收统计串成一条完整的业务线麻雀虽小但五脏俱全。这套项目源码是免费开源的核心基于Spring Boot MyBatis Plus MySQL前端用Thymeleaf模板引擎渲染没有前后端分离的复杂工程结构对新手特别友好。你拿到之后不需要理解微服务、分布式那一套东西只要会基本的Java语法和SQL就能把项目跑起来、看懂代码、改出自己想要的个性化功能。这篇文章我会完整拆解这个项目的设计思路、数据库结构、核心功能实现以及我实际跑通过程中踩过的坑和排查方案希望能帮你少走弯路。1. 项目整体设计与技术选型思路拆解1.1 为什么Spring Boot是毕设项目的最优解现在计算机专业做毕设Java方向基本绕不开Spring Boot。不是说Spring MVC不行也不是说微服务更高端而是Spring Boot解决了学生在动手阶段最大的痛点——配置地狱。以前用SSH或SSM框架要先配置web.xml、spring配置文件、数据源、事务管理器还没开始写业务代码就已经被配置文件劝退了。Spring Boot把自动化配置做到极致一个启动类就能把Tomcat内嵌进来直接用main方法启动Web服务这对毕设场景来说太合适了。另外Spring Boot的项目结构天生规整controller、service、mapper、entity分层清晰答辩时老师问起分层架构、解耦思想你直接指着代码目录就能讲明白。而且Spring Boot的生态极其成熟文档多、问题解决方案多遇到Bug基本都能搜到答案不像某些冷门框架报一个错要在GitHub issue里翻半天。从我带过的多届毕业生来看同样一个选题用Spring Boot做的完成度普遍比用其他框架的高因为时间都花在了功能和业务上而不是和环境较劲。1.2 功能模块拆解洗衣店到底需要管什么洗衣店订单管理系统名字听起来简单但实际业务比想象中琐碎。先想清楚门店管理员每天在做什么接收顾客送来的衣物记录衣物品类和数量确认洗衣项目普通水洗、干洗、熨烫等告诉顾客多少钱、什么时候能取衣服洗好后通知顾客取件收钱可能还要处理会员充值和折扣。这些流程落到系统里就是几个核心模块。用户管理模块负责顾客的注册、登录和个人信息维护洗衣项目模块维护价格表比如羽绒服干洗多少钱一件、西装熨烫多少钱一套订单管理模块是最核心的部分要记录顾客、衣物明细、所选项目、金额、状态、下单时间和取件时间订单明细表承接订单和洗衣项目的多对多关系一个订单可以包含多件衣服、多个洗衣项目会员管理模块处理会员卡充值、余额、消费记录和折扣计算。最后是统计报表按天、按月查看营业额、订单数量老师在答辩时很喜欢问这个因为它体现了系统不是简单的增删改查。如果只是做一张订单表加上登录功能项目会很单薄答辩分数上不去。这套系统把用户、订单、明细、会员、统计都串起来既有基础CRUD又有业务流程和表关联难度适中又有亮点。1.3 技术栈选择MyBatis Plus与Lombok的实用价值持久层选MyBatis Plus而不是原生MyBatis主要理由只有一个省时间。原生MyBatis每个实体类都要手写Mapper接口和XML映射文件哪怕只是最简单的selectById也要写一堆模板代码MyBatis Plus内置了通用的增删改查方法单表操作基本不用写SQL通过LambdaQueryWrapper就能完成条件查询。比如查某个手机号对应的用户一行代码搞定这在毕设开发中节省了大量时间。数据库选MySQL没有悬念免费、流行、资料多Navicat或DataGrip连上就能操作。连接池用Druid不仅能管理数据库连接还能在监控页面看到SQL执行情况写进论文里也算一个技术亮点。项目里还大量使用了Lombok实体类上加Data注解就自动生成getter、setter、toString方法代码量少很多。初次接触的同学注意一下Lombok是编译期生效的IDEA里需要安装Lombok插件否则会报找不到getter方法。还有一个加分写法是用枚举管理订单状态杜绝到处散落的魔法数字这个后面详细说。2. 核心业务逻辑与数据库设计详解2.1 数据库表设计与关联关系梳理设计数据库表是整个项目的地基表设计得好后面写代码非常顺畅。这套系统我梳理下来有6张核心表用户表、洗衣项目表、订单表、订单明细表、会员卡表、消费记录表。用户表记录id、用户名、密码MD5或BCrypt加密存储、手机号、注册时间同时用一个type字段区分管理员和普通顾客。洗衣项目表最简单就是项目名称、单价、单位、备注比如T恤水洗10元一件、羽绒服干洗50元一件。订单表是核心中的核心字段包括订单号、顾客id、订单状态、总金额、折扣金额、实付金额、下单时间、预计取衣时间、实际取衣时间、操作管理员。值得注意的是订单号不要用自增主键直接暴露给用户建议按业务日期拼接比如20241201开头的流水号既好看又能通过订单号判断下单日期。订单明细表连接订单和洗衣项目包含洗衣项目id、数量、单价、小计为什么要单独拆一张表因为一个订单可以包含多件衣服和多个项目如果把明细塞进订单表设计就完全不符合第三范式统计和修改也都会变得异常痛苦。外键关系上顾客户表关联用户表主键订单表通过user_id关联用户通过order_id关联明细表会员卡和用户一对一关联。需要注意一点实际开发中用外键约束的并不多更多是逻辑关联理由也很实际外键约束会让数据迁移和删除操作变麻烦比如你要删一条测试用户数据订单和会员卡都得一并处理稍不留神就报外键约束错误。逻辑关联在Java代码里通过表连接查询来保证完整性就够了这也是业界常见做法答辩时老师问到外键的问题可以这样回答。2.2 订单状态机的流转设计洗衣店订单管理系统最容易被忽略又最值得讲清楚的就是订单状态。衣服送到店里流程不是一步到位的从顾客进门到取衣离开至少要经历几个状态待接收顾客送衣店员录入、洗涤中衣服进了洗衣房、待取衣洗好了等顾客来拿、已完成顾客取走并付款、已取消。状态设计不能只看当下还要考虑后续扩展比如预约取衣、加急洗涤。一个好的状态管理必须做到两点第一使用枚举或者常量类统一定义状态值禁止在业务代码里直接写数字第二状态流转要定点收敛不要在每个Service方法里都随意setStatus。我习惯的做法是设计一个独立的OrderStatusEnum然后提供统一的transitionTo方法只有这个方法能修改订单状态并且在方法内部校验状态流转是否合法。比如待接收状态可以直接跳到已取消但洗涤中状态不能直接跳到已完成必须先经过待取衣否则就是业务漏洞。用状态机管理订单的价值在答辩时非常出彩。老师会问如果订单在洗涤中顾客突然要取消怎么办你可以回答状态机里可以定义一条合法路径——洗涤中→已完成→退款取消或者限制洗涤中不可取消只能等洗完再协商。这种逻辑看似简单却体现了对真实业务的理解比单纯做CRUD高一个层次。2.3 金额计算与精度控制的细节涉及钱的系统精度问题必须放在第一位。洗衣项目单价可能是小数会员折扣又是比例计算如果用double或float直接做乘法很可能会出现0.10.2不等于0.3这类浮点误差虽然显示层可能看不出来但一旦对账就会出问题。项目里金额字段统一用BigDecimalSQL里对应DECIMAL(10,2)。BigDecimal构造时记得用字符串构造方法new BigDecimal(19.9)不要直接new BigDecimal(19.9)那个double参数会让精度问题原形毕露。金额计算规则我建议这样设计明细表每个项目算出小计单价×数量订单总金额所有明细小计之和然后判断该顾客是否有会员卡有的话按会员等级折扣计算折后金额最终实付金额保留两位小数。优惠金额不要直接存一个字段然后让实付金额依赖它要由实付金额倒推回来这样更符合财务习惯。MyBatis Plus里对BigDecimal的支持很完善实体类定义成BigDecimal表字段对应decimal就行不需要额外配置类型处理器这一块新手不用慌。3. 核心功能实操实现与代码解析3.1 项目搭建与基础配置实操搭建项目推荐用Spring InitializrIDEA旗舰版自带社区版可以访问网站start.spring.io生成后导入。依赖选择上Java 8、Spring Boot 2.7.x、Spring Web、Thymeleaf、MyBatis Framework、MySQL Driver另外Lombok不是所有版本都在初始化器里可以后续手动加到pom.xml。为什么要选2.7.x而不是3.x因为3.x基于Jakarta EE包名从javax变成了jakarta很多网上的教程和代码都是老的直接导入会报一堆莫名其妙的包找不到错误对毕设来说完全没必要冒这个险。配置文件的写法直接影响项目能否跑起来。application.yml里核心配置如下server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/laundry_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 type: com.alibaba.druid.pool.DruidDataSource thymeleaf: cache: false mybatis-plus: mapper-locations: classpath*:/mapper/**/*.xml configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl有两个细节容易踩坑。一个是数据库URL中的serverTimezoneAsia/Shanghai不设置的话连接MySQL 8.x会报时区错误另一个是map-underscore-to-camel-case设为true数据库的user_name字段才能自动映射到实体的userName属性。启动类别忘了加MapperScan注解扫描Mapper接口这一步漏了会报mapper bean找不到。3.2 登录鉴权与拦截器实现要点登录功能没有引入Spring Security对毕设项目来说Spring Security太重了光是配置SecurityConfig就要理解过滤器链、用户详情服务、密码加密器一堆概念写完还没开始设计业务就累得够呛。更务实的做法是用拦截器加JWT或者稍微简朴一点用Session。项目里用的是JWT方案用户登录成功后根据用户id和角色生成一个token前端每次请求把token放在Header里后端拦截器统一校验。JWT的好处是无状态、支持跨域、前后端分离时特别方便而且写进论文里也是一个漂亮的技术点。核心逻辑用jjwt库实现生成token的代码如下public String generateToken(Integer userId, String role) { return Jwts.builder() .setSubject(String.valueOf(userId)) .claim(role, role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() 1000 * 60 * 60 * 24)) .signWith(secretKey) .compact(); }拦截器的继承HandlerInterceptor实现preHandle方法从请求头取出token并解析解析失败就响应401。需要注意放行登录接口和静态资源不然用户还没登录连CSS样式都加载不出来。管理员拦截器和顾客拦截器可以做成两个不同的路径匹配规则管理端接口统一以/admin开头顾客端以/api开头拦截器里针对不同路径做不同角色校验这样权限控制思路非常清晰。3.3 订单创建与状态流转的核心业务代码订单创建是整个系统业务最密集的地方也是最能在答辩时展示实力的环节。一个新订单过来需要做四件事校验洗衣项目和数量合法性、计算总金额、创建订单主记录、批量插入订单明细。事务必须加在Service方法上否则主记录插入成功但明细插入失败就会产生脏数据。核心代码结构Transactional(rollbackFor Exception.class) public OrderVO createOrder(OrderCreateDTO dto) { // 1. 查询会员信息判断是否有折扣 // 2. 计算总金额与实付金额 // 3. 生成订单号并插入订单表 // 4. 遍历明细列表插入订单明细表 }状态流转我建议有一个独立的方法处理。用户点击“取件完成”或管理员点击“确认取衣”都走一个统一入口public void changeOrderStatus(Long orderId, OrderStatusEnum targetStatus) { Order order getById(orderId); OrderStatusEnum currentStatus OrderStatusEnum.fromCode(order.getStatus()); if (!currentStatus.canTransitTo(targetStatus)) { throw new BizException(当前状态不允许执行该操作); } order.setStatus(targetStatus.getCode()); updateById(order); }canTransitTo方法放在枚举里面用Map或者switch维护合法流转表。这样做的好处是以后加一个新状态只需要改枚举业务代码不用动可维护性很强。我在项目里用了一个小的状态映射表干净利落。3.4 统计报表的SQL设计与实现普通订单管理已经能拿及格分了但统计报表才是加分项。用订单创建时间的维度聚合数据按日、按周、按月统计订单总数、总营业额、客单价这些数据对门店经营者有实际参考价值。实现方式是在Mapper里写一个统计查询返回结果是Map或自定义统计VOselect idselectDailyStatistics resultTypemap SELECT DATE_FORMAT(create_time, %Y-%m-%d) AS date, COUNT(*) AS orderCount, SUM(pay_amount) AS totalAmount FROM laundry_order WHERE create_time BETWEEN #{startTime} AND #{endTime} GROUP BY DATE_FORMAT(create_time, %Y-%m-%d) ORDER BY date /select需要注意SUM函数求和时如果某一天没有订单这条SQL只会返回有数据行没有订单的日期不会出现在结果里。前端要显示连续日期趋势图的话需要在Java代码里做一次日期补全把缺失日期的数据填0这个逻辑不复杂但很实用。统计模块做出来页面放一个简单的折线图答辩效果立马上一个档次。4. 代码规范与开发避坑指南4.1 统一返回结果与全局异常处理写接口最忌讳每个方法返回不同格式前端对接时痛苦不堪。项目里定义一个Result对象包含code、message、data三个字段成功返回Result.success(data)失败抛出业务异常后由全局异常处理器统一捕获并封装成Result返回。这样前端只需判断code是不是200就能决定展示数据还是弹错误提示整个系统接口风格完全统一。业务异常用自定义的BizException继承RuntimeException为什么不用检查异常因为Spring的事务回滚默认只回滚RuntimeException如果用Exception会导致事务无法自动回滚这是很多新手完全不知道的坑。全局异常处理器用RestControllerAdvice注解里面ExceptionHandler分别处理业务异常、参数校验异常和其他未知异常最后返回对应的Result结构。4.2 时间字段与时区问题毕设项目里时间类型的坑实在太多。数据库字段用DATETIMEJava实体用LocalDateTime这是比较标准的组合。但很多初次接触的同学在配置时忽略了时区导致数据库存的时间比实际时间少8小时。解决方案有两个层面数据库连接URL带上serverTimezoneAsia/Shanghai这是解决连接层面的问题同时Jackson序列化配置要设置时间格式和时区否则前端通过JSON接口拿到的LocalDateTime会是一串数组而不是可读时间。如果前端要展示时间字符串用JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)注解标记在实体类的日期字段上这是最简单可靠的方式。另一个容易忽略的点是MyBatis Plus的自动填充功能可以在插入时自动填充create_time字段无需手动set配置一个MetaObjectHandler实现类就行代码量不大但能让业务层干净不少。4.3 事务、并发和幂等性的深入处理订单创建涉及多人同时操作并发问题不可忽视。MySQL的默认隔离级别是可重复读在并发插入场景下可能出现唯一键冲突比如用户重复提交下单请求。解决方案是在订单表上建唯一索引结合数据库唯一约束做幂等同时Service方法加Transactional让多个操作统一提交或回滚。如果担心并发扣减会员余额时超扣可以在SQL层面加上条件更新比如UPDATE member_card SET balance balance - #{amount} WHERE id #{id} AND balance #{amount}这样数据库能保证余额不会扣成负数比在Java代码里判断再更新要安全得多。这些内容不适合写进每个初学者都能懂的教程里但如果你能在答辩时讲出“我如何防止余额被并发超扣”的思路老师会明确感受到你做过真实业务而不是只对着CRUD写代码。5. 实测运行中的常见问题与排查技巧5.1 摆平数据库连接与依赖冲突我拿到源码后在新电脑上复现运行第一个遇到的问题就是数据库连接不上。报错信息比较典型的几个Access denied for user rootlocalhost通常是用户名或密码和本地MySQL不一致Unknown database laundry_db需要先用root账号执行SQL脚本创建数据库ClassNotFoundException: com.mysql.cj.jdbc.Driver说明pom.xml里缺了MySQL驱动依赖或者依赖版本过低。逐个排查即可。还有一个高频问题来自IDEA的Maven依赖冲突。当你在pom.xml里加了Druid连接池后如果Spring Boot版本和Druid版本不匹配启动时可能报循环依赖或bean创建异常。我的建议是Druid用稳定版1.2.xSpring Boot用2.7.x这个组合在大量项目里验证过。万一报错先执行mvn clean然后重新导入依赖多半能解决。5.2 MyBatis Plus分页查询失效的排查分页是管理后台的基础功能但很多同学在配置MyBatis Plus分页插件时忘记添加分页拦截器Bean导致page查询返回全部数据。MyBatis Plus并不是装了依赖就有分页功能的必须显式配置Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }这个配置写完后再用Page对象作为第一个参数调用selectPage方法SQL会自动拼接LIMIT控制台SQL日志里能看到limit语句。排查分页失效问题第一步先看控制台有没有LIMIT没有就是插件没生效检查配置类有没有被Spring扫描到启动类上加没加Configuration没被扫到也会静默失败。5.3 前端页面和后端接口联调时的坑这个项目前端用Thymeleaf模板和后端直接共用同一个端口不太容易出跨域的问题但如果自己改装前后端分离就会暴露跨域请求被拦截的问题。Spring Boot后端需要配置跨域过滤器允许指定来源的请求通过。同时前端提交表单时用AJAX还是原生form提交有很大区别原生form是同步请求返回结果是整个HTML页面Ajax请求希望返回JSON这时候Controller方法记得加ResponseBody或统一类上加RestController。联调阶段最常出现的坑是JS请求的参数名和后端实体类字段名对不上。前端代码里写的是userName后端DTO里是username刚好差一个大写名请求过来后端解析不到参数却又不会报错只在日志里看到null。遇到这种问题优先在Controller的入参位置用RequestParam显式指定参数名或者在前端序列化时统一对齐字段命名规则能省不少调试时间。6. 项目拓展方向与答辩加分建议6.1 功能扩展从管理后台到用户自助平台现有系统已经能完成门店内部的订单管理流程但放在真实场景里还可以进一步拓展。最有价值的方向是增加用户自助下单和订单查询入口用户在手机端选择洗衣项目、填写预约上门取件时间、支付定金洗好后收到取件通知。做成微信小程序或H5项目技术上不复杂却能让系统的业务闭环更完整。另一个拓展点是订单打印小票功能用JasperReport或者简单的页面打印模板在取件时生成一张纸质收据这也是真实洗衣店的刚需打印模块写进论文里很有实操感。积分和优惠券模块也是不错的扩展方向。会员充值赠送金额、消费积攒积分、积分兑换洗衣项目这类营销功能商业价值明显数据模型也不复杂一张积分记录表加一张优惠券表就能实现。这些扩展功能可以在论文的“系统改进与展望”章节里重点描述表明你不是只会照搬代码。6.2 性能与安全优化方向它虽然是个单体应用但性能和安全的细节不能少。密码存储用BCrypt加密而不是MD5即使数据库泄露也不会被轻易破解登录接口要加验证码防止恶意脚本刷接口重要操作比如订单作废、退款操作打印操作日志。高性能方面用Redis缓存洗衣项目列表和首页统计数据能显著减少数据库查询压力Redis当成缓存层使用对新手也友好引入RedisTemplate之后代码量并不大。日志采集也是亮点功能。用Logback按天归档日志生产环境排查问题时能直接定位到哪天的哪个操作出了问题。Spring Boot默认支持Logback只需在resources目录下放一个logback-spring.xml配置文件即可。把它写在论文的个人工作里能体现工程素养很加分。6.3 答辩现场讲解的实际经验答辩时不要按代码目录逐文件介绍那是新手才会犯的错误。正确思路是先讲痛点洗衣店传统手工记账效率低、易出错、无法统计经营数据再讲方案系统围绕订单生命周期管理覆盖接收、洗护、取件全流程然后讲技术选型理由Spring Boot简化开发、MyBatis Plus提升持久层效率、JWT解决登录鉴权最后讲个人亮点状态机管理订单流转、BigDecimal保证金额精度、全局异常处理统一返回格式。在演示环节要有一个昨日到今日经营数据的对比结果最好是提前在数据库里造一批真实感强的测试数据不要只有一两条空数据。用一个手机号注册的新用户下单、查看订单状态流转让整个流程动起来远远好过坐在那里干讲功能列表。老师问到的关键点比如订单状态如何流转、金额如何计算、为什么选用MyBatis Plus按上面几节的内容回答基本上不会卡壳。6.3 源码工程使用与导入流程写到这里把最关键的实操流程梳理一遍。拿到源码压缩包后先确认本机环境是JDK 8或11、Maven 3.6、MySQL 5.7或8.x。第一步用IDEA的Open导入项目文件夹等待Maven自动下载依赖下载速度慢可以配置阿里云镜像第二步在Navicat里创建数据库并执行项目提供的init.sql脚本脚本会自动建表并写入默认管理员账号和测试数据第三步修改application.yml里的数据库用户名密码第四步直接启动Application启动类浏览器访问http://localhost:8080就能看到登录页。默认管理员账号一般是admin密码admin123正式上线前一定要改掉。跑起来之后千万不要立刻开始大刀阔斧地改代码先把整个订单流程走一遍用户注册、下单、管理员接单、修改状态、统计报表查询。这个过程能让你理解每个模块的真实位置和数据流向之后再做个性化修改你就会非常清楚改哪里、怎么改。我自己每拿到一个新项目源码必定先完整跑通流程再做任何修改这是领域时间检验过的做法。最后再分享一个小技巧。项目打包部署时用mvn package打出的jar包会内置Tomcat在服务器上运行java -jar laundry-system.jar即可。部署阶段注意配置生产环境的数据库连接和日志路径不要把本地的用户名密码带到服务器上。这套免费分享的源码本身是一个完整的可运行项目但你要做的不是交差而是把它变成真正理解的东西带着自己的思路去改造、去完善那才是毕业设计真正的意义。