Spring Boot二手交易系统源码实战：架构设计、核心模块与二次开发

简介这套源码是一套基于Spring Boot开发的二手交易系统前后端实现适合计算机相关专业学生和Java Web初学者可作课程设计或毕业设计参考。系统覆盖商品发布与分页查询、用户注册登录JWT令牌认证、订单创建与状态管理、商品留言等核心模块从前端Vue页面到后端接口形成完整链路。整包共138个文件压缩包大小约4.05MB以31个Java源码、18个Vue组件、36个编译class、11个XML配置以及12份Word文档、图片等辅助资料为主便于导入开发工具查看与二次开发。目前已有65人浏览学习。借助这份资料可一边对照Vue界面一边阅读后端代码重点学习JWT权限控制、分页查询、订单状态流转等典型业务实现快速理解Spring Boot Vue前后端分离项目的协作方式对了解二手交易平台开发流程也具有不错的参考价值整体可读性和完整性较好。 手头正好有一套基于 Spring Boot 的二手交易系统源码打包成了 zip 分发给朋友学习。这里不聊那些虚的架构图直接把这套系统的设计思路、核心代码结构、踩过的坑以及怎么把它跑起来、改成自己能用的项目从头到尾捋一遍。无论你是刚学 Spring Boot 想找项目练手还是准备做毕业设计/课程设计或者想快速搭一个校园二手交易平台这篇内容应该都能给你省下不少时间。先说明一下这套系统不是玩具级别的那种 CRUD Demo它涵盖了用户注册登录、商品发布与管理、搜索筛选、下单购买、订单管理、个人中心等功能虽然比不上电商大厂的生产系统但作为学习和二次开发的基底结构上已经足够完整。源码打包成了 zip解压后导入 IDE 就能看到完整工程关键依赖和配置都在里面照着做基本能跑通。1. 项目整体设计与思路拆解1.1 为什么选 Spring Boot 而不是 SSM 或者别的框架先说结论Spring Boot 把 Spring 生态里那些繁琐的 XML 配置全部干掉了尤其是内嵌 Tomcat、自动配置、起步依赖这三大特性让开发体验直接拉满。对于二手交易这种典型的 Web 业务系统用 Spring Boot 去写团队协作时的成本最低新手也更容易看懂代码脉络。这套源码里我用了 Spring Boot 2.x 版本配合 MyBatis-Plus 做持久层。很多人可能会问为什么不直接用 JPA我的习惯是MyBatis-Plus 对于复杂 SQL 的控制粒度更细尤其在商品多条件筛选、订单状态流转这种场景下写 XML 里的动态 SQL 比 JPA 的派生查询直观得多而且 MyBatis-Plus 自带的BaseMapper提供了大量的单表 CRUD 方法简单操作用内置方法复杂操作用自定义 SQL两者结合非常舒服。还有一个点Spring Boot 的分层结构非常规整。这套源码也是标准的四层架构Controller 层接口入口、Service 层业务逻辑、Mapper 层数据访问、Entity 层数据库实体对象。有人可能觉得“四层架构”是老生常谈但真正写项目的时候很多新手把业务逻辑堆在 Controller 里一个方法几百行后面想维护都无从下手。这套源码里每个类都严格分层Service 接口和实现分开写也是为了让代码结构更清晰。1.2 二手交易系统的核心业务流程与功能模块二手交易和普通电商最大的不同点在于它的买家卖家都是个人用户商品的发布者同时也是平台使用者所以必须有完整的用户体系、商品生命周期管理、订单状态流转。这套系统的核心业务流是这样的用户注册/登录 - 发布商品 - 商品上架默认待审核/直接上架看配置 - 买家浏览/搜索 - 发起购买/联系卖家 - 生成订单 - 卖家确认交易 - 订单完成 - 双方评价可选功能模块上我拆成了六大块用户模块注册、登录、个人信息管理、密码加密存储、头像上传。商品模块发布商品标题、描述、价格、图片、分类、商品列表分页、商品详情、编辑/下架/删除商品、搜索与条件筛选。订单模块买家下单、卖家查看订单、确认交易、取消订单、删除订单。收藏模块用户的收藏商品列表、添加/取消收藏。评论模块对商品或交易的评论简单版实现。管理后台用户管理、商品管理、订单管理简单统计功能。模块之间不是孤立的比如商品发布时要校验用户是否登录下单时要校验商品状态订单生成后商品状态要改成“已被购买”这类状态同步逻辑是源码里最值得看的部分。2. 核心细节解析与实操要点2.1 源码目录结构与包命名规范拿到 zip 解压后先看整体目录结构。这套源码用的是 Maven 标准布局主包名是com.example.secondhand。下面把关键 package 和它的职责说下com.example.secondhand ├── common // 通用类统一返回结果、异常处理、常量定义 ├── config // 配置类拦截器、跨域、文件上传配置等 ├── controller // 控制层接收前端请求返回 JSON ├── entity // 实体类对应数据库表 ├── mapper // 数据访问接口继承 BaseMapper ├── service // 业务接口定义 │ └── impl // 业务实现类 ├── utils // 工具类JWT 工具、文件工具、字符串工具等 └── SecondhandApplication.java // 启动类很多人拿到别人的源码第一步不是导入 IDE而是先打开pom.xml看依赖。这套源码的依赖包括Spring Web、MyBatis-Plus、MySQL 驱动、Lombok、JWT用于登录令牌、Hutool工具库、Spring Validation 等。这些依赖基本覆盖了做小型业务系统会用到的全部组件。还有一个注意点application.yml里的配置。源码里默认配置了本地的 MySQL 连接库名是secondhand_db用户名root密码是123456。你自己跑的时候一定要根据本地数据库密码去改否则启动直接报连接异常。配置里还设置了 MyBatis-Plus 的逻辑删除、驼峰命名映射、分页插件等这些配置项是业务正常运行的关键。2.2 数据库设计的几个关键表与关联关系一套系统能不能扩展、维护是否方便看数据库设计就能知道个大概。二手交易系统的核心表我设计了七张分别是用户表、商品表、订单表、收藏表、评论表、商品图片表、分类表。这里挑三张最核心的表来分析。用户表t_user字段名类型说明idbigint主键自增usernamevarchar用户名唯一passwordvarchar密码BCrypt 加密后存储nicknamevarchar昵称avatarvarchar头像地址phonevarchar手机号create_timedatetime注册时间deletedtinyint逻辑删除标记商品表t_goods字段名类型说明idbigint主键user_idbigint发布者 IDcategory_idbigint分类 IDtitlevarchar商品标题descriptiontext商品描述pricedecimal价格单位元statusint状态0 在售1 已售出2 下架view_countint浏览次数create_timedatetime发布时间deletedtinyint逻辑删除订单表t_order字段名类型说明idbigint主键order_novarchar订单编号唯一goods_idbigint商品 IDbuyer_idbigint买家 IDseller_idbigint卖家 IDpricedecimal成交价格statusint状态0 待确认1 已完成2 已取消create_timedatetime下单时间这三张表之间的关联逻辑是商品表通过user_id关联用户表订单表通过goods_id关联商品表同时冗余了buyer_id和seller_id这样在查询订单列表时不需要反复 join 用户表去拿买卖双方的信息。这是典型的三层数据模型业务上很清晰。2.3 登录认证JWT 的前后端交互设计二手交易系统里用户登录后的会话保持不能依赖传统 Session因为现在前后端分离项目越来越普遍移动端也可能要接入。这套源码用了 JWTJSON Web Token作为登录令牌。具体过程是这样的用户提交用户名和密码UserService校验密码正确后用 jwt 工具类生成一个包含用户 ID 和过期时间的 token。后端把 token 返回给前端前端存到 localStorage 或请求头里。后续每次请求前端在请求头加上Authorization: Bearer token。后端通过拦截器解析 token如果能解析成功并且没过期就把用户信息放进ThreadLocal或 request 属性里供后续业务代码使用如果解析失败直接返回 401 提示未登录。这套设计里有个容易犯错的地方JWT 只做身份认证不做会话管理所以后端无法主动让某个 token 失效。如果要做“强制下线”功能就得引入 Redis 做 token 黑名单这套源码里没有加但对学习来说先把 JWT 基本的生成和解析逻辑弄明白是最重要的。使用拦截器时一定要在WebMvcConfig里配置好放行路径比如登录接口、注册接口、商品列表、商品详情这些不需要登录也能访问的接口都要加到excludePathPatterns里否则前端一进来就被拦截什么都看不了。这个坑我第二次写项目时还踩过。3. 实操过程与核心环节实现3.1 从 zip 解压到项目启动全流程我按自己实际操作的过程写一份完整的运行指南。第一步环境准备。JDK 1.8 或 11源码里 pom.xml 指定了 Java 1.8用高版本也能跑但要注意兼容性Maven 3.6MySQL 5.7 或 8.0IDEA 或 Eclipse。第二步解压源码压缩包。zip 包解压后你会看到完整的 Maven 工程目录。不要直接双击文件一个个打开应该用 IDEA 的File - Open选择解压后的目录里面有pom.xml。IDEA 会自动识别为 Maven 项目并开始下载依赖。第三步创建数据库。在 MySQL 里执行源码附带sql目录下的secondhand_db.sql脚本这个脚本建好了所有表和几条测试数据。注意如果本地 MySQL 字符集不是 utf8mb4建议建库时手动指定CREATE DATABASE secondhand_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;第四步修改数据库配置。打开src/main/resources/application.yml改成你本地 MySQL 的用户名和密码。如果 MySQL 版本是 8.0记得在 JDBC URL 后面加上?serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue否则会出现时区报错。第五步启动项目。运行SecondhandApplication.java的 main 方法。看到类似以下日志就说明启动成功Tomcat started on port(s): 8080 (http) Started SecondhandApplication in x.xxx seconds启动成功后浏览器访问http://localhost:8080/api/goods/list如果可以返回 JSON 数据说明你的环境没问题。3.2 商品发布功能的核心实现代码解析商品发布是整个二手交易系统里最重要、也最能体现细节的功能。前端提交表单后端需要接收商品基本信息以及图片上传。由于商品有多张图片我在前端用了一个MultipartFile[]数组来接收后端逐个保存文件并存入t_goods_image表再关联到商品 ID。先看 Controller 层的核心方法PostMapping(/add) public Result add(RequestBody GoodsAddDTO dto, HttpServletRequest request) { Long userId JwtUtil.getUserIdFromRequest(request); goodsService.addGoods(dto, userId); return Result.success(); }这里没有直接用Goods实体接收参数而是用了GoodsAddDTO。为什么因为前端传的参数包含图片列表而Goods实体类没有图片这个字段直接用实体接收反而麻烦。DTO 和实体分离在业务开发中是个好习惯尤其在接口参数复杂的时候。再看 Service 实现的关键部分Override Transactional(rollbackFor Exception.class) public void addGoods(GoodsAddDTO dto, Long userId) { Goods goods new Goods(); goods.setUserId(userId); goods.setTitle(dto.getTitle()); goods.setDescription(dto.getDescription()); goods.setPrice(dto.getPrice()); goods.setCategoryId(dto.getCategoryId()); goods.setStatus(0); goods.setViewCount(0); goodsMapper.insert(goods); // 保存图片列表 if (dto.getImages() ! null dto.getImages().length 0) { for (MultipartFile file : dto.getImages()) { String url fileService.uploadFile(file); GoodsImage image new GoodsImage(); image.setGoodsId(goods.getId()); image.setImageUrl(url); goodsImageMapper.insert(image); } } }注意到Transactional注解这是必须的。如果文件上传成功了但商品图片关联数据插入失败整个事务回滚不会残留脏数据。很多新手写到这里会漏掉事务控制结果数据库里商品的图片信息对不上后面排查半天。商品发布还有一个隐藏问题文件名重复。我用的是UUID.randomUUID()加原始文件后缀的方式生成新的文件名避免多人上传同名文件时互相覆盖。这个细节特别值得学随便用原始文件名保存用不了多久就会出问题。3.3 搜索与筛选功能MyBatis-Plus 动态 SQL 实战二手交易系统的商品列表既要支持分页又要支持按分类、价格区间、关键词搜索还要支持排序按时间、按价格。如果全用 Java 代码去判断拼接 SQL会非常啰嗦。我这里用了 MyBatis-Plus 的QueryWrapper配合Page来做。Service 里的查询逻辑大概这样Override public PageGoodsVO queryGoodsList(GoodsQueryDTO queryDTO) { PageGoods page new Page(queryDTO.getPageNum(), queryDTO.getPageSize()); LambdaQueryWrapperGoods wrapper new LambdaQueryWrapper(); wrapper.eq(Goods::getStatus, 0) .eq(queryDTO.getCategoryId() ! null, Goods::getCategoryId, queryDTO.getCategoryId()) .like(StrUtil.isNotBlank(queryDTO.getKeyword()), Goods::getTitle, queryDTO.getKeyword()) .between(queryDTO.getMinPrice() ! null queryDTO.getMaxPrice() ! null, Goods::getPrice, queryDTO.getMinPrice(), queryDTO.getMaxPrice()) .orderByDesc(Goods::getCreateTime); PageGoods result goodsMapper.selectPage(page, wrapper); // 转为 VO补充图片、卖家昵称等信息 return convertToVO(result); }这段代码最关键的是wrapper.eq(条件, 字段, 值)这种写法MyBatis-Plus 会在条件成立时才拼接相应 SQL。这样就不用自己写if标签代码简洁很多。如果条件较多、组合复杂也可以选择在 Mapper XML 里写select两种方式各有适用场景。个人建议简单条件用 QueryWrapper复杂多表查询写 XML 里的动态 SQL。商品列表返回给前端时我额外做了数据补全把每件商品的封面图第一张图片、卖家昵称、卖家头像查出来拼成GoodsVO避免前端为了展示这些信息反复发请求。这也算是性能优化的小经验尽量减少前端循环里的请求次数。3.4 订单流程与状态流转设计二手交易的下单流程跟标准电商不同它不涉及在线支付核心是“买卖双方线下交易、平台确认状态”。所以我把订单状态设计得非常简单0待确认、1已完成、2已取消。买家下单时的核心逻辑Transactional public void createOrder(Long goodsId, Long buyerId) { Goods goods goodsMapper.selectById(goodsId); if (goods null || goods.getStatus() ! 0) { throw new BusinessException(商品不存在或已下架); } if (goods.getUserId().equals(buyerId)) { throw new BusinessException(不能购买自己发布的商品); } Order order new Order(); order.setOrderNo(generateOrderNo()); order.setGoodsId(goodsId); order.setBuyerId(buyerId); order.setSellerId(goods.getUserId()); order.setPrice(goods.getPrice()); order.setStatus(0); orderMapper.insert(order); // 商品状态更新为已售出 goods.setStatus(1); goodsMapper.updateById(goods); }这里最关键的两个业务规则一是商品必须处于“在售”状态才能被购买二是不能买自己发布的商品。这两条规则在业务层做校验而不是靠前端隐藏按钮因为接口可以被直接调用后端校验才安全。生成订单编号我用的是时间戳加随机数private String generateOrderNo() { return SO System.currentTimeMillis() RandomUtil.randomNumbers(4); }虽然这个编号方案在极端并发下理论上可能重复但作为小型系统足够用了。如果要更可靠可以引入 Redis 自增或者雪花算法。卖家确认交易时的状态流转卖家看到订单后点击“确认交易”订单状态从0变成1同时商品保持已售出状态整个流程闭环。如果没有确认交易买家也可以取消订单取消后商品的状态要恢复为0在售。这个状态回滚逻辑一定不能漏不然就会出现“商品被买了但实际没卖出去”的 bug。4. 常见问题与排查技巧实录4.1 启动时报数据库连接错误这个问题在我让身边朋友跑源码时出现频率很高基本都是application.yml里的 MySQL 账号密码没改或者 MySQL 服务没启动。错误日志通常是Cannot create PoolableConnectionFactory (Access denied for user rootlocalhost (using password: YES))解决办法确认 MySQL 能本地登录然后修改配置文件里的username和password。还有一种情况是 MySQL 8.0 的驱动版本和连接 URL 不兼容源码里默认用的 MySQL 驱动是mysql-connector-java 8.0.x如果连接 URL 少了serverTimezone参数会报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。把 URL 改成我之前写的那串带时区参数的即可。4.2 代码有红色报错找不到类或符号这类问题绝大多数是 Maven 依赖没下载完整。导入项目后等 IDEA 右下角显示依赖索引完成如果还报错执行mvn clean install -DskipTests强制重新拉取依赖。还有一个常见原因本机 JDK 版本与 pom 里java.version不一致。用 IDEA 的Project Structure - SDKs把项目 SDK 切换成 1.8 或 11再在Settings - Maven - Runner里把 JRE 也换成对应版本。如果使用 Lombok记得 IDEA 要安装 Lombok 插件并在Settings - Build, Execution, Deployment - Compiler - Annotation Processors勾选Enable annotation processing。很多新手卡在这一步明明代码没问题但Data注解生成的 getter/setter 方法找不到就是因为注解处理器没开启。4.3 登录拦截器导致所有接口 404 或 401如果你在地址栏直接访问http://localhost:8080/api/goods/list返回 401 未认证多半是拦截器放行路径没配好。检查WebMvcConfig里addInterceptors方法把商品查询、首页推荐等不需要登录的接口加入排除列表。这里有个小技巧可以先把excludePathPatterns(/**)临时放行所有请求把页面调通后再逐步放开需要登录的接口这样能快速判断是接口逻辑的问题还是拦截器拦截的问题。4.4 上传图片后访问不到图片文件源码里的文件上传默认保存在项目根目录的upload/文件夹下同时通过一个虚拟路径映射/upload/**到本地磁盘目录。如果你改了保存路径却没有同步修改application.yml中的自定义配置前端展示图片时就会 404。我建议本地开发时用fileService.uploadFile方法返回相对路径前端拼接服务器地址访问部署到生产环境时用 Nginx 映射upload目录这样更灵活。源码里关于文件上传配置的部分在application.yml中已经给出示例改起来很方便。5. 二次开发与扩展方向建议5.1 如何把项目改成自己的课程设计或毕设这套系统拿来作为课程设计或毕业设计完全够用但建议做以下几点改造让它更像一个“完整作品”增加管理员模块目前源码里后台管理非常轻量可以扩展管理员角色、权限控制用 Spring Security 或 Sa-Token 做更完善的权限体系。如果不想引入重框架也可以自己写一个简单的拦截器做管理员判断。增加在线聊天功能二手交易里买家和卖家需要聊价格、约时间可以集成 WebSocket 做一个简单的私信聊天模块。这一步做好了项目的亮点会非常突出。增加数据统计在管理后台用 ECharts 展示每日新增用户、商品发布量、成交订单数等趋势图。这块可以用 SQL 的GROUP BY加日期函数实现难度不大但视觉效果很好。商品推荐基于分类和浏览量做简单的推荐列表比如“看过此商品的人还看过”。如果你要写在论文或说明文档里记得强调项目的业务完整性和技术选型原因尤其是为什么选 Spring Boot、MyBatis-Plus、JWT 这些技术栈都能讲出合理的取舍逻辑。5.2 代码规范化与注释补充的建议这套源码的命名风格比较规范但注释量不算多。既然是学习用建议在核心业务方法上手动补充注释比如GoodsServiceImpl里发布商品那段把事务控制的必要性写清楚JwtInterceptor里把 token 校验流程写清楚。注释不是为了给老师看而是为了三个月后的你还能快速想起来代码逻辑。我在编写源码时刻意保持了 Controller 层代码的薄Service 层代码的厚。你可以观察一下Controller 里几乎没有业务判断全部调 Service 方法Service 方法之间也是单一职责。这种习惯在简历上写“熟悉企业级项目分层开发”时是有底气说的。5.3 部署上线时需要注意的几个坑本地跑通之后如果想把项目部署到云服务器有几个坑提前告诉你们打包命令执行mvn clean package -DskipTests生成的 jar 在target/目录下。不要用 IDE 自带的 Artifacts 打包容易把依赖漏掉。上传到服务器后运行java -jar secondhand.jar记得在启动命令里指定环境配置比如--spring.profiles.activeprod。数据库迁移用mysqldump导出本地库再到服务器导入。字符集注意保持 utf8mb4不然中文乱码。图片上传路径本地绝对路径与服务器路径不同需要修改文件上传配置建议把图片存到固定的/data/upload目录并通过 Nginx 做静态资源访问。端口如果服务器上还有 Nginx让 Nginx 监听 80 端口转发到项目的 8080 端口。6. 这套源码的边界与总结性心得说了这么多最后聊点实在的。这套基于 Spring Boot 的二手交易系统本质上是一个面向学习和二次开发的完整工程。它不像网上的碎片化 Demo 一样只演示某个功能点而是把用户、商品、订单这三条核心业务线全部贯通让初学者真正体会到“做一个完整系统”是什么感觉。我在整理源码时也刻意加入了一些实际开发中才会遇到的细节比如逻辑删除、事务回滚、文件上传重命名、DTO 与实体分离、拦截器放行配置等。这些都是真实工作经验里沉淀下来的习惯不是教科书上能直接抄到的。你真的把它跑起来再对着代码逐行去看一定会有收获。我猜很多人下载了源码第一步就卡在环境配置上这里再强调一句遇到问题先看控制台日志百度错误信息时去掉自己项目特有的路径只看核心异常关键字大多数问题都能解决。最后再分享一个小技巧拿到任何 Spring Boot 开源项目别急着看业务代码先看pom.xml和application.yml这两个文件决定了项目的技术栈和运行环境。理解它们之后再顺着启动类去追踪一次完整的请求流程比漫无目的地翻代码高效得多。这套源码作为起点你可以继续在上面加功能、优化性能、甚至重构代码把它慢慢变成你自己的项目。动手去改、去踩坑才是提升最快的方式。本文还有配套的精品资源点击获取