SpringBoot城市垃圾分类管理系统：从需求拆分到毕设答辩全流程解析

毕业设计拿到“城市垃圾分类管理系统”这个题目的同学应该不止你一个。坦白说我最初看到这个题目也觉得有点鸡肋分类查询加后台管理听起来就是一套带界面的增删改查。但真正动手做下来分类数据怎么建、用户的预约订单状态怎么流转、积分账目怎么做才不出错每个点都能把人折腾得头大。这篇就把我完整做完整个SpringBoot项目的思路、源码结构和踩坑记录一起放出来代码不喊口号直接能拿去写论文、做答辩演示。这套系统面向两类使用者居民用户负责查分类、预约回收、攒积分、换商品管理员负责维护分类字典、审核订单、发公告、看统计报表。技术组合我用的是SpringBoot 2.7 MyBatis-Plus MySQL 8 Vue 3 Element Plus后端主体部分完全能独立跑起来前端如果用不惯Vue也可以换成Thymeleaf模板后面会细说。1. 项目整体设计与需求拆解1.1 为什么用SpringBoot而不是SSM毕设选技术栈有个很现实的原则别给自己挖坑。我见过不少同学一上来就选Spring Cloud、微服务、分布式那一套结果骨架还没搭完就陷入了各种依赖冲突。垃圾分类管理系统本质上是一个单体业务系统用户量级、业务复杂度都套不上微服务硬上反而会让答辩老师追问“你这块拆分依据是什么”一两句话说不清楚就等于给自己找麻烦。SpringBoot的核心价值在于自动配置和起步依赖。开发时不用再写一堆XML配置Maven引入spring-boot-starter-web就能把Web环境跑起来内嵌Tomcat也省去了部署时的环境配置。对毕设来说省下来的时间应该花在业务逻辑和界面效果上而不是tomcat-users.xml里调账号。还有一点很重要SpringBoot的生态资料最多。遇到问题搜解决方案绝大多数都是围绕SpringBoot展开的对没有太多项目经验的学生来说这是最大的隐性福利。选一个参考资料最多、出问题容易找到答案的技术栈本身就是降低项目风险的手段。1.2 角色划分与核心业务流程做系统设计之前先把人理清楚。这个系统我最终划成了三个角色名字不需要花哨关键是权限边界清晰居民用户微信端或者网页端登录可以查垃圾类别、填报回收预约、查看积分记录、兑换商品、提交反馈。小区/回收站管理员负责接收和处理回收预约订单更新订单状态上下架积分兑换商品。系统管理员拥有最高权限管理所有用户、管理分类词库、发布公告、查看全站统计报表。核心业务流程也不复杂但必须一件件理顺。最常用的一条链路是用户搜索一个垃圾名称系统返回这个垃圾属于哪一类、投放要求是什么用户如果手里有可回收物就发起一个预约订单填好地址和时间管理员接单后生成一次回收行程回收完成之后系统按重量或件数给用户发放积分积分攒到一定数量就能兑换日用品、优惠券。这个链路有状态有金额积分也是钱有线下环节做完之后用来答辩讲业务逻辑是非常完整的案例。1.3 技术选型全景与版本搭配选型表直接列出来版本都是我实测跑通的层级技术版本说明后端框架SpringBoot2.7.18自动配置成熟资料最多ORMMyBatis-Plus3.5.3单表CRUD不用写SQL数据库MySQL8.0正常8.0就行认证JWTjjwt 0.9.1无状态登录适合前后端分离前端管理端Vue 3 Element Plus3.x表格、表单、弹窗组件齐构建工具Maven3.8打jar包必备项目环境JDK8或11不要一上来就JDK 17跑SpringBoot 2.x这里特别提醒一句很多同学拿到新电脑直接装JDK 17跑SpringBoot 2.x会报各种莫名其妙的兼容问题。如果不想折腾老老实实JDK 8。SpringBoot 3确实可以用JDK 17但很多MyBatis-Plus和第三方组件的适配还不够稳对毕设来说没必要冒这个险。2. 功能模块与数据库建模2.1 功能模块全景功能清单不要拍脑袋我按“用户能做什么、管理员能做什么”两条线列出来做论文用例图的时候直接抄用户端功能注册、登录维护个人基础信息垃圾名称搜索返回所属分类和投放指引浏览垃圾分类百科按类别查看常见垃圾列表提交可回收物预约订单填写类别、预估重量、地址、上门时间查看订单状态流转取消未接单的订单查看积分明细积分兑换商品查看兑换记录浏览公告提交意见反馈管理端功能后台登录基于角色显示不同菜单用户管理查询、禁用、重置账号分类管理维护“可回收/厨余/有害/其他”四分类配置分类下的垃圾词条词条管理维护垃圾名称、别名、投放指引支持批量导入订单管理接单、完成回收、取消订单回写重量并发放积分商品管理上架、编辑、下架积分兑换商品数据统计每日预约量、分类占比、新增用户数图表2.2 数据库表结构逐张拆解数据库设计是这项目最容易返工的地方。我第一次建表的时候把用户积分直接做成用户表的一个字段后来发现积分变更记录没法追溯答辩时被老师一问就卡住了。第二次重构把账目流水分出来整个系统就说得清了。核心表包括8张sys_user用户、category分类、garbage_item垃圾词条、recycling_order回收订单、point_record积分流水、exchange_product兑换商品、exchange_order兑换订单、notice公告。recycling_order表是状态流转最复杂的单独拆开看CREATE TABLE recycling_order ( id bigint NOT NULL AUTO_INCREMENT, order_no varchar(32) NOT NULL COMMENT 订单编号用日期随机数生成, user_id bigint NOT NULL COMMENT 下单用户ID, category_id bigint DEFAULT NULL COMMENT 可回收物分类ID, weight decimal(10,2) DEFAULT NULL COMMENT 预估重量(kg), actual_weight decimal(10,2) DEFAULT NULL COMMENT 实际回收重量(kg), address varchar(256) NOT NULL COMMENT 上门地址, appointment_time datetime NOT NULL COMMENT 预约时间段, status tinyint NOT NULL DEFAULT 0 COMMENT 0待接单 1已接单 2已完成 3已取消, points_awarded int DEFAULT 0 COMMENT 本次发放积分, handler_id bigint DEFAULT NULL COMMENT 处理人(管理员)ID, remark varchar(512) DEFAULT NULL, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_user_id (user_id), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;garbage_item表也有讲究它不只是存名字还要考虑用户的搜索习惯CREATE TABLE garbage_item ( id bigint NOT NULL AUTO_INCREMENT, name varchar(128) NOT NULL COMMENT 标准垃圾名称, alias varchar(255) DEFAULT NULL COMMENT 别名逗号分隔, category_id bigint NOT NULL COMMENT 所属分类ID, description varchar(512) DEFAULT NULL COMMENT 投放要求说明, create_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_category (category_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;积分流水表point_record用type字段区分获取和消费每条记录关联业务单号这样用户积分对不上账的时候可以精确回溯到每一笔操作。2.3 垃圾关键词匹配的数据表达分类查询这块看起来简单实际写起来最容易漏。用户不会老老实实输入“废弃电池”他可能输入“电池”、“旧电池”、“南孚电池”一个词条搞不定。我采用的方式是给标准词条维护一个别名列表查询的时候展开匹配。比如“过期药品”这条词条alias字段存的是“过期药,旧药品,药品,药片”查询时用MyBatis-Plus的or条件逐个匹配。虽然性能不是极致优化但对毕设量级的数据来说完全够用还不需要引入分词器。如果将来要扩展能力强一点可以接HanLP或IK分词但在答辩阶段没必要给自己加戏。3. 核心模块手把手实现3.1 项目初始化与目录结构我用Spring Initializr生成的项目骨架groupId填com.exampleartifactId填garbage-classification。目录结构上我强烈建议包名就按功能模块分而不是按类型分。很多教材喜欢建controller、service、mapper这种纯技术包业务一多就全挤在一起。我按业务域拆成auth、user、category、order、points、exchange、system几个包每个包里面再放controller、service、mapper实体找代码快得多。application.yml核心配置server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/garbage_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0日志开启StdOutImpl在联调阶段非常重要能看到每一条SQL排查数据问题事半功倍。答辩前再关掉不然演示时控制台刷一堆日志反而喧宾夺主。3.2 登录认证与权限拦截实现前后端分离项目最常用的毕业设计认证方案是JWT原理不复杂用户登录成功后生成一个带用户ID和过期时间的token前端存在localStorage里每次请求放进请求头后端拦截器解析token并放行。JwtUtil的核心代码public class JwtUtil { private static final String SECRET garbage-classification-secret; private static final long EXPIRE 7 * 24 * 60 * 60 * 1000L; public static String createToken(Long userId, String username, Integer role) { return Jwts.builder() .setSubject(username) .claim(userId, userId) .claim(role, role) .setExpiration(new Date(System.currentTimeMillis() EXPIRE)) .signWith(SignatureAlgorithm.HS256, SECRET) .compact(); } public static Claims parseToken(String token) { return Jwts.parser().setSigningKey(SECRET).parseClaimsJws(token).getBody(); } }拦截器实现HandlerInterceptor接口在preHandle里从请求头取Authorization解析失败返回401解析成功把userId放到ThreadLocal或request attribute里供业务层使用。然后再定义角色校验管理员接口要求role等于1。有一个容易被忽视的细节SpringBoot的拦截器默认拦截所有路径但你得把/api/auth/login放行不然用户根本没法登录。3.3 垃圾分类查询接口实现分类查询接口的逻辑Override public CategoryVO queryGarbage(String keyword) { // 先用别名匹配 ListGarbageItem items garbageItemMapper.selectList( new LambdaQueryWrapperGarbageItem() .eq(GarbageItem::getName, keyword) .or() .apply(FIND_IN_SET({0}, alias), keyword) ); if (items.isEmpty()) { throw new BusinessException(暂时没有收录这个垃圾词条); } GarbageItem item items.get(0); Category category categoryMapper.selectById(item.getCategoryId()); CategoryVO vo new CategoryVO(); vo.setGarbageName(item.getName()); vo.setCategoryName(category.getName()); vo.setDescription(item.getDescription()); vo.setGuide(category.getGuide()); // 投放指南 return vo; }这里用到FIND_IN_SET是因为alias字段是逗号分隔的字符串等于号匹配不到。如果数据量上来可以考虑拆成中间表但目前这种场景下一个字段解决问题还方便后台管理员直接维护不用搞两套界面。接口统一返回ResultT对象结构是code、message、data。前端拿到code 200就渲染数据否则弹错误提示。全局异常处理器RestControllerAdvice把业务异常转成Result.fail避免把Java堆栈信息直接甩给前端这也是答辩时值得强调的一个点系统的数据交互规范。3.4 预约回收状态机设计订单状态字段我定义成0待接单、1已接单、2已完成、3已取消。状态不是想怎么改就怎么改得先理清迁移规则当前状态允许操作目标状态待接单用户取消 / 管理员接单已取消 / 已接单已接单管理员完成回收已完成已接单管理员取消已取消已完成无终态已取消无终态代码里每次状态变更都做一次校验而不是直接update status。比如用户取消订单要先判断订单的status是否为0否则会闹出“回收都完成了还能取消”的笑话。状态校验方法public void cancelOrder(Long orderId, Long userId) { RecyclingOrder order orderMapper.selectById(orderId); if (!order.getUserId().equals(userId)) { throw new BusinessException(无权操作他人订单); } if (order.getStatus() ! 0) { throw new BusinessException(当前状态不可取消); } order.setStatus(3); orderMapper.updateById(order); }管理员完成订单时需要把实际重量回填然后按规则发放积分。我定的规则是每公斤可回收物积10分积分记录和订单状态变更必须放在同一个事务里。事务写法Transactional(rollbackFor Exception.class) public void completeOrder(Long orderId, BigDecimal actualWeight) { RecyclingOrder order orderMapper.selectById(orderId); if (order.getStatus() ! 1) { throw new BusinessException(订单不是已接单状态); } int points actualWeight.multiply(BigDecimal.valueOf(10)).intValue(); order.setActualWeight(actualWeight); order.setStatus(2); order.setPointsAwarded(points); orderMapper.updateById(order); // 给用户加积分 userMapper.increasePoints(order.getUserId(), points); // 写积分流水 PointRecord record new PointRecord(); record.setUserId(order.getUserId()); record.setChangePoints(points); record.setType(1); // 1获取 2消费 record.setBizNo(order.getOrderNo()); pointRecordMapper.insert(record); }3.5 积分兑换的并发安全处理积分兑换商品时最容易出现的问题是并发扣减。比如用户余额100分商品60分同时提交两个订单如果先查余额再扣减两个请求都通过了校验积分就成负数了。解决办法是用SQL原子操作update sys_user set points points - #{points} where id #{userId} and points #{points}。更新行数等于1说明扣款成功等于0说明积分不足。这个操作天然具备行锁效果不需要程序里手动加锁。同时兑换商品要减库存库存也可以同理处理update exchange_product set stock stock - 1 where id #{id} and stock 0。这两个更新包在同一个事务里任何一步失败就回滚。答辩讲这个方案的时候老师通常会认可因为已经考虑到并发的一致性问题了。4. 前后端联调与部署避坑4.1 跨域问题处理前后端分离开发Vue跑在5173端口SpringBoot跑在8080端口浏览器会因为同源策略拦截请求。处理方式有几种后端加CrossOrigin、全局CORS配置、Nginx反代。我推荐全局配置而不是在Controller上一个一个加注解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); } }注意allowedOriginPatterns(*)和allowCredentials(true)要同时使用如果写成allowedOrigins(*)会报错。这个坑很小但不注意调一晚上都找不出原因。4.2 MyBatis-Plus自动填充的坑自动填充字段看起来方便配置MetaObjectHandler就能在insert时自动写入createTime。但我第一次用的时候发现一个容易忽略的点updateTime如果没有配置成FieldFill.INSERT_UPDATE更新数据时它不会自己变。Component public class MyMetaObjectHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, Date.class, new Date()); this.strictInsertFill(metaObject, updateTime, Date.class, new Date()); } Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, Date.class, new Date()); } }实体字段上别忘了加TableField(fill FieldFill.INSERT)两个地方缺一不可。我在项目里因为这个丢掉了好几天时间每次更新数据时间都不变最后发现是实体注解没写。4.3 打包部署与前端整合毕设答辩经常需要现场演示不能依赖本地的服务一直开着。把项目打成jar包部署在自己笔记本或者学校机房电脑上是最稳妥的方案。后端打包mvn clean package -DskipTests成功后会在target目录生成garbage-classification-0.0.1-SNAPSHOT.jar运行java -jar garbage-classification-0.0.1-SNAPSHOT.jar前端是用Vue构建的如果不方便单独部署Vue服务可以把Vue项目执行npm run builddist目录下生成静态文件再把它们复制到SpringBoot项目的src/main/resources/static里重新打包后前端页面就和后端API一起跑起来了。这样只需一个SpringBoot进程演示环境最简单。4.4 配置文件的经验之谈数据库密码、token密钥这些配置直接写在application.yml里对于毕设来说问题不大但建议至少用application-dev.yml和application-prod.yml分开。答辩时用dev配置演示完把数据库导入脚本一交老师在自己电脑上只要能连上MySQL就能跑起来这个细节很加印象分。另外MySQL连接串必须带上serverTimezoneAsia/Shanghai不然日期字段会差8个小时。这个坑特别隐蔽第一次遇到的时候我以为是自己前端格式化的问题排查了半天才发现是JDBC连接时区。5. 常见问题与排错实录5.1 项目起不来的十大原因我把自己和身边同学踩过的坑汇总了一张清单错误现象大概率原因解决方案Port 8080 was already in use端口被占用换server.port或用netstat -ano查占用进程Access denied for user数据库密码错误核对application.yml的username/passwordUnknown database数据库没创建先执行create database garbage_systemClassNotFoundException依赖没拉全刷新Mavenmvn clean installFailed to configure a DataSource数据源配置缺失检查有没有引入spring-boot-starter-jdbc或者mybatis-plus-boot-starter时间字段相差8小时时区配置缺席连接串加serverTimezoneAsia/ShanghaiInvalid bound statementMapper接口没扫到启动类加MapperScan或者在每个Mapper加Mapper中文乱码数据库字符集问题建库时用utf8mb4连接加characterEncodingutf8Whitelabel Error Page后端接口报错看控制台堆栈多半是空指针或者SQL异常前端请求404前端路由或接口路径不匹配核对controller的RequestMapping5.2 前端联调时的经典翻车现场Vue项目里最常出现的问题是接口请求成功但数据不渲染。排查顺序我建议固定下来先按F12看Network里请求状态如果500就看后端控制台SQL如果200但有报错就看返回的code字段如果数据都正常但不显示那多半是字段名对不上比如后端返回userId前端取user_id。还有一个经常发生的问题登录接口通了但访问需要权限的接口时一直401。原因是前端请求拦截器没把token塞进请求头。检查axios拦截器里是否设置了config.headers.Authorization Bearer tokentoken名称和大小写也要和后端解析的一致。5.3 答辩演示前必须做的三件事第一准备一套干净的演示数据。数据库里不要留一堆测试垃圾数据演示时输关键词搜索结果页干干净净比词条几千条但全部乱码强得多。第二提前把演示要用到的操作顺序过一遍。登录、搜索、下单、后台接单、完成、发放积分、兑换这条链路任何一步现场翻车都很尴尬。我建议准备一个“救场”脚本遇到接口超时就刷新页面遇到数据异常就切到备用账号。第三把项目部署包和数据库导入脚本放在两个地方备份。有些学校要求当场拷贝源码U盘坏了、云盘过期这种问题我见过太多次了。所有交付材料至少三重备份这是用教训换来的经验。5.4 论文里怎么写技术亮点写论文不要只写“系统实现了什么功能”要把实现方式写清楚。我论文里比较受用的几个表述方式“采用JWT无状态认证方案用户登录后通过Token鉴权避免Session共享问题”“预约订单采用状态机设计约束了订单在待接单、已接单、已完成、已取消之间的合法流转路径”“积分扣除使用数据库原子更新解决并发场景下的超扣问题”“引用MyBatis-Plus框架进行单表CRUD操作提高开发效率同时保留自定义SQL能力以应对复杂查询”这些表述既有技术深度又不会为了堆概念而脱离实际。答辩老师问细节的时候因为你真的做了就能讲清楚。6. 从毕设到真实工程还能怎么走6.1 代码结构还能怎么优化毕设做完不等于技术学习结束。如果想让这个项目看起来更像一个“能上生产的系统”有几个方向可以继续打磨。首先是全局异常体系。目前我用RestControllerAdvice处理了业务异常但还没区分参数校验异常、运行时异常、自定义异常。可以加一个GlobalExceptionHandler对MethodArgumentNotValidException统一返回参数错误的提示比让用户看到500友好很多。其次是日志。启动日志、操作日志、异常日志分开记录用logback-spring.xml配置按天滚动关键业务节点打log.info。答辩时展示一下日志规范印象分会明显提升。再次是接口文档。项目里引入springdoc-openapi自动生成Swagger文档管理员维护分类词条的时候就不用翻源码看字段了自己用也很方便。6.2 扩展成小程序端和物联网垃圾分类系统天然适合往微信小程序迁移用户在小区门口扫个码就能查分类、预约回收。小程序端复用后端的接口只要把登录方式换成wx.login获取的openid绑定现有用户体系就可以后端改动量不大。如果还想再往前走一步可以从“回收订单”延伸到智能垃圾箱场景通过物联网设备上报箱体容量自动触发满溢清理工单。这块涉及硬件和数据上报但后端接口设计思路是通的无非是加一个设备表、一条数据上报接口、一个工单状态流转。这些扩展不用全部做完论文的“展望”一章把思路写清楚答辩老师会觉得你不只停留在写码层面而是对系统有整体思考。哪怕空间有限也不要做注水文字越具体越有说服力。6.3 代码管理的习惯趁早养成做完这个项目之后最让我受益的不是学会了几个框架而是养成了用Git做版本管理的习惯。哪怕一个人开发也建议从第一天就建仓库每完成一个模块打一次提交。遇到改坏了的情况一条git revert就能回到安全版本比手动复制文件夹可靠太多。另外环境相关的配置一定不要提交到仓库。application-dev.yml加进.gitignore只保留示例配置。这个习惯在以后的工作中能避免很多安全事故在毕设阶段提前适应百利无害。我自己在这个项目上最大的体会是毕设选题不在于多高大上而在于把你的技术点讲透。垃圾分类管理系统的业务链路足够完整该有的权限控制、事务一致性、状态流转都有做好一样都能成为答辩亮点。拿到这个题目的同学不用慌把上面的模块一个一个落实数据建模多想一步事务和状态约束想清楚答辩基本就稳了。最后再留一句数据库初始化脚本和源码记得多备份我见过有人答辩前一天电脑硬盘挂了连哭的地方都没有。