简介本资源为基于Java的校园垃圾分类管理系统毕业设计文档面向计算机相关专业学生及需要SSM框架实战参考的开发者可帮助读者完成课程设计、毕业设计或快速搭建同类管理系统。文档围绕校园垃圾分类场景采用SSM框架、Java技术与MySQL数据库进行设计涵盖网站前台、管理员、学生三类角色包含公告信息、文明倡导、垃圾袋信息、扔垃圾信息、商品兑换等模块并涉及系统架构、数据模型、界面设计与安全测试等内容。资源包共1个docx文件大小约1.66MB结构完整便于直接查阅与二次修改。目前已有196人学习下载适合需要完整项目方案、功能模块划分与论文写作参考的读者可从中获取需求分析、功能设计、数据库建模及测试思路等实用内容。1. 校园垃圾分类管理系统从“垃圾桶满溢”到“数据闭环”的落地拆解很多学校后勤最头疼的不是没人分类而是分类之后没人知道到底分得对不对、哪栋楼的可回收物最多、哪个时间段厨余垃圾爆桶。一套基于 Java 的校园垃圾分类管理系统核心要解决的就是把“扔垃圾”这个动作变成可记录、可统计、可反馈的数据流。它适合计算机专业做课程设计或毕业设计的学生也适合想用一套真实业务练手 Spring Boot 权限控制 数据可视化的初中级开发者。这个系统不是简单的增删改查它涉及角色权限、积分激励、投放记录、分类准确率统计这几个真实业务模块。我见过太多人把它做成一个“垃圾信息录入表”最后答辩被问“分类准确率怎么算”直接卡壳。这篇笔记就按我实际落地过的思路把技术选型、表结构、核心接口和最容易翻车的地方一次讲透。2. 技术选型与分层为什么用 Spring Boot MyBatis-Plus 而不是裸 Servlet2.1 后端框架的取舍Spring Boot 2.7 MyBatis-Plus 是当前最稳的组合校园垃圾分类管理系统的业务复杂度不高但角色多、统计维度多。如果还用原生 Servlet JDBC光是用户登录态管理和分页查询就能写到你怀疑人生。我一般会直接上 Spring Boot 2.7.x搭配 MyBatis-Plus 3.5.x。原因很直接MyBatis-Plus 的LambdaQueryWrapper能让你在写“查询某栋楼本周可回收物投放总量”这种条件时少写一半 SQL而且分页插件开箱即用。数据库选 MySQL 8.0字符集用utf8mb4因为垃圾名称里可能出现生僻字或者 emoji 备注。前端如果只是课程设计Thymeleaf 或 Vue 2 Element UI 都行如果想让系统看起来更“能打”用 Vue 3 ECharts 做数据看板答辩时直接展示各楼栋分类准确率柱状图效果比纯表格好得多。依赖版本我固定用这套!-- pom.xml 关键依赖 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies !-- Web 层 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.2/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- Lombok 减少样板代码 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies逻辑说明Spring Boot 2.7 是 2.x 最后一个稳定大版本社区资料最全遇到问题搜索命中率最高。MyBatis-Plus 3.5.3.2 对 Spring Boot 2.7 兼容性经过大量项目验证不要盲目上 3.5.4部分小版本有分页插件冲突。参数方面mybatis-plus.configuration.map-underscore-to-camel-case保持默认true这样数据库的create_time能自动映射到实体类的createTime。2.2 分层结构Controller 只做参数校验业务逻辑全部下沉到 Service我见过很多学生项目把业务写在 Controller 里一个方法 200 行后面加一个“统计每个学生投放次数”的需求直接改不动。正确的分层是Controller 接收 DTO、做Valid校验、调用 Service、返回统一 Result 包装Service 接口定义业务方法实现类里写具体逻辑和事务Mapper 只负责单表 CRUD 和自定义 SQL。包结构建议这样com.campus.garbage ├── controller │ ├── UserController.java │ ├── GarbageController.java │ └── RecordController.java ├── service │ ├── UserService.java │ └── impl/UserServiceImpl.java ├── mapper │ └── UserMapper.java ├── entity │ └── User.java ├── dto │ └── UserLoginDTO.java ├── vo │ └── RecordVO.java └── common └── Result.javaResult类统一返回格式避免前端拿到五花八门的 JSON 结构Data public class ResultT { private Integer code; // 200 成功500 失败 private String msg; private T data; public static T ResultT ok(T data) { ResultT r new Result(); r.setCode(200); r.setMsg(操作成功); r.setData(data); return r; } public static T ResultT fail(String msg) { ResultT r new Result(); r.setCode(500); r.setMsg(msg); return r; } }参数说明code用 200/500 而不是 0/1是为了和 HTTP 状态码语义对齐前端拦截器里判断res.code ! 200直接弹错误提示。data用泛型这样分页数据、单个对象、布尔值都能塞进去。2.3 权限控制用 Spring Security JWT 还是 Session 拦截器校园垃圾分类管理系统一般有四种角色学生、宿管、后勤管理员、系统管理员。学生只能看自己的投放记录和积分宿管能审核本楼栋的投放记录后勤管理员能看全校统计系统管理员管用户和基础数据。如果只是课程设计用 Session HandlerInterceptor 完全够用实现快、调试直观。但如果你想让简历上多一个亮点或者系统需要前后端分离部署那就上 Spring Security JWT。我一般会选后者因为 JWT 无状态后端重启不影响已登录用户而且能顺便把“java 怎么保证数据一致性”这个面试常问的点在项目里落地——比如积分变更时用数据库乐观锁。JWT 工具类核心代码public class JwtUtil { private static final String SECRET campus-garbage-2024-secret-key; private static final long EXPIRE 7 * 24 * 60 * 60 * 1000L; // 7天 public static String generateToken(Long userId, String role) { return Jwts.builder() .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(); } }逻辑说明generateToken把用户 ID 和角色写进 payload后续拦截器直接从 token 里取角色做权限判断不用每次查库。SECRET不要硬编码在代码里生产环境放配置文件或环境变量。EXPIRE设 7 天是校园场景的折中太长不安全太短学生老要重新登录。3. 数据库表设计与核心字段别把“垃圾类型”写死在代码里3.1 五张核心表用户、垃圾类型、投放记录、积分流水、楼栋表设计是这类系统最容易埋雷的地方。我见过有人把垃圾类型写成枚举RECYCLABLE, KITCHEN, HAZARDOUS, OTHER结果学校要求增加“大件垃圾”分类直接要改代码重新部署。正确做法是把垃圾类型做成一张表后台可维护。-- 用户表 CREATE TABLE user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 学号/工号, password VARCHAR(100) NOT NULL COMMENT BCrypt加密, real_name VARCHAR(50) DEFAULT NULL, role VARCHAR(20) NOT NULL DEFAULT STUDENT COMMENT STUDENT/DORM_ADMIN/LOGISTICS/ADMIN, building_id BIGINT DEFAULT NULL COMMENT 所属楼栋, points INT NOT NULL DEFAULT 0 COMMENT 积分余额, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 垃圾类型表 CREATE TABLE garbage_type ( id BIGINT NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL COMMENT 可回收物/厨余垃圾/有害垃圾/其他垃圾, code VARCHAR(20) NOT NULL COMMENT RECYCLABLE/KITCHEN/HAZARDOUS/OTHER, points_per_kg INT NOT NULL DEFAULT 0 COMMENT 每公斤积分, status TINYINT NOT NULL DEFAULT 1 COMMENT 1启用 0停用, PRIMARY KEY (id), UNIQUE KEY uk_code (code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 投放记录表 CREATE TABLE record ( id BIGINT NOT NULL AUTO_INCREMENT, user_id BIGINT NOT NULL, type_id BIGINT NOT NULL, weight DECIMAL(10,2) DEFAULT NULL COMMENT 重量kg, image_url VARCHAR(255) DEFAULT NULL COMMENT 投放照片, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待审核 1通过 2驳回, audit_remark VARCHAR(255) DEFAULT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_time (user_id, create_time), KEY idx_type (type_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 积分流水表 CREATE TABLE points_log ( id BIGINT NOT NULL AUTO_INCREMENT, user_id BIGINT NOT NULL, change_points INT NOT NULL COMMENT 正数增加负数扣减, reason VARCHAR(100) DEFAULT NULL, record_id BIGINT DEFAULT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user (user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 楼栋表 CREATE TABLE building ( id BIGINT NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL, campus VARCHAR(50) DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明record表用status做审核状态宿管审核通过后才给用户加积分这样能防止学生随便拍张照片就刷分。points_log单独一张表每次积分变动都记流水方便对账和排查“为什么我的积分少了”。idx_user_time联合索引是为了加速“查询某学生最近 30 天投放记录”这个高频查询。参数注意weight用DECIMAL(10,2)而不是FLOAT避免浮点精度问题。points_per_kg放在类型表里后勤管理员可以随时调整比如可回收物从 10 分/公斤改成 15 分/公斤不用改代码。3.2 积分变更的并发安全用乐观锁而不是 synchronized学生投放记录审核通过时要给用户加积分。如果同一个学生有多条记录同时被审核或者宿管误操作点了两次就会出现积分覆盖。我一般用 MyBatis-Plus 的Version乐观锁在user表加一个version字段。// User 实体类加 Version Data TableName(user) public class User { TableId(type IdType.AUTO) private Long id; private String username; private Integer points; Version private Integer version; // 其他字段省略 } // Service 中更新积分 Transactional(rollbackFor Exception.class) public void addPoints(Long userId, int points, String reason, Long recordId) { User user userMapper.selectById(userId); user.setPoints(user.getPoints() points); int rows userMapper.updateById(user); // 带 version 条件 if (rows 0) { throw new RuntimeException(积分更新冲突请重试); } PointsLog log new PointsLog(); log.setUserId(userId); log.setChangePoints(points); log.setReason(reason); log.setRecordId(recordId); pointsLogMapper.insert(log); }逻辑说明updateById生成的 SQL 会带WHERE id ? AND version ?如果 version 被其他事务改过更新影响行数为 0直接抛异常回滚。这样比synchronized锁整个方法粒度更细性能更好。注意Transactional要加rollbackFor Exception.class否则默认只回滚RuntimeException。4. 核心功能实现投放记录、审核、统计看板4.1 学生投放接口图片上传 记录落库学生投放垃圾时前端拍照上传后端存图片、写记录。图片存储如果只是课程设计直接存本地磁盘D:/campus-garbage/upload/数据库存相对路径。生产环境建议上 MinIO 或对象存储但别为了炫技把项目搞复杂。PostMapping(/record/submit) public ResultString submitRecord(RequestParam(file) MultipartFile file, RequestParam Long typeId, RequestParam(required false) BigDecimal weight, HttpServletRequest request) { Long userId (Long) request.getAttribute(userId); if (file.isEmpty()) { return Result.fail(请上传投放照片); } // 校验文件类型 String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.)); if (!Arrays.asList(.jpg, .jpeg, .png).contains(suffix.toLowerCase())) { return Result.fail(仅支持 jpg/png 格式); } // 存本地 String fileName UUID.randomUUID() suffix; File dest new File(D:/campus-garbage/upload/ fileName); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } try { file.transferTo(dest); } catch (IOException e) { return Result.fail(图片保存失败); } // 写记录 Record record new Record(); record.setUserId(userId); record.setTypeId(typeId); record.setWeight(weight); record.setImageUrl(/upload/ fileName); record.setStatus(0); // 待审核 recordMapper.insert(record); return Result.ok(提交成功等待审核); }逻辑说明先校验文件后缀防止上传 jsp 等可执行文件。UUID重命名避免中文名和重复名问题。status固定为 0审核通过才改 1。参数方面weight允许为空因为有些垃圾没法称重比如一个塑料瓶可以按个数估算但课程设计里简化处理。4.2 宿管审核接口批量审核与积分发放宿管登录后看到本楼栋待审核列表可以单条通过或驳回也可以勾选多条批量通过。批量通过时要注意事务要么全成功要么全回滚。PostMapping(/record/audit) Transactional(rollbackFor Exception.class) public ResultString auditRecords(RequestBody AuditDTO auditDTO) { // auditDTO 包含 recordIds、status、remark ListRecord records recordMapper.selectBatchIds(auditDTO.getRecordIds()); for (Record record : records) { if (record.getStatus() ! 0) { continue; // 已审核的跳过 } record.setStatus(auditDTO.getStatus()); record.setAuditRemark(auditDTO.getRemark()); recordMapper.updateById(record); if (auditDTO.getStatus() 1) { // 审核通过计算积分 GarbageType type garbageTypeMapper.selectById(record.getTypeId()); int points type.getPointsPerKg() * (record.getWeight() null ? 1 : record.getWeight().intValue()); addPoints(record.getUserId(), points, 投放 type.getName(), record.getId()); } } return Result.ok(审核完成); }逻辑说明selectBatchIds一次查出所有记录循环里判断status ! 0跳过已审核的防止重复加分。积分计算用pointsPerKg * weight如果 weight 为空按 1 公斤算这是简化处理实际项目可以让宿管手动输入积分。addPoints方法内部有乐观锁保证并发安全。4.3 统计看板用 ECharts 展示各楼栋分类准确率统计接口返回的数据结构要直接适配 ECharts减少前端转换。比如“各楼栋可回收物投放量”返回{ buildingName: 1号楼, totalWeight: 120.5 }数组。GetMapping(/stats/building) public ResultListMapString, Object buildingStats(RequestParam String typeCode) { QueryWrapperRecord wrapper new QueryWrapper(); wrapper.eq(status, 1) .eq(type_id, garbageTypeMapper.selectOne( new QueryWrapperGarbageType().eq(code, typeCode)).getId()) .groupBy(user_id); // 实际 SQL 需要 join building 表这里用自定义 Mapper 方法 ListMapString, Object list recordMapper.selectBuildingStats(typeCode); return Result.ok(list); }对应的 Mapper XMLselect idselectBuildingStats resultTypejava.util.Map SELECT b.name AS buildingName, IFNULL(SUM(r.weight), 0) AS totalWeight FROM record r JOIN user u ON r.user_id u.id JOIN building b ON u.building_id b.id JOIN garbage_type gt ON r.type_id gt.id WHERE r.status 1 AND gt.code #{typeCode} GROUP BY b.id, b.name ORDER BY totalWeight DESC /select逻辑说明IFNULL(SUM(r.weight), 0)防止某楼栋没有投放记录时返回 null前端图表显示 0 更友好。GROUP BY b.id, b.name同时按 ID 和名称分组避免同名楼栋合并。参数typeCode从下拉框传入比如RECYCLABLE。5. 避坑与排查那些答辩被问住的瞬间5.1 图片上传后访问 404静态资源映射没配现象学生提交记录成功但审核页面图片显示裂图浏览器控制台报 404。原因Spring Boot 默认静态资源目录是classpath:/static/你存到D:/campus-garbage/upload/当然访问不到。解决加一个 WebMvcConfigurer 配置映射。Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file:D:/campus-garbage/upload/); } }注意addResourceLocations最后必须带/否则拼接路径会出错。Windows 下用file:D:/...Linux 下用file:/home/...。5.2 积分加了两次审核接口没做幂等现象宿管网络卡顿点了两次“通过”学生积分翻倍。原因接口没有判断记录当前状态第二次请求又把 status 从 1 改成 1但积分逻辑又执行了一遍。解决在auditRecords循环里加if (record.getStatus() ! 0) continue;并且前端按钮点击后置灰。更稳妥的做法是用数据库唯一约束比如points_log表对record_id加唯一索引同一记录只能产生一条积分流水。5.3 分页查询 total 为 0MyBatis-Plus 分页插件没注册现象记录列表能显示数据但分页组件显示总条数为 0翻页失效。原因MyBatis-Plus 的分页功能需要手动注册PaginationInnerInterceptor。解决加配置类。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }注意DbType.MYSQL要和你实际数据库一致用 Oracle 就改成DbType.ORACLE。5.4 中文乱码数据库连接 URL 没加 characterEncoding现象垃圾类型名称“厨余垃圾”存进去变成“??????”。原因JDBC URL 没指定编码。解决spring.datasource.url加上useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。另外建表时确认CHARSETutf8mb4MySQL 8 默认就是 utf8mb4但老版本要手动指定。5.5 事务不生效方法内部调用导致代理失效现象addPoints方法加了Transactional但积分更新失败后流水还是插入了。原因在同一个 Service 类里A 方法直接调用 B 方法B 方法的Transactional不会生效因为没走代理。解决把addPoints放到另一个 Service 类里或者用AopContext.currentProxy()获取代理对象调用。最简单的是拆成PointsService在RecordService里注入调用。6. 进阶技巧用 AOP 记录操作日志与数据一致性校验课程设计答辩时老师最喜欢问“你怎么保证数据一致性”和“有没有操作日志”。这两个点用 AOP 一起解决代码量不大但很加分。先定义一个Log注解Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface Log { String value() default ; }然后写切面Aspect Component public class LogAspect { Autowired private OperationLogMapper logMapper; Around(annotation(logAnno)) public Object around(ProceedingJoinPoint joinPoint, Log logAnno) throws Throwable { long start System.currentTimeMillis(); Object result joinPoint.proceed(); long cost System.currentTimeMillis() - start; OperationLog log new OperationLog(); log.setMethod(joinPoint.getSignature().toShortString()); log.setParams(Arrays.toString(joinPoint.getArgs())); log.setCost(cost); log.setCreateTime(new Date()); logMapper.insert(log); return result; } }在审核接口上加Log(审核投放记录)每次审核都会自动记录方法名、参数和耗时。这样答辩时你能拿出“操作日志表”说“所有关键操作可追溯积分变更都有流水数据一致性靠事务 乐观锁 唯一索引三重保障。”数据一致性校验可以写一个定时任务每天凌晨跑一次对账user.points是否等于points_log里该用户所有change_points之和。如果不相等说明有脏数据发邮件告警。这个任务用Scheduled(cron 0 0 3 * * ?)就能实现。Scheduled(cron 0 0 3 * * ?) public void checkPointsConsistency() { ListUser users userMapper.selectList(null); for (User user : users) { Integer sum pointsLogMapper.selectSumByUserId(user.getId()); if (sum null) sum 0; if (!sum.equals(user.getPoints())) { // 记录不一致写告警表或发邮件 log.error(用户 {} 积分不一致余额 {}流水合计 {}, user.getId(), user.getPoints(), sum); } } }这个技巧我在实际项目里用过上线第一个月就抓到一次因为并发导致的积分偏差后来加了乐观锁重试就再没出现过。做课程设计时把这个定时任务写进去答辩老师基本不会再追问一致性问题。最后说个血泪经验别在最后一周才动手写代码。表结构定好之后先把登录和投放记录跑通再补审核和统计。我见过太多人卡在图片上传和分页插件上熬夜改到凌晨三点。希望帮到你。本文还有配套的精品资源点击获取 校园垃圾分类管理系统实战：Spring Boot+MyBatis-Plus实现投放审核与积分统计
简介本资源为基于Java的校园垃圾分类管理系统毕业设计文档面向计算机相关专业学生及需要SSM框架实战参考的开发者可帮助读者完成课程设计、毕业设计或快速搭建同类管理系统。文档围绕校园垃圾分类场景采用SSM框架、Java技术与MySQL数据库进行设计涵盖网站前台、管理员、学生三类角色包含公告信息、文明倡导、垃圾袋信息、扔垃圾信息、商品兑换等模块并涉及系统架构、数据模型、界面设计与安全测试等内容。资源包共1个docx文件大小约1.66MB结构完整便于直接查阅与二次修改。目前已有196人学习下载适合需要完整项目方案、功能模块划分与论文写作参考的读者可从中获取需求分析、功能设计、数据库建模及测试思路等实用内容。1. 校园垃圾分类管理系统从“垃圾桶满溢”到“数据闭环”的落地拆解很多学校后勤最头疼的不是没人分类而是分类之后没人知道到底分得对不对、哪栋楼的可回收物最多、哪个时间段厨余垃圾爆桶。一套基于 Java 的校园垃圾分类管理系统核心要解决的就是把“扔垃圾”这个动作变成可记录、可统计、可反馈的数据流。它适合计算机专业做课程设计或毕业设计的学生也适合想用一套真实业务练手 Spring Boot 权限控制 数据可视化的初中级开发者。这个系统不是简单的增删改查它涉及角色权限、积分激励、投放记录、分类准确率统计这几个真实业务模块。我见过太多人把它做成一个“垃圾信息录入表”最后答辩被问“分类准确率怎么算”直接卡壳。这篇笔记就按我实际落地过的思路把技术选型、表结构、核心接口和最容易翻车的地方一次讲透。2. 技术选型与分层为什么用 Spring Boot MyBatis-Plus 而不是裸 Servlet2.1 后端框架的取舍Spring Boot 2.7 MyBatis-Plus 是当前最稳的组合校园垃圾分类管理系统的业务复杂度不高但角色多、统计维度多。如果还用原生 Servlet JDBC光是用户登录态管理和分页查询就能写到你怀疑人生。我一般会直接上 Spring Boot 2.7.x搭配 MyBatis-Plus 3.5.x。原因很直接MyBatis-Plus 的LambdaQueryWrapper能让你在写“查询某栋楼本周可回收物投放总量”这种条件时少写一半 SQL而且分页插件开箱即用。数据库选 MySQL 8.0字符集用utf8mb4因为垃圾名称里可能出现生僻字或者 emoji 备注。前端如果只是课程设计Thymeleaf 或 Vue 2 Element UI 都行如果想让系统看起来更“能打”用 Vue 3 ECharts 做数据看板答辩时直接展示各楼栋分类准确率柱状图效果比纯表格好得多。依赖版本我固定用这套!-- pom.xml 关键依赖 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies !-- Web 层 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.2/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- Lombok 减少样板代码 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies逻辑说明Spring Boot 2.7 是 2.x 最后一个稳定大版本社区资料最全遇到问题搜索命中率最高。MyBatis-Plus 3.5.3.2 对 Spring Boot 2.7 兼容性经过大量项目验证不要盲目上 3.5.4部分小版本有分页插件冲突。参数方面mybatis-plus.configuration.map-underscore-to-camel-case保持默认true这样数据库的create_time能自动映射到实体类的createTime。2.2 分层结构Controller 只做参数校验业务逻辑全部下沉到 Service我见过很多学生项目把业务写在 Controller 里一个方法 200 行后面加一个“统计每个学生投放次数”的需求直接改不动。正确的分层是Controller 接收 DTO、做Valid校验、调用 Service、返回统一 Result 包装Service 接口定义业务方法实现类里写具体逻辑和事务Mapper 只负责单表 CRUD 和自定义 SQL。包结构建议这样com.campus.garbage ├── controller │ ├── UserController.java │ ├── GarbageController.java │ └── RecordController.java ├── service │ ├── UserService.java │ └── impl/UserServiceImpl.java ├── mapper │ └── UserMapper.java ├── entity │ └── User.java ├── dto │ └── UserLoginDTO.java ├── vo │ └── RecordVO.java └── common └── Result.javaResult类统一返回格式避免前端拿到五花八门的 JSON 结构Data public class ResultT { private Integer code; // 200 成功500 失败 private String msg; private T data; public static T ResultT ok(T data) { ResultT r new Result(); r.setCode(200); r.setMsg(操作成功); r.setData(data); return r; } public static T ResultT fail(String msg) { ResultT r new Result(); r.setCode(500); r.setMsg(msg); return r; } }参数说明code用 200/500 而不是 0/1是为了和 HTTP 状态码语义对齐前端拦截器里判断res.code ! 200直接弹错误提示。data用泛型这样分页数据、单个对象、布尔值都能塞进去。2.3 权限控制用 Spring Security JWT 还是 Session 拦截器校园垃圾分类管理系统一般有四种角色学生、宿管、后勤管理员、系统管理员。学生只能看自己的投放记录和积分宿管能审核本楼栋的投放记录后勤管理员能看全校统计系统管理员管用户和基础数据。如果只是课程设计用 Session HandlerInterceptor 完全够用实现快、调试直观。但如果你想让简历上多一个亮点或者系统需要前后端分离部署那就上 Spring Security JWT。我一般会选后者因为 JWT 无状态后端重启不影响已登录用户而且能顺便把“java 怎么保证数据一致性”这个面试常问的点在项目里落地——比如积分变更时用数据库乐观锁。JWT 工具类核心代码public class JwtUtil { private static final String SECRET campus-garbage-2024-secret-key; private static final long EXPIRE 7 * 24 * 60 * 60 * 1000L; // 7天 public static String generateToken(Long userId, String role) { return Jwts.builder() .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(); } }逻辑说明generateToken把用户 ID 和角色写进 payload后续拦截器直接从 token 里取角色做权限判断不用每次查库。SECRET不要硬编码在代码里生产环境放配置文件或环境变量。EXPIRE设 7 天是校园场景的折中太长不安全太短学生老要重新登录。3. 数据库表设计与核心字段别把“垃圾类型”写死在代码里3.1 五张核心表用户、垃圾类型、投放记录、积分流水、楼栋表设计是这类系统最容易埋雷的地方。我见过有人把垃圾类型写成枚举RECYCLABLE, KITCHEN, HAZARDOUS, OTHER结果学校要求增加“大件垃圾”分类直接要改代码重新部署。正确做法是把垃圾类型做成一张表后台可维护。-- 用户表 CREATE TABLE user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 学号/工号, password VARCHAR(100) NOT NULL COMMENT BCrypt加密, real_name VARCHAR(50) DEFAULT NULL, role VARCHAR(20) NOT NULL DEFAULT STUDENT COMMENT STUDENT/DORM_ADMIN/LOGISTICS/ADMIN, building_id BIGINT DEFAULT NULL COMMENT 所属楼栋, points INT NOT NULL DEFAULT 0 COMMENT 积分余额, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 垃圾类型表 CREATE TABLE garbage_type ( id BIGINT NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL COMMENT 可回收物/厨余垃圾/有害垃圾/其他垃圾, code VARCHAR(20) NOT NULL COMMENT RECYCLABLE/KITCHEN/HAZARDOUS/OTHER, points_per_kg INT NOT NULL DEFAULT 0 COMMENT 每公斤积分, status TINYINT NOT NULL DEFAULT 1 COMMENT 1启用 0停用, PRIMARY KEY (id), UNIQUE KEY uk_code (code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 投放记录表 CREATE TABLE record ( id BIGINT NOT NULL AUTO_INCREMENT, user_id BIGINT NOT NULL, type_id BIGINT NOT NULL, weight DECIMAL(10,2) DEFAULT NULL COMMENT 重量kg, image_url VARCHAR(255) DEFAULT NULL COMMENT 投放照片, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待审核 1通过 2驳回, audit_remark VARCHAR(255) DEFAULT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_time (user_id, create_time), KEY idx_type (type_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 积分流水表 CREATE TABLE points_log ( id BIGINT NOT NULL AUTO_INCREMENT, user_id BIGINT NOT NULL, change_points INT NOT NULL COMMENT 正数增加负数扣减, reason VARCHAR(100) DEFAULT NULL, record_id BIGINT DEFAULT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user (user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 楼栋表 CREATE TABLE building ( id BIGINT NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL, campus VARCHAR(50) DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明record表用status做审核状态宿管审核通过后才给用户加积分这样能防止学生随便拍张照片就刷分。points_log单独一张表每次积分变动都记流水方便对账和排查“为什么我的积分少了”。idx_user_time联合索引是为了加速“查询某学生最近 30 天投放记录”这个高频查询。参数注意weight用DECIMAL(10,2)而不是FLOAT避免浮点精度问题。points_per_kg放在类型表里后勤管理员可以随时调整比如可回收物从 10 分/公斤改成 15 分/公斤不用改代码。3.2 积分变更的并发安全用乐观锁而不是 synchronized学生投放记录审核通过时要给用户加积分。如果同一个学生有多条记录同时被审核或者宿管误操作点了两次就会出现积分覆盖。我一般用 MyBatis-Plus 的Version乐观锁在user表加一个version字段。// User 实体类加 Version Data TableName(user) public class User { TableId(type IdType.AUTO) private Long id; private String username; private Integer points; Version private Integer version; // 其他字段省略 } // Service 中更新积分 Transactional(rollbackFor Exception.class) public void addPoints(Long userId, int points, String reason, Long recordId) { User user userMapper.selectById(userId); user.setPoints(user.getPoints() points); int rows userMapper.updateById(user); // 带 version 条件 if (rows 0) { throw new RuntimeException(积分更新冲突请重试); } PointsLog log new PointsLog(); log.setUserId(userId); log.setChangePoints(points); log.setReason(reason); log.setRecordId(recordId); pointsLogMapper.insert(log); }逻辑说明updateById生成的 SQL 会带WHERE id ? AND version ?如果 version 被其他事务改过更新影响行数为 0直接抛异常回滚。这样比synchronized锁整个方法粒度更细性能更好。注意Transactional要加rollbackFor Exception.class否则默认只回滚RuntimeException。4. 核心功能实现投放记录、审核、统计看板4.1 学生投放接口图片上传 记录落库学生投放垃圾时前端拍照上传后端存图片、写记录。图片存储如果只是课程设计直接存本地磁盘D:/campus-garbage/upload/数据库存相对路径。生产环境建议上 MinIO 或对象存储但别为了炫技把项目搞复杂。PostMapping(/record/submit) public ResultString submitRecord(RequestParam(file) MultipartFile file, RequestParam Long typeId, RequestParam(required false) BigDecimal weight, HttpServletRequest request) { Long userId (Long) request.getAttribute(userId); if (file.isEmpty()) { return Result.fail(请上传投放照片); } // 校验文件类型 String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.)); if (!Arrays.asList(.jpg, .jpeg, .png).contains(suffix.toLowerCase())) { return Result.fail(仅支持 jpg/png 格式); } // 存本地 String fileName UUID.randomUUID() suffix; File dest new File(D:/campus-garbage/upload/ fileName); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } try { file.transferTo(dest); } catch (IOException e) { return Result.fail(图片保存失败); } // 写记录 Record record new Record(); record.setUserId(userId); record.setTypeId(typeId); record.setWeight(weight); record.setImageUrl(/upload/ fileName); record.setStatus(0); // 待审核 recordMapper.insert(record); return Result.ok(提交成功等待审核); }逻辑说明先校验文件后缀防止上传 jsp 等可执行文件。UUID重命名避免中文名和重复名问题。status固定为 0审核通过才改 1。参数方面weight允许为空因为有些垃圾没法称重比如一个塑料瓶可以按个数估算但课程设计里简化处理。4.2 宿管审核接口批量审核与积分发放宿管登录后看到本楼栋待审核列表可以单条通过或驳回也可以勾选多条批量通过。批量通过时要注意事务要么全成功要么全回滚。PostMapping(/record/audit) Transactional(rollbackFor Exception.class) public ResultString auditRecords(RequestBody AuditDTO auditDTO) { // auditDTO 包含 recordIds、status、remark ListRecord records recordMapper.selectBatchIds(auditDTO.getRecordIds()); for (Record record : records) { if (record.getStatus() ! 0) { continue; // 已审核的跳过 } record.setStatus(auditDTO.getStatus()); record.setAuditRemark(auditDTO.getRemark()); recordMapper.updateById(record); if (auditDTO.getStatus() 1) { // 审核通过计算积分 GarbageType type garbageTypeMapper.selectById(record.getTypeId()); int points type.getPointsPerKg() * (record.getWeight() null ? 1 : record.getWeight().intValue()); addPoints(record.getUserId(), points, 投放 type.getName(), record.getId()); } } return Result.ok(审核完成); }逻辑说明selectBatchIds一次查出所有记录循环里判断status ! 0跳过已审核的防止重复加分。积分计算用pointsPerKg * weight如果 weight 为空按 1 公斤算这是简化处理实际项目可以让宿管手动输入积分。addPoints方法内部有乐观锁保证并发安全。4.3 统计看板用 ECharts 展示各楼栋分类准确率统计接口返回的数据结构要直接适配 ECharts减少前端转换。比如“各楼栋可回收物投放量”返回{ buildingName: 1号楼, totalWeight: 120.5 }数组。GetMapping(/stats/building) public ResultListMapString, Object buildingStats(RequestParam String typeCode) { QueryWrapperRecord wrapper new QueryWrapper(); wrapper.eq(status, 1) .eq(type_id, garbageTypeMapper.selectOne( new QueryWrapperGarbageType().eq(code, typeCode)).getId()) .groupBy(user_id); // 实际 SQL 需要 join building 表这里用自定义 Mapper 方法 ListMapString, Object list recordMapper.selectBuildingStats(typeCode); return Result.ok(list); }对应的 Mapper XMLselect idselectBuildingStats resultTypejava.util.Map SELECT b.name AS buildingName, IFNULL(SUM(r.weight), 0) AS totalWeight FROM record r JOIN user u ON r.user_id u.id JOIN building b ON u.building_id b.id JOIN garbage_type gt ON r.type_id gt.id WHERE r.status 1 AND gt.code #{typeCode} GROUP BY b.id, b.name ORDER BY totalWeight DESC /select逻辑说明IFNULL(SUM(r.weight), 0)防止某楼栋没有投放记录时返回 null前端图表显示 0 更友好。GROUP BY b.id, b.name同时按 ID 和名称分组避免同名楼栋合并。参数typeCode从下拉框传入比如RECYCLABLE。5. 避坑与排查那些答辩被问住的瞬间5.1 图片上传后访问 404静态资源映射没配现象学生提交记录成功但审核页面图片显示裂图浏览器控制台报 404。原因Spring Boot 默认静态资源目录是classpath:/static/你存到D:/campus-garbage/upload/当然访问不到。解决加一个 WebMvcConfigurer 配置映射。Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file:D:/campus-garbage/upload/); } }注意addResourceLocations最后必须带/否则拼接路径会出错。Windows 下用file:D:/...Linux 下用file:/home/...。5.2 积分加了两次审核接口没做幂等现象宿管网络卡顿点了两次“通过”学生积分翻倍。原因接口没有判断记录当前状态第二次请求又把 status 从 1 改成 1但积分逻辑又执行了一遍。解决在auditRecords循环里加if (record.getStatus() ! 0) continue;并且前端按钮点击后置灰。更稳妥的做法是用数据库唯一约束比如points_log表对record_id加唯一索引同一记录只能产生一条积分流水。5.3 分页查询 total 为 0MyBatis-Plus 分页插件没注册现象记录列表能显示数据但分页组件显示总条数为 0翻页失效。原因MyBatis-Plus 的分页功能需要手动注册PaginationInnerInterceptor。解决加配置类。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }注意DbType.MYSQL要和你实际数据库一致用 Oracle 就改成DbType.ORACLE。5.4 中文乱码数据库连接 URL 没加 characterEncoding现象垃圾类型名称“厨余垃圾”存进去变成“??????”。原因JDBC URL 没指定编码。解决spring.datasource.url加上useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。另外建表时确认CHARSETutf8mb4MySQL 8 默认就是 utf8mb4但老版本要手动指定。5.5 事务不生效方法内部调用导致代理失效现象addPoints方法加了Transactional但积分更新失败后流水还是插入了。原因在同一个 Service 类里A 方法直接调用 B 方法B 方法的Transactional不会生效因为没走代理。解决把addPoints放到另一个 Service 类里或者用AopContext.currentProxy()获取代理对象调用。最简单的是拆成PointsService在RecordService里注入调用。6. 进阶技巧用 AOP 记录操作日志与数据一致性校验课程设计答辩时老师最喜欢问“你怎么保证数据一致性”和“有没有操作日志”。这两个点用 AOP 一起解决代码量不大但很加分。先定义一个Log注解Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface Log { String value() default ; }然后写切面Aspect Component public class LogAspect { Autowired private OperationLogMapper logMapper; Around(annotation(logAnno)) public Object around(ProceedingJoinPoint joinPoint, Log logAnno) throws Throwable { long start System.currentTimeMillis(); Object result joinPoint.proceed(); long cost System.currentTimeMillis() - start; OperationLog log new OperationLog(); log.setMethod(joinPoint.getSignature().toShortString()); log.setParams(Arrays.toString(joinPoint.getArgs())); log.setCost(cost); log.setCreateTime(new Date()); logMapper.insert(log); return result; } }在审核接口上加Log(审核投放记录)每次审核都会自动记录方法名、参数和耗时。这样答辩时你能拿出“操作日志表”说“所有关键操作可追溯积分变更都有流水数据一致性靠事务 乐观锁 唯一索引三重保障。”数据一致性校验可以写一个定时任务每天凌晨跑一次对账user.points是否等于points_log里该用户所有change_points之和。如果不相等说明有脏数据发邮件告警。这个任务用Scheduled(cron 0 0 3 * * ?)就能实现。Scheduled(cron 0 0 3 * * ?) public void checkPointsConsistency() { ListUser users userMapper.selectList(null); for (User user : users) { Integer sum pointsLogMapper.selectSumByUserId(user.getId()); if (sum null) sum 0; if (!sum.equals(user.getPoints())) { // 记录不一致写告警表或发邮件 log.error(用户 {} 积分不一致余额 {}流水合计 {}, user.getId(), user.getPoints(), sum); } } }这个技巧我在实际项目里用过上线第一个月就抓到一次因为并发导致的积分偏差后来加了乐观锁重试就再没出现过。做课程设计时把这个定时任务写进去答辩老师基本不会再追问一致性问题。最后说个血泪经验别在最后一周才动手写代码。表结构定好之后先把登录和投放记录跑通再补审核和统计。我见过太多人卡在图片上传和分页插件上熬夜改到凌晨三点。希望帮到你。本文还有配套的精品资源点击获取