简介这份毕业设计资源面向高校计算机相关专业学生提供基于Spring Boot框架的校园闲置物品交易网站完整实现方案适合需要完成课程设计或毕业设计、希望掌握Java Web全栈开发流程的学习者。压缩包为zip格式整体约78.44MB内含源码、数据库脚本、论文LW、PPT与演示视频等核心文件覆盖从需求分析到系统测试的完整环节。系统按管理员、用户与前台首页三类角色划分功能管理员负责用户管理、商品类型与信息管理、系统管理及订单管理用户可浏览商品、管理收藏与订单前台支持商品资讯、购物车与后台入口。论文部分包含系统结构设计、实体ER图、数据表设计、各功能模块实现及测试章节可帮助读者理解Spring Boot项目分层结构与数据库建模思路。目前已有108人学习适合作为同类交易平台开发的参考模板与答辩准备材料。1. 校园闲置物品交易网站从一份毕业设计到一个能跑起来的 SpringBoot 项目每年毕业季计算机专业的选题里总有一类经久不衰校园闲置物品交易网站。原因很实在——需求真实、边界清晰、技术栈主流答辩时老师一听就懂演示起来也不容易翻车。但真正动手做的时候很多人卡在同一个地方网上搜到的 SpringBoot 教程要么是电商全栈要么是博客系统套到校园闲置这个场景上字段对不上、流程接不上、数据库表设计得七零八落。这篇笔记就围绕基于 SpringBoot 的校园闲置物品交易网站这个标题把从技术选型、数据库设计、核心功能实现到部署演示的完整路径拆开讲。适合两类人一是正在做这个毕业设计、需要一份能照着复现的落地参考的同学二是想拿一个中小型 SpringBoot 项目练手、熟悉前后端分离开发流程的开发者。我不会假设你手里已经有一份现成源码而是按如果从零开始做我会怎么搭的思路来写中间该给的代码、表结构、参数配置都会给到坑也会提前标出来。需要说明的是毕业设计通常还要求配套的论文LW、PPT 和演示视频这些属于交付物层面的东西本文聚焦在系统本身怎么实现因为只有系统跑通了后面的文档和演示才有东西可写。技术栈上主流做法是 SpringBoot MyBatis-Plus MySQL Vue/Thymeleaf本文以这个组合为主线展开。2. 技术选型与项目骨架为什么这套组合最适合校园闲置场景2.1 为什么是 SpringBoot 而不是 SSM 或 Servlet校园闲置物品交易网站的功能量级不大用户注册登录、发布商品、浏览搜索、下单、留言、后台管理撑死十几个模块。这种量级下SpringBoot 的核心价值是省配置。传统 SSM 要手写一堆 XML光是applicationContext.xml、spring-mvc.xml、mybatis-config.xml三个文件就能劝退一批人而且版本冲突是玄学级别的痛。SpringBoot 用 starter 把依赖版本锁死application.yml一个文件搞定数据源、端口、日志起步成本低很多。另一个现实原因是资料多、报错好搜。毕业设计最怕的不是功能难而是卡在一个冷门报错上三天出不来。SpringBoot 生态成熟你遇到的 90% 问题搜索引擎里都有现成答案。相比之下如果选一个冷门框架答辩前一周出问题可能连问的人都找不到。版本选择上有个血泪经验别追最新版。SpringBoot 3.x 要求 JDK 17很多学校的实验环境还停留在 JDK 8一编译就报Unsupported class file major version。稳妥做法是用 SpringBoot 2.7.x 配 JDK 8兼容性最好网上教程也最多。如果你的环境确实是 JDK 17那用 3.x 也没问题但要注意javax.*换成了jakarta.*很多老代码直接复制会编译不过。2.2 项目骨架与依赖配置一个能跑的最小骨架pom.xml里核心依赖就这几块Web、MyBatis-Plus、MySQL 驱动、Lombok。下面是我一般会用的依赖配置dependencies !-- Web 起步依赖提供内嵌 Tomcat 和 MVC -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus比原生 MyBatis 少写大量 CRUD -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- MySQL 驱动8.x 版本注意驱动类名带 cj -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency !-- Lombok用注解生成 getter/setter减少样板代码 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies逻辑说明spring-boot-starter-web是 Web 项目的根没有它连 Controller 都跑不起来MyBatis-Plus 的 starter 会自动装配 SqlSessionFactory省去手写配置类MySQL 驱动版本要和你的数据库服务端匹配8.0 的驱动连 5.7 的库一般没问题反过来容易出时区报错。参数说明MyBatis-Plus 版本选 3.5.x 系列和 SpringBoot 2.7 兼容良好如果升到 SpringBoot 3.xMyBatis-Plus 要用 3.5.3 以上并换成mybatis-plus-spring-boot3-starter否则启动会报找不到 Bean。application.yml里几个必调参数server: port: 8080 # 端口被占用就换 8081 spring: datasource: url: jdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: map-underscore-to-camel-case: true # 下划线字段自动映射驼峰属性 global-config: db-config: logic-delete-field: deleted # 逻辑删除字段 logic-delete-value: 1 logic-not-delete-value: 0这里serverTimezoneAsia/Shanghai是必须的不加的话 MySQL 8 会报时区错误这是新手最常见的翻车点之一。map-underscore-to-camel-case打开后数据库的user_name能自动映射到 Java 的userName省掉一堆Results注解。3. 数据库设计校园闲置场景下最容易设计错的几张表3.1 核心表结构与字段说明校园闲置交易和通用电商最大的区别在于商品是二手的、唯一的、卖完即止所以库存概念弱化取而代之的是商品状态。下面是我一般会用的核心表设计共 6 张主表。表名作用关键字段user用户学生id, username, password, nickname, phone, campus, credit_scorecategory商品分类id, name, sortgoods闲置商品id, title, price, cover, description, category_id, seller_id, status, view_countorder订单id, order_no, goods_id, buyer_id, seller_id, amount, status, create_timemessage留言/私信id, goods_id, from_user, to_user, content, is_readnotice公告id, title, content, create_timegoods表的status字段是设计重点一般用枚举值0 待审核、1 在售、2 已售、3 下架。很多同学一开始只用一个is_sold布尔字段结果后台审核、用户下架、交易完成三种状态混在一起逻辑越写越乱。状态字段一定要预留够这是血泪经验。order表要冗余存seller_id虽然可以通过goods_id关联查出来但订单列表页要频繁展示卖家信息每次 join 查询性能差冗余一个字段能省不少事。这是典型的用空间换查询效率在中小项目里完全值得。3.2 建表 SQL 与索引建议CREATE TABLE goods ( id BIGINT NOT NULL AUTO_INCREMENT, title VARCHAR(100) NOT NULL COMMENT 商品标题, price DECIMAL(10,2) NOT NULL COMMENT 价格, cover VARCHAR(255) DEFAULT NULL COMMENT 封面图路径, description TEXT COMMENT 详细描述, category_id INT NOT NULL COMMENT 分类ID, seller_id BIGINT NOT NULL COMMENT 卖家ID, status TINYINT DEFAULT 1 COMMENT 0待审 1在售 2已售 3下架, view_count INT DEFAULT 0 COMMENT 浏览量, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, deleted TINYINT DEFAULT 0 COMMENT 逻辑删除, PRIMARY KEY (id), KEY idx_category (category_id), KEY idx_seller (seller_id), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明price用DECIMAL而不是FLOAT因为浮点数算钱会出现0.10.20.30000000000000004这种精度问题答辩时被问到会很难看。description用TEXT因为商品描述可能较长。三个索引分别对应按分类筛选查我的发布按状态过滤三个高频查询场景。参数说明utf8mb4而不是utf8因为要支持 emoji学生发商品描述时经常带表情。deleted字段配合前面 MyBatis-Plus 的逻辑删除配置删除商品时只改标记不真删方便后台追溯。提示建表时字段注释一定要写全。答辩老师翻数据库的时候看到一堆没有注释的字段印象分会打折而且后期自己维护也容易忘。4. 核心功能实现发布、搜索、下单三条主线的代码落地4.1 商品发布与图片上传发布商品是系统的入口功能涉及表单提交和文件上传。Controller 层大致长这样RestController RequestMapping(/api/goods) public class GoodsController { Autowired private GoodsService goodsService; // 发布商品接收表单和封面图 PostMapping(/publish) public Result publish(RequestParam(file) MultipartFile file, Goods goods, RequestParam Long sellerId) { // 1. 保存图片到本地磁盘返回访问路径 String coverPath fileService.save(file); goods.setCover(coverPath); goods.setSellerId(sellerId); goods.setStatus(1); // 直接上架也可设为 0 走审核 goodsService.save(goods); return Result.success(发布成功); } }逻辑说明MultipartFile接收上传文件Goods对象由 Spring 自动绑定表单字段。先存图片再存商品保证cover字段有值。Result是自定义的统一返回体包含 code、msg、data 三个字段前端好处理。参数说明file参数名要和前端input namefile一致否则报Required request part file is not present。图片存储路径建议放在项目外的独立目录比如D:/campus-upload/不要放在src/main/resources下因为打包成 jar 后那个目录是只读的写不进去。文件上传大小限制要在application.yml里放开默认只有 1MB传张手机拍的照片就超了spring: servlet: multipart: max-file-size: 10MB max-request-size: 20MB4.2 商品搜索与分页搜索是闲置交易的核心体验用户要能按关键词、分类、价格区间筛选。用 MyBatis-Plus 的LambdaQueryWrapper可以很优雅地实现public PageGoods search(String keyword, Integer categoryId, BigDecimal minPrice, BigDecimal maxPrice, int page, int size) { LambdaQueryWrapperGoods wrapper new LambdaQueryWrapper(); // 关键词模糊匹配标题 wrapper.like(StringUtils.hasText(keyword), Goods::getTitle, keyword); // 分类精确匹配 wrapper.eq(categoryId ! null, Goods::getCategoryId, categoryId); // 价格区间 wrapper.ge(minPrice ! null, Goods::getPrice, minPrice); wrapper.le(maxPrice ! null, Goods::getPrice, maxPrice); // 只查在售商品按发布时间倒序 wrapper.eq(Goods::getStatus, 1); wrapper.orderByDesc(Goods::getCreateTime); return goodsService.page(new Page(page, size), wrapper); }逻辑说明LambdaQueryWrapper的每个条件方法第一个参数是布尔值为 true 时才拼接该条件这样就能实现参数为空则忽略的动态查询不用写一堆 if。like默认是%keyword%全模糊数据量大时索引失效但校园项目数据量小可以接受。参数说明page从 1 开始size建议默认 10 或 12对应前端一页展示的商品数。orderByDesc按时间倒序保证新发布的商品排前面符合用户预期。注意如果搜索关键词包含%或_会被当成 SQL 通配符导致查询结果异常。稳妥做法是在传入前做转义或者用apply手动拼条件。4.3 下单流程与并发处理下单是唯一涉及数据一致性的地方。校园闲置的特点是一件商品只能卖给一个人所以下单时要防止两个用户同时买同一件商品。最朴素也最有效的做法是用乐观锁或状态判断Transactional public Result createOrder(Long goodsId, Long buyerId) { // 1. 查询商品判断是否在售 Goods goods goodsService.getById(goodsId); if (goods null || goods.getStatus() ! 1) { return Result.fail(商品已售出或已下架); } // 2. 更新商品状态用 status1 作为条件防止并发 boolean updated goodsService.lambdaUpdate() .eq(Goods::getId, goodsId) .eq(Goods::getStatus, 1) .set(Goods::getStatus, 2) .update(); if (!updated) { return Result.fail(手慢了商品已被抢走); } // 3. 生成订单 Order order new Order(); order.setOrderNo(generateOrderNo()); order.setGoodsId(goodsId); order.setBuyerId(buyerId); order.setSellerId(goods.getSellerId()); order.setAmount(goods.getPrice()); order.setStatus(0); // 待付款 orderService.save(order); return Result.success(下单成功); }逻辑说明关键在于第 2 步update语句带了status1的条件如果另一个线程已经把状态改成 2这次更新影响行数为 0updated为 false直接返回失败。这就是用数据库的原子性做并发控制比加锁简单可靠。Transactional保证订单生成和状态更新要么都成功要么都回滚。参数说明generateOrderNo()一般用时间戳 用户ID后四位 随机数生成保证唯一且可读。订单状态 0 待付款、1 已付款、2 已完成、3 已取消和商品状态是两套独立的状态机别混用。5. 避坑与排查这个项目里我踩过的 5 个坑5.1 坑一跨域请求被浏览器拦截现象前端 Vue 跑在 8081 端口后端 SpringBoot 跑在 8080调接口时浏览器控制台报Access to XMLHttpRequest has been blocked by CORS policy。原因浏览器的同源策略协议、域名、端口任一不同就算跨域后端没返回 CORS 响应头。解决加一个全局跨域配置类或者用注解。全局配置更省事Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) // 允许所有来源 .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true) .maxAge(3600); } }注意allowedOriginPatterns而不是allowedOrigins因为allowCredentials(true)和allowedOrigins(*)不能同时用会报错。5.2 坑二MyBatis-Plus 逻辑删除后查询不到数据现象删除了一个商品再查列表发现所有商品都没了或者删除的商品还能查到。原因逻辑删除字段配置和实体类注解不一致。要么application.yml里配了logic-delete-field实体类没加TableLogic要么字段名对不上。解决二选一要么全局配置要么实体类加注解别重复配。实体类上写TableLogic后deleteById会自动变成UPDATE ... SET deleted1查询自动带WHERE deleted0。如果发现删除后还能查到检查是不是字段名写成了is_deleted而配置里写的是deleted。5.3 坑三图片上传后访问 404现象图片上传成功数据库里路径也对但前端img src显示不出来控制台 404。原因图片存在磁盘目录但没配置静态资源映射SpringBoot 不知道这个目录要对外暴露。解决加一个 WebMvcConfigurer 配置把上传目录映射到访问路径Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 访问 /upload/** 时去 D:/campus-upload/ 目录找文件 registry.addResourceHandler(/upload/**) .addResourceLocations(file:D:/campus-upload/); }路径末尾的斜杠不能少少了会拼错路径。Linux 服务器上路径换成/home/upload/这种形式。5.4 坑四打包成 jar 后运行报数据库连接失败现象IDEA 里跑得好好的mvn package打成 jar 后java -jar启动报Communications link failure。原因application.yml里的数据库地址写的是localhost但打包后如果换机器运行或者 MySQL 没启动就连不上。还有一种情况是配置文件被打进了 jar改配置要重新打包。解决把application.yml外置到 jar 同级目录启动时用--spring.config.location指定。或者用application-prod.yml区分环境。另外确认 MySQL 服务已启动端口 3306 没被防火墙拦。5.5 坑五答辩演示时前端页面白屏现象本地一切正常答辩现场打开页面一片空白F12 报Failed to load resource。原因前端打包后的静态资源路径是绝对路径/static/js/xxx.js部署到子目录或者用 file 协议打开就找不到。解决Vue 项目在vue.config.js里设publicPath: ./用相对路径。如果是前后端不分离的 Thymeleaf 项目确认模板文件放在templates下静态资源放在static下别放错目录。答辩前一定要在另一台电脑上完整跑一遍别只在自己机器上测。6. 让项目更耐问三个能加分的进阶技巧6.1 用 Redis 缓存热门商品列表答辩时如果老师问你这个系统性能怎么样能答上缓存就是加分项。校园闲置的首页商品列表访问频率最高可以加一层 Redis 缓存。做法是在查询前先查 Redis命中就返回没命中查数据库再写回缓存设置 5 分钟过期。public ListGoods getHotList() { String key goods:hot; // 先查缓存 ListGoods cached (ListGoods) redisTemplate.opsForValue().get(key); if (cached ! null) { return cached; } // 缓存没有查数据库 ListGoods list goodsService.lambdaQuery() .eq(Goods::getStatus, 1) .orderByDesc(Goods::getViewCount) .last(LIMIT 20) .list(); // 写回缓存5 分钟过期 redisTemplate.opsForValue().set(key, list, 5, TimeUnit.MINUTES); return list; }参数说明LIMIT 20控制缓存数据量别把整张表缓存进去。过期时间 5 分钟是平衡实时性和性能商品发布后最多 5 分钟出现在热门列表可以接受。注意实体类要实现Serializable否则 Redis 序列化会报错。6.2 加一个简单的敏感词过滤校园场景下商品描述和留言可能出现不当内容加个敏感词过滤能体现你的工程意识。最简单的做法是维护一个敏感词列表提交前做替换private static final ListString SENSITIVE_WORDS Arrays.asList(违禁词1, 违禁词2); public String filter(String content) { if (content null) return null; for (String word : SENSITIVE_WORDS) { if (content.contains(word)) { content content.replace(word, ***); } } return content; }在发布商品和发送留言的入口调用这个方法。词库可以放在配置文件或数据库里方便后台维护。这个功能代码量小但答辩时能讲出内容安全这个点比纯 CRUD 有深度。6.3 用 AOP 记录操作日志后台管理操作审核商品、删除用户最好留痕。用 Spring AOP 加一个切面拦截带自定义注解的方法把操作人、操作类型、时间写进日志表Aspect Component public class LogAspect { Around(annotation(operLog)) public Object around(ProceedingJoinPoint point, OperLog operLog) throws Throwable { long start System.currentTimeMillis(); Object result point.proceed(); long cost System.currentTimeMillis() - start; // 异步写入日志表避免影响主流程 logService.save(point.getSignature().getName(), operLog.value(), cost); return result; } }参数说明Around环绕通知能拿到方法执行前后的时间算出耗时。日志写入建议用Async异步执行否则每次操作都同步写库会拖慢响应。这个技巧在答辩时能引出面向切面编程的话题属于能主动展开讲的知识点。最后说个我自己的习惯毕业设计做完后把整个项目从零再搭一遍。第一遍是摸索第二遍才是真正理解。我当年做类似项目时第一遍跑通花了两周第二遍重搭只用了两天而且发现了第一版里一堆冗余代码和设计缺陷。答辩老师问的往往不是这个功能怎么实现的而是你为什么这么设计只有重搭过一遍你才能答得理直气壮。希望帮到你。本文还有配套的精品资源点击获取 基于SpringBoot的校园闲置物品交易网站毕业设计实战指南
简介这份毕业设计资源面向高校计算机相关专业学生提供基于Spring Boot框架的校园闲置物品交易网站完整实现方案适合需要完成课程设计或毕业设计、希望掌握Java Web全栈开发流程的学习者。压缩包为zip格式整体约78.44MB内含源码、数据库脚本、论文LW、PPT与演示视频等核心文件覆盖从需求分析到系统测试的完整环节。系统按管理员、用户与前台首页三类角色划分功能管理员负责用户管理、商品类型与信息管理、系统管理及订单管理用户可浏览商品、管理收藏与订单前台支持商品资讯、购物车与后台入口。论文部分包含系统结构设计、实体ER图、数据表设计、各功能模块实现及测试章节可帮助读者理解Spring Boot项目分层结构与数据库建模思路。目前已有108人学习适合作为同类交易平台开发的参考模板与答辩准备材料。1. 校园闲置物品交易网站从一份毕业设计到一个能跑起来的 SpringBoot 项目每年毕业季计算机专业的选题里总有一类经久不衰校园闲置物品交易网站。原因很实在——需求真实、边界清晰、技术栈主流答辩时老师一听就懂演示起来也不容易翻车。但真正动手做的时候很多人卡在同一个地方网上搜到的 SpringBoot 教程要么是电商全栈要么是博客系统套到校园闲置这个场景上字段对不上、流程接不上、数据库表设计得七零八落。这篇笔记就围绕基于 SpringBoot 的校园闲置物品交易网站这个标题把从技术选型、数据库设计、核心功能实现到部署演示的完整路径拆开讲。适合两类人一是正在做这个毕业设计、需要一份能照着复现的落地参考的同学二是想拿一个中小型 SpringBoot 项目练手、熟悉前后端分离开发流程的开发者。我不会假设你手里已经有一份现成源码而是按如果从零开始做我会怎么搭的思路来写中间该给的代码、表结构、参数配置都会给到坑也会提前标出来。需要说明的是毕业设计通常还要求配套的论文LW、PPT 和演示视频这些属于交付物层面的东西本文聚焦在系统本身怎么实现因为只有系统跑通了后面的文档和演示才有东西可写。技术栈上主流做法是 SpringBoot MyBatis-Plus MySQL Vue/Thymeleaf本文以这个组合为主线展开。2. 技术选型与项目骨架为什么这套组合最适合校园闲置场景2.1 为什么是 SpringBoot 而不是 SSM 或 Servlet校园闲置物品交易网站的功能量级不大用户注册登录、发布商品、浏览搜索、下单、留言、后台管理撑死十几个模块。这种量级下SpringBoot 的核心价值是省配置。传统 SSM 要手写一堆 XML光是applicationContext.xml、spring-mvc.xml、mybatis-config.xml三个文件就能劝退一批人而且版本冲突是玄学级别的痛。SpringBoot 用 starter 把依赖版本锁死application.yml一个文件搞定数据源、端口、日志起步成本低很多。另一个现实原因是资料多、报错好搜。毕业设计最怕的不是功能难而是卡在一个冷门报错上三天出不来。SpringBoot 生态成熟你遇到的 90% 问题搜索引擎里都有现成答案。相比之下如果选一个冷门框架答辩前一周出问题可能连问的人都找不到。版本选择上有个血泪经验别追最新版。SpringBoot 3.x 要求 JDK 17很多学校的实验环境还停留在 JDK 8一编译就报Unsupported class file major version。稳妥做法是用 SpringBoot 2.7.x 配 JDK 8兼容性最好网上教程也最多。如果你的环境确实是 JDK 17那用 3.x 也没问题但要注意javax.*换成了jakarta.*很多老代码直接复制会编译不过。2.2 项目骨架与依赖配置一个能跑的最小骨架pom.xml里核心依赖就这几块Web、MyBatis-Plus、MySQL 驱动、Lombok。下面是我一般会用的依赖配置dependencies !-- Web 起步依赖提供内嵌 Tomcat 和 MVC -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus比原生 MyBatis 少写大量 CRUD -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- MySQL 驱动8.x 版本注意驱动类名带 cj -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency !-- Lombok用注解生成 getter/setter减少样板代码 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies逻辑说明spring-boot-starter-web是 Web 项目的根没有它连 Controller 都跑不起来MyBatis-Plus 的 starter 会自动装配 SqlSessionFactory省去手写配置类MySQL 驱动版本要和你的数据库服务端匹配8.0 的驱动连 5.7 的库一般没问题反过来容易出时区报错。参数说明MyBatis-Plus 版本选 3.5.x 系列和 SpringBoot 2.7 兼容良好如果升到 SpringBoot 3.xMyBatis-Plus 要用 3.5.3 以上并换成mybatis-plus-spring-boot3-starter否则启动会报找不到 Bean。application.yml里几个必调参数server: port: 8080 # 端口被占用就换 8081 spring: datasource: url: jdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: map-underscore-to-camel-case: true # 下划线字段自动映射驼峰属性 global-config: db-config: logic-delete-field: deleted # 逻辑删除字段 logic-delete-value: 1 logic-not-delete-value: 0这里serverTimezoneAsia/Shanghai是必须的不加的话 MySQL 8 会报时区错误这是新手最常见的翻车点之一。map-underscore-to-camel-case打开后数据库的user_name能自动映射到 Java 的userName省掉一堆Results注解。3. 数据库设计校园闲置场景下最容易设计错的几张表3.1 核心表结构与字段说明校园闲置交易和通用电商最大的区别在于商品是二手的、唯一的、卖完即止所以库存概念弱化取而代之的是商品状态。下面是我一般会用的核心表设计共 6 张主表。表名作用关键字段user用户学生id, username, password, nickname, phone, campus, credit_scorecategory商品分类id, name, sortgoods闲置商品id, title, price, cover, description, category_id, seller_id, status, view_countorder订单id, order_no, goods_id, buyer_id, seller_id, amount, status, create_timemessage留言/私信id, goods_id, from_user, to_user, content, is_readnotice公告id, title, content, create_timegoods表的status字段是设计重点一般用枚举值0 待审核、1 在售、2 已售、3 下架。很多同学一开始只用一个is_sold布尔字段结果后台审核、用户下架、交易完成三种状态混在一起逻辑越写越乱。状态字段一定要预留够这是血泪经验。order表要冗余存seller_id虽然可以通过goods_id关联查出来但订单列表页要频繁展示卖家信息每次 join 查询性能差冗余一个字段能省不少事。这是典型的用空间换查询效率在中小项目里完全值得。3.2 建表 SQL 与索引建议CREATE TABLE goods ( id BIGINT NOT NULL AUTO_INCREMENT, title VARCHAR(100) NOT NULL COMMENT 商品标题, price DECIMAL(10,2) NOT NULL COMMENT 价格, cover VARCHAR(255) DEFAULT NULL COMMENT 封面图路径, description TEXT COMMENT 详细描述, category_id INT NOT NULL COMMENT 分类ID, seller_id BIGINT NOT NULL COMMENT 卖家ID, status TINYINT DEFAULT 1 COMMENT 0待审 1在售 2已售 3下架, view_count INT DEFAULT 0 COMMENT 浏览量, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, deleted TINYINT DEFAULT 0 COMMENT 逻辑删除, PRIMARY KEY (id), KEY idx_category (category_id), KEY idx_seller (seller_id), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明price用DECIMAL而不是FLOAT因为浮点数算钱会出现0.10.20.30000000000000004这种精度问题答辩时被问到会很难看。description用TEXT因为商品描述可能较长。三个索引分别对应按分类筛选查我的发布按状态过滤三个高频查询场景。参数说明utf8mb4而不是utf8因为要支持 emoji学生发商品描述时经常带表情。deleted字段配合前面 MyBatis-Plus 的逻辑删除配置删除商品时只改标记不真删方便后台追溯。提示建表时字段注释一定要写全。答辩老师翻数据库的时候看到一堆没有注释的字段印象分会打折而且后期自己维护也容易忘。4. 核心功能实现发布、搜索、下单三条主线的代码落地4.1 商品发布与图片上传发布商品是系统的入口功能涉及表单提交和文件上传。Controller 层大致长这样RestController RequestMapping(/api/goods) public class GoodsController { Autowired private GoodsService goodsService; // 发布商品接收表单和封面图 PostMapping(/publish) public Result publish(RequestParam(file) MultipartFile file, Goods goods, RequestParam Long sellerId) { // 1. 保存图片到本地磁盘返回访问路径 String coverPath fileService.save(file); goods.setCover(coverPath); goods.setSellerId(sellerId); goods.setStatus(1); // 直接上架也可设为 0 走审核 goodsService.save(goods); return Result.success(发布成功); } }逻辑说明MultipartFile接收上传文件Goods对象由 Spring 自动绑定表单字段。先存图片再存商品保证cover字段有值。Result是自定义的统一返回体包含 code、msg、data 三个字段前端好处理。参数说明file参数名要和前端input namefile一致否则报Required request part file is not present。图片存储路径建议放在项目外的独立目录比如D:/campus-upload/不要放在src/main/resources下因为打包成 jar 后那个目录是只读的写不进去。文件上传大小限制要在application.yml里放开默认只有 1MB传张手机拍的照片就超了spring: servlet: multipart: max-file-size: 10MB max-request-size: 20MB4.2 商品搜索与分页搜索是闲置交易的核心体验用户要能按关键词、分类、价格区间筛选。用 MyBatis-Plus 的LambdaQueryWrapper可以很优雅地实现public PageGoods search(String keyword, Integer categoryId, BigDecimal minPrice, BigDecimal maxPrice, int page, int size) { LambdaQueryWrapperGoods wrapper new LambdaQueryWrapper(); // 关键词模糊匹配标题 wrapper.like(StringUtils.hasText(keyword), Goods::getTitle, keyword); // 分类精确匹配 wrapper.eq(categoryId ! null, Goods::getCategoryId, categoryId); // 价格区间 wrapper.ge(minPrice ! null, Goods::getPrice, minPrice); wrapper.le(maxPrice ! null, Goods::getPrice, maxPrice); // 只查在售商品按发布时间倒序 wrapper.eq(Goods::getStatus, 1); wrapper.orderByDesc(Goods::getCreateTime); return goodsService.page(new Page(page, size), wrapper); }逻辑说明LambdaQueryWrapper的每个条件方法第一个参数是布尔值为 true 时才拼接该条件这样就能实现参数为空则忽略的动态查询不用写一堆 if。like默认是%keyword%全模糊数据量大时索引失效但校园项目数据量小可以接受。参数说明page从 1 开始size建议默认 10 或 12对应前端一页展示的商品数。orderByDesc按时间倒序保证新发布的商品排前面符合用户预期。注意如果搜索关键词包含%或_会被当成 SQL 通配符导致查询结果异常。稳妥做法是在传入前做转义或者用apply手动拼条件。4.3 下单流程与并发处理下单是唯一涉及数据一致性的地方。校园闲置的特点是一件商品只能卖给一个人所以下单时要防止两个用户同时买同一件商品。最朴素也最有效的做法是用乐观锁或状态判断Transactional public Result createOrder(Long goodsId, Long buyerId) { // 1. 查询商品判断是否在售 Goods goods goodsService.getById(goodsId); if (goods null || goods.getStatus() ! 1) { return Result.fail(商品已售出或已下架); } // 2. 更新商品状态用 status1 作为条件防止并发 boolean updated goodsService.lambdaUpdate() .eq(Goods::getId, goodsId) .eq(Goods::getStatus, 1) .set(Goods::getStatus, 2) .update(); if (!updated) { return Result.fail(手慢了商品已被抢走); } // 3. 生成订单 Order order new Order(); order.setOrderNo(generateOrderNo()); order.setGoodsId(goodsId); order.setBuyerId(buyerId); order.setSellerId(goods.getSellerId()); order.setAmount(goods.getPrice()); order.setStatus(0); // 待付款 orderService.save(order); return Result.success(下单成功); }逻辑说明关键在于第 2 步update语句带了status1的条件如果另一个线程已经把状态改成 2这次更新影响行数为 0updated为 false直接返回失败。这就是用数据库的原子性做并发控制比加锁简单可靠。Transactional保证订单生成和状态更新要么都成功要么都回滚。参数说明generateOrderNo()一般用时间戳 用户ID后四位 随机数生成保证唯一且可读。订单状态 0 待付款、1 已付款、2 已完成、3 已取消和商品状态是两套独立的状态机别混用。5. 避坑与排查这个项目里我踩过的 5 个坑5.1 坑一跨域请求被浏览器拦截现象前端 Vue 跑在 8081 端口后端 SpringBoot 跑在 8080调接口时浏览器控制台报Access to XMLHttpRequest has been blocked by CORS policy。原因浏览器的同源策略协议、域名、端口任一不同就算跨域后端没返回 CORS 响应头。解决加一个全局跨域配置类或者用注解。全局配置更省事Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) // 允许所有来源 .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true) .maxAge(3600); } }注意allowedOriginPatterns而不是allowedOrigins因为allowCredentials(true)和allowedOrigins(*)不能同时用会报错。5.2 坑二MyBatis-Plus 逻辑删除后查询不到数据现象删除了一个商品再查列表发现所有商品都没了或者删除的商品还能查到。原因逻辑删除字段配置和实体类注解不一致。要么application.yml里配了logic-delete-field实体类没加TableLogic要么字段名对不上。解决二选一要么全局配置要么实体类加注解别重复配。实体类上写TableLogic后deleteById会自动变成UPDATE ... SET deleted1查询自动带WHERE deleted0。如果发现删除后还能查到检查是不是字段名写成了is_deleted而配置里写的是deleted。5.3 坑三图片上传后访问 404现象图片上传成功数据库里路径也对但前端img src显示不出来控制台 404。原因图片存在磁盘目录但没配置静态资源映射SpringBoot 不知道这个目录要对外暴露。解决加一个 WebMvcConfigurer 配置把上传目录映射到访问路径Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 访问 /upload/** 时去 D:/campus-upload/ 目录找文件 registry.addResourceHandler(/upload/**) .addResourceLocations(file:D:/campus-upload/); }路径末尾的斜杠不能少少了会拼错路径。Linux 服务器上路径换成/home/upload/这种形式。5.4 坑四打包成 jar 后运行报数据库连接失败现象IDEA 里跑得好好的mvn package打成 jar 后java -jar启动报Communications link failure。原因application.yml里的数据库地址写的是localhost但打包后如果换机器运行或者 MySQL 没启动就连不上。还有一种情况是配置文件被打进了 jar改配置要重新打包。解决把application.yml外置到 jar 同级目录启动时用--spring.config.location指定。或者用application-prod.yml区分环境。另外确认 MySQL 服务已启动端口 3306 没被防火墙拦。5.5 坑五答辩演示时前端页面白屏现象本地一切正常答辩现场打开页面一片空白F12 报Failed to load resource。原因前端打包后的静态资源路径是绝对路径/static/js/xxx.js部署到子目录或者用 file 协议打开就找不到。解决Vue 项目在vue.config.js里设publicPath: ./用相对路径。如果是前后端不分离的 Thymeleaf 项目确认模板文件放在templates下静态资源放在static下别放错目录。答辩前一定要在另一台电脑上完整跑一遍别只在自己机器上测。6. 让项目更耐问三个能加分的进阶技巧6.1 用 Redis 缓存热门商品列表答辩时如果老师问你这个系统性能怎么样能答上缓存就是加分项。校园闲置的首页商品列表访问频率最高可以加一层 Redis 缓存。做法是在查询前先查 Redis命中就返回没命中查数据库再写回缓存设置 5 分钟过期。public ListGoods getHotList() { String key goods:hot; // 先查缓存 ListGoods cached (ListGoods) redisTemplate.opsForValue().get(key); if (cached ! null) { return cached; } // 缓存没有查数据库 ListGoods list goodsService.lambdaQuery() .eq(Goods::getStatus, 1) .orderByDesc(Goods::getViewCount) .last(LIMIT 20) .list(); // 写回缓存5 分钟过期 redisTemplate.opsForValue().set(key, list, 5, TimeUnit.MINUTES); return list; }参数说明LIMIT 20控制缓存数据量别把整张表缓存进去。过期时间 5 分钟是平衡实时性和性能商品发布后最多 5 分钟出现在热门列表可以接受。注意实体类要实现Serializable否则 Redis 序列化会报错。6.2 加一个简单的敏感词过滤校园场景下商品描述和留言可能出现不当内容加个敏感词过滤能体现你的工程意识。最简单的做法是维护一个敏感词列表提交前做替换private static final ListString SENSITIVE_WORDS Arrays.asList(违禁词1, 违禁词2); public String filter(String content) { if (content null) return null; for (String word : SENSITIVE_WORDS) { if (content.contains(word)) { content content.replace(word, ***); } } return content; }在发布商品和发送留言的入口调用这个方法。词库可以放在配置文件或数据库里方便后台维护。这个功能代码量小但答辩时能讲出内容安全这个点比纯 CRUD 有深度。6.3 用 AOP 记录操作日志后台管理操作审核商品、删除用户最好留痕。用 Spring AOP 加一个切面拦截带自定义注解的方法把操作人、操作类型、时间写进日志表Aspect Component public class LogAspect { Around(annotation(operLog)) public Object around(ProceedingJoinPoint point, OperLog operLog) throws Throwable { long start System.currentTimeMillis(); Object result point.proceed(); long cost System.currentTimeMillis() - start; // 异步写入日志表避免影响主流程 logService.save(point.getSignature().getName(), operLog.value(), cost); return result; } }参数说明Around环绕通知能拿到方法执行前后的时间算出耗时。日志写入建议用Async异步执行否则每次操作都同步写库会拖慢响应。这个技巧在答辩时能引出面向切面编程的话题属于能主动展开讲的知识点。最后说个我自己的习惯毕业设计做完后把整个项目从零再搭一遍。第一遍是摸索第二遍才是真正理解。我当年做类似项目时第一遍跑通花了两周第二遍重搭只用了两天而且发现了第一版里一堆冗余代码和设计缺陷。答辩老师问的往往不是这个功能怎么实现的而是你为什么这么设计只有重搭过一遍你才能答得理直气壮。希望帮到你。本文还有配套的精品资源点击获取