简介本资源为基于SpringBoot的校园二手交易平台Java项目源码与数据库设计面向计算机相关专业高年级学生适用于课程设计、毕业设计及项目实战训练难度中等。系统采用模块化架构涵盖用户管理、商品展示、交易撮合、订单处理等核心模块技术栈包括SpringBoot 2.x、MyBatis Plus、Redis缓存与Shiro权限控制实现前后端分离数据库遵循第三范式使用MySQL存储前端响应式布局支持多终端适配。压缩包共262个文件约3.88MB以34个java源码、24个js脚本、17个html页面、7个css样式及gif、jpg等静态资源为主另含sql数据库文件、xml配置与md说明文档代码结构清晰、注释完整。项目文档提供系统设计说明书、数据库设计文档、部署指南及API接口文档便于二次开发与功能扩展。目前已有80人学习下载适合需要完整项目参考与实战练习的学习者。1. 校园二手交易平台为什么总在“数据库设计”这一步翻车每年毕业季校园里最活跃的不是食堂而是各种二手群。教材、自行车、显示器、考研资料交易需求真实存在但真正动手做一个基于 SpringBoot 的校园二手交易平台时很多人卡住的地方不是前端页面而是数据库设计。我见过太多课程设计案例源码表建得随心所欲商品和订单字段混在一起用户信息表里塞了登录日志跑起来能演示一改需求就崩。这个标题拆开看是三件事SpringBoot 做后端骨架、校园二手交易平台做业务场景、源码与数据库设计做交付物。它解决的是“从零到能跑通一笔真实交易”的问题适合做课程设计的学生、想练手 SpringBoot 的 Java 初学者以及需要一套可扩展二手交易后端模型的开发者。数据库设计一旦立住后面的接口、分页、状态流转都是顺水推舟设计塌了写再多 Controller 也是给黑匣子刷漆。2. 先把表结构定死用户、商品、订单三张核心表怎么拆2.1 校园二手场景下实体关系的真实边界校园二手交易和闲鱼这类综合平台最大的区别是交易半径小、信任成本低、商品非标。这决定了数据库设计不需要复杂的风控表、物流表、仲裁表但必须把“谁卖的、卖给谁、什么时候成交”这条链路留清楚。常见做法是围绕三个核心实体展开用户user、商品item、订单orders。用户发布商品商品被下单生成订单订单完成后商品状态变更。这里有个容易翻车的地方很多人把“商品”和“订单”合成一张表用 status 字段区分。演示时没问题一旦要查“我买过的所有东西”或“我卖出的所有东西”SQL 就会变成一堆 or 条件。正确做法是商品表只描述商品本身订单表记录交易关系两者通过 item_id 关联。用户表则要区分买家和卖家角色但不必建两张表用同一个 user 表加角色字段即可。另一个边界是图片。校园二手商品通常有 1 到 3 张图不建议在商品表里存图片二进制而是存 URL 或相对路径图片文件放本地磁盘或对象存储。这样数据库轻备份快迁移也方便。2.2 建表 SQL 与字段类型选择下面是我一般会用的建表语句MySQL 8.0 环境下可直接执行。注意字符集用 utf8mb4校园场景里商品描述可能包含 emoji 或生僻字。-- 用户表校园二手平台用户信息表 CREATE TABLE user ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 用户ID, student_no VARCHAR(20) NOT NULL COMMENT 学号校园内唯一标识, nickname VARCHAR(30) NOT NULL COMMENT 昵称, password VARCHAR(100) NOT NULL COMMENT BCrypt加密后的密码, phone VARCHAR(15) DEFAULT NULL COMMENT 手机号, avatar VARCHAR(255) DEFAULT NULL COMMENT 头像URL, credit_score INT DEFAULT 100 COMMENT 信用分初始100, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 注册时间, PRIMARY KEY (id), UNIQUE KEY uk_student_no (student_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用户信息表; -- 商品表二手商品信息 CREATE TABLE item ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 商品ID, seller_id BIGINT NOT NULL COMMENT 卖家用户ID, title VARCHAR(100) NOT NULL COMMENT 商品标题, description TEXT COMMENT 详细描述, price DECIMAL(10,2) NOT NULL COMMENT 售价保留两位小数, original_price DECIMAL(10,2) DEFAULT NULL COMMENT 原价用于展示折扣, category VARCHAR(20) NOT NULL COMMENT 分类教材/电子/生活/其他, cover_image VARCHAR(255) DEFAULT NULL COMMENT 封面图URL, status TINYINT DEFAULT 0 COMMENT 0在售 1已售 2下架, view_count INT DEFAULT 0 COMMENT 浏览量, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 发布时间, PRIMARY KEY (id), KEY idx_seller (seller_id), KEY idx_category_status (category, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT二手商品表; -- 订单表交易订单 CREATE TABLE orders ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 订单ID, order_no VARCHAR(32) NOT NULL COMMENT 业务订单号, item_id BIGINT NOT NULL COMMENT 商品ID, buyer_id BIGINT NOT NULL COMMENT 买家用户ID, seller_id BIGINT NOT NULL COMMENT 卖家用户ID, amount DECIMAL(10,2) NOT NULL COMMENT 成交金额, status TINYINT DEFAULT 0 COMMENT 0待确认 1已确认 2已完成 3已取消, remark VARCHAR(200) DEFAULT NULL COMMENT 买家留言, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 下单时间, finish_time DATETIME DEFAULT NULL COMMENT 完成时间, PRIMARY KEY (id), UNIQUE KEY uk_order_no (order_no), KEY idx_buyer (buyer_id), KEY idx_item (item_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT订单表;逻辑说明user 表的 student_no 加唯一索引是因为校园场景下学号天然唯一比手机号更可靠。item 表的 price 用 DECIMAL 而不是 FLOAT避免金额计算出现 0.10.2 的玄学问题。orders 表冗余了 seller_id虽然可以通过 item_id 关联查出来但订单列表页需要频繁展示卖家信息冗余一个字段能省一次 join这是典型的以空间换查询效率。参数说明status 字段用 TINYINT 而不是 ENUM因为 ENUM 在后续加状态时要改表结构TINYINT 配合代码里的常量更灵活。create_time 用 DATETIME 而不是 TIMESTAMP避免 2038 问题校园项目生命周期短但养成习惯没坏处。2.3 索引不是越多越好三个必须建的索引和两个别碰的索引必须建的索引user.student_no 唯一索引、item 的 (category, status) 联合索引、orders 的 buyer_id 和 item_id 索引。联合索引的顺序有讲究category 在前是因为分类筛选是高频操作status 在后用于过滤已售商品。别碰的索引item.title 不要建全文索引校园二手商品标题短且非结构化用 LIKE %关键词% 就够了建全文索引反而增加写入负担。orders.create_time 不要单独建索引订单量在校园场景下不会大到需要按时间范围扫描如果真要查“最近订单”用 id 倒序即可。提示建完表后执行SHOW INDEX FROM item;确认索引生效别等上线才发现索引建错列。3. SpringBoot 项目骨架怎么搭从 pom 到第一个可访问接口3.1 依赖选型springboot 版本太高会带来什么麻烦热搜里有人问“springboot版本太高”怎么办这是真实痛点。SpringBoot 3.x 要求 Java 17 起步而很多学校机房还在用 JDK 8。我的建议是如果课程设计环境不可控直接用 SpringBoot 2.7.x 配 JDK 8 或 11稳定且资料多。如果自己电脑环境自由用 SpringBoot 3.2.x 配 JDK 17体验更好。pom.xml 里核心依赖就几个spring-boot-starter-web 做 REST 接口mybatis-plus-boot-starter 做数据库操作mysql-connector-java 做驱动lombok 省 getter/setter。别一上来就加 spring-boot-starter-security校园项目用简单的拦截器加 token 就够了Security 的配置复杂度会吃掉你一半调试时间。parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies逻辑说明MyBatis-Plus 比原生 MyBatis 省去了大量 XML 配置分页插件、逻辑删除、自动填充都能开箱即用。版本选 3.5.3.1 是因为它和 SpringBoot 2.7.x 兼容性经过大量项目验证不会出现启动时 Bean 冲突。参数说明mysql-connector-java 的 scope 设为 runtime因为编译时不需要驱动类只在运行时加载。lombok 设为 optional避免传递依赖到其他模块。3.2 application.yml 里数据库和 MyBatis-Plus 的关键配置配置文件是新手最容易抄错的地方。下面这份配置我用了很多次直接改数据库名和密码就能跑。server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai username: root password: your_password servlet: multipart: max-file-size: 5MB max-request-size: 20MB mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: id-type: auto logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0逻辑说明map-underscore-to-camel-case 开启后数据库的 create_time 会自动映射到 Java 对象的 createTime省去手写 ResultMap。log-impl 设为 StdOutImpl 会在控制台打印 SQL调试阶段必开上线前记得关掉或改成日志框架。参数说明url 里的 serverTimezone 必须设否则 MySQL 8 会报时区错误。max-file-size 限制单文件 5MB校园二手图片通常不超过 2MB留点余量。logic-delete-field 是 MyBatis-Plus 的逻辑删除配置需要在表里加 deleted 字段如果不想用可以删掉这三行。3.3 用代码生成器或手写第一个 Item 查询接口如果表已经建好可以用 MyBatis-Plus 的代码生成器一键生成 Entity、Mapper、Service、Controller。但我不建议完全依赖生成器至少手写一个查询接口理解整个链路。RestController RequestMapping(/api/item) public class ItemController { Autowired private ItemService itemService; // 分页查询在售商品支持按分类过滤 GetMapping(/list) public ResultPageItem list( RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 10) Integer size, RequestParam(required false) String category) { PageItem pageParam new Page(page, size); LambdaQueryWrapperItem wrapper new LambdaQueryWrapper(); wrapper.eq(Item::getStatus, 0); // 只查在售 if (StringUtils.hasText(category)) { wrapper.eq(Item::getCategory, category); } wrapper.orderByDesc(Item::getCreateTime); return Result.success(itemService.page(pageParam, wrapper)); } }逻辑说明LambdaQueryWrapper 用方法引用代替字符串字段名重构时不会因为改字段名而漏改 SQL。status 固定为 0 是业务约束在售商品才对外展示。orderByDesc 按发布时间倒序符合二手交易“最新发布优先”的直觉。参数说明page 和 size 给了默认值前端不传也能正常返回。category 用 requiredfalse因为首页可能展示全部商品。Result 是自定义的统一返回体包含 code、msg、data 三个字段这里不展开。注意如果启动时报Invalid bound statement先检查 Mapper 接口有没有加Mapper注解或者启动类上有没有MapperScan。4. 交易状态流转与并发下单校园二手平台最容易踩的坑4.1 订单状态机设计为什么不能只用 0 和 1校园二手交易的状态比想象中多。一个商品从发布到成交至少经历在售、待确认、已确认、已完成、已取消。如果只用 0 和 1 表示“未售”和“已售”买家下单后卖家还没确认商品到底算不算卖出这时候就需要中间状态。我一般把订单状态定义为0 待卖家确认、1 卖家已确认、2 交易完成、3 已取消。商品状态同步为0 在售、1 锁定中、2 已售、3 下架。当买家下单时商品状态从 0 变 1订单状态为 0。卖家确认后订单变 1商品保持 1。买家确认收货后订单变 2商品变 2。任何一方取消订单变 3商品回到 0。这个状态机要用数据库事务包住否则会出现商品锁定了但订单没生成或者订单生成了商品还在售。下面是一个简化的下单逻辑。Transactional(rollbackFor Exception.class) public ResultString createOrder(Long itemId, Long buyerId) { // 1. 查询商品并加行锁防止并发下单 Item item itemMapper.selectByIdForUpdate(itemId); if (item null || item.getStatus() ! 0) { return Result.error(商品已售出或不存在); } if (item.getSellerId().equals(buyerId)) { return Result.error(不能购买自己发布的商品); } // 2. 锁定商品 item.setStatus(1); itemMapper.updateById(item); // 3. 生成订单 Orders order new Orders(); order.setOrderNo(generateOrderNo()); order.setItemId(itemId); order.setBuyerId(buyerId); order.setSellerId(item.getSellerId()); order.setAmount(item.getPrice()); order.setStatus(0); orderMapper.insert(order); return Result.success(order.getOrderNo()); }逻辑说明selectByIdForUpdate 对应 SQL 里的SELECT ... FOR UPDATE在事务中锁住这一行防止两个买家同时下单同一商品。先检查卖家不能买自己的商品这是校园场景的常见约束。锁定商品和生成订单在同一个事务里任何一步失败都回滚。参数说明rollbackFor Exception.class 确保所有异常都触发回滚默认只回滚 RuntimeException。generateOrderNo 可以用时间戳加随机数或者用雪花算法校园项目量级用前者足够。4.2 用乐观锁还是悲观锁校园场景下的选择依据上面用的是悲观锁FOR UPDATE适合并发写冲突高的场景。但校园二手平台并发其实很低一个商品同时被两个人下单的概率不大。如果不想用悲观锁可以用乐观锁在 item 表加 version 字段更新时带 version 条件。UPDATE item SET status 1, version version 1 WHERE id ? AND status 0 AND version ?;如果返回影响行数为 0说明被其他人抢先了。乐观锁的好处是不占数据库连接坏处是失败后要重试。我的建议是课程设计用悲观锁代码直观如果项目要上线且商品热度高用乐观锁加 Redis 分布式锁。提示无论用哪种锁都要在测试时用 JMeter 或两个浏览器同时下单验证别凭感觉认为“应该没问题”。4.3 分页查询的坑MyBatis-Plus 分页插件没配等于白写热搜里有人问“mybatis的分页插件的用法 springboot”这是高频问题。MyBatis-Plus 的分页功能需要手动注册拦截器不注册的话 page 参数不生效返回的是全部数据。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }逻辑说明PaginationInnerInterceptor 是分页拦截器DbType.MYSQL 指定数据库类型它会自动把SELECT * FROM item改写成带 LIMIT 的语句。如果不指定 DbType某些版本会报错。参数说明这个配置类要放在启动类能扫描到的包下否则不生效。如果项目里同时用了多个拦截器注意 addInnerInterceptor 的顺序分页拦截器通常放最后。5. 避坑与排查校园二手项目从能跑到能用的五条血泪经验5.1 现象接口返回中文乱码数据库里却是好的原因数据库连接 URL 没加 characterEncodingutf8mb4或者 SpringBoot 的 HTTP 编码没配。MySQL 8 默认字符集是 utf8mb4但 JDBC 驱动不一定按默认走。解决在 application.yml 的 url 里显式加characterEncodingutf8mb4同时在spring.http.encoding下配置charset: UTF-8和force: true。如果还乱码检查数据库和表的字符集是不是 utf8mb4。5.2 现象上传商品图片后重启项目图片全没了原因图片存在了项目临时目录SpringBoot 重启时临时目录被清理。或者用了System.getProperty(java.io.tmpdir)这种路径。解决在 application.yml 里配置一个固定的上传路径比如file.upload-path: /data/campus-trade/upload/然后用ResourceHandlerRegistry把该路径映射为静态资源访问路径。别把图片存数据库也别存项目 resources 目录。5.3 现象订单列表查询越来越慢明明数据不多原因orders 表没有建 buyer_id 索引或者建了但查询条件用了DATE(create_time) ?导致索引失效。解决确认 buyer_id 和 item_id 都有索引。查询时避免在字段上套函数比如要查“今天的订单”用create_time ? AND create_time ?代替DATE(create_time) CURDATE()。5.4 现象SpringBoot 启动报Table xxx doesnt exist但数据库里明明有原因数据库连接 URL 里的数据库名写错了或者 MySQL 区分大小写表名实际是User但代码里写user。解决先执行SELECT DATABASE();确认当前库再执行SHOW TABLES;确认表名。Linux 下 MySQL 默认区分表名大小写建表时统一用小写加下划线。5.5 现象前端传的 JSON 日期格式报错后端接收不到原因Java 8 的 LocalDateTime 默认序列化格式是 ISO 8601前端传2024-01-01 12:00:00会解析失败。解决在实体类的日期字段上加JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)或者在全局配置里统一设置 Jackson 的日期格式。别用 java.util.DateLocalDateTime 更清晰。6. 让数据库设计经得起追问从课程设计到可演示项目的最后一步走到这里表建好了接口能跑了订单能下了。但课程设计答辩或项目演示时老师或面试官往往会追问一句“如果我要查某个用户买过的所有商品你的 SQL 怎么写”这时候如果你的表结构是清晰的答案就是一句 join。-- 查询用户ID为1001的买家所有已完成订单的商品信息 SELECT o.order_no, o.amount, o.finish_time, i.title, i.cover_image FROM orders o INNER JOIN item i ON o.item_id i.id WHERE o.buyer_id 1001 AND o.status 2 ORDER BY o.finish_time DESC;这条 SQL 能跑通说明你的数据库设计是自洽的。如果跑不通或者要写三层子查询那说明表拆得有问题。我一般会在项目收尾时做三件事第一把每个核心查询写成 SQL 存到项目文档里方便答辩时直接展示第二用EXPLAIN看一遍执行计划确认没有全表扫描第三把建表语句和初始化数据整理成一个schema.sql别人拿到就能一键导入。还有一个容易被忽略的点数据库设计文档。热搜里有人搜“苍穹外卖数据库设计文档”说明大家需要参考模板。校园二手平台的文档不用复杂一张表说明字段含义、类型、约束再加一张 ER 图就够了。ER 图不用工具画用文字描述关系也行user 1 对 N itemuser 1 对 N ordersitem 1 对 N orders。最后说一个我自己的习惯每次改表结构一定先备份数据再写迁移 SQL最后在测试库跑一遍。我见过太多人直接在生产库改字段结果类型不兼容导致数据截断后悔药都没得吃。校园项目虽然数据不重要但这个习惯从学生时代养成工作后能少背很多锅。希望帮到你。本文还有配套的精品资源点击获取