SpringBoot实战：闲置品交易平台毕设项目完整解析

1. 项目概述与价值分析

1.1 项目定位与核心需求解析

先说结论：这个"闲一品"闲置品交易平台，本质上就是一个典型的SpringBoot商城类练手项目，只不过业务方向切在了二手闲置交易这个场景上。要我说，在毕设选题里，这种场景选择其实挺聪明的。一方面它避开了传统电商那套复杂的供应链体系，比如多级库存、物流轨迹对接、支付网关分账这些"大厂专属"的痛点，另一方面又能把用户管理、商品发布、订单交易、后台审核这些核心业务完整地串起来，用来检验一个Java学生对Web开发全流程的掌握程度，再合适不过。

从毕设答辩的角度看，这类项目的逻辑链条非常清晰：用户注册登录后可以发布闲置商品，其他用户浏览、搜索、收藏、下单购买，卖家处理订单，管理员负责审核商品和用户管理。整个闭环是完整且自洽的，评审老师一眼就能看懂，问起问题来也容易答。比起一些花里胡哨的"智能推荐系统"或者"大数据分析平台"，这种务实型的业务系统反而更容易拿高分。

我再补一句基于多年实操经验的判断。很多同学做毕设容易陷入一个误区，就是总想往项目里堆技术，今天加个Elasticsearch做搜索，明天加个RabbitMQ做消息队列，后天再上Redis做缓存。表面上看技术栈很丰富，但到了实际答辩和代码走查环节，一问为什么用、原理是什么、落地怎么配，就一问三不知。这个闲置品交易系统最大的好处就是，技术选型全部踩在SpringBoot的核心舒适区内，每一处技术使用都能讲出明确的业务理由，既不会显得敷衍，又不会失控。

1.2 技术选型与架构设计思路

技术栈这一块，SpringBoot + MyBatis-Plus + MySQL + Vue（或Thymeleaf）的组合，可以算是目前Java毕设圈的"标准答案"了。为什么这么说？我给你拆开来看：

后端选型：SpringBoot 2.x + MyBatis-Plus

SpringBoot不用多说，现在的Java后端事实标准。它的自动配置机制、起步依赖、内嵌Tomcat这些特性，能让学生把精力集中在业务代码上，而不是折腾XML配置文件。更关键的是，SpringBoot在面试中的出现频率极高，做完这个项目之后，你对自动配置、starter机制、Bean生命周期这些知识的理解会深一个层次，面试时聊起来也有底气。

MyBatis-Plus这个选择更是务实。相比较原生MyBatis要手写大量XML映射，MyBatis-Plus提供了BaseMapper，单表CRUD完全不用写SQL，分页插件一行配置就能用，代码量直接砍掉一半。我自己见过太多同学在毕设里写了一大堆重复的Mapper方法，实际上是浪费时间。当然，如果你项目里涉及多表联查，还是要自己写@Select注解或XML里的SQL，这也能体现出数据库基本功。

前端选型：Vue + Element UI（前后端分离）

现在的主流毕设标配。前后端分离模式的好处有三点：第一，前端静态资源可以独立开发调试，不用每次改个按钮都要重启后端；第二，接口联调方式接近企业真实开发模式；第三，Vue的响应式数据绑定比JQuery操作DOM要高效太多，页面交互做起来轻松。

如果不想折腾Node环境和Vue CLI，也可以用Thymeleaf服务端渲染，一个SpringBoot包搞定所有页面，部署特别省心。但我的建议是，只要前端基础还行，尽量上Vue前后端分离。答辩时展示的架构层次感完全不同，而且现在市面上的毕设视频和源码也基本都沿着这个路线走。

数据库选型：MySQL 5.7 / 8.0

没有悬念的选择。MySQL在个人项目和中小型系统里就是最稳的答案，免费、社区活跃、资料多、Navicat可视化工具好用。5.7和8.0都可以，8.0在性能和JSON支持上更强一些，但5.7更稳妥、和老的JDBC驱动兼容性更好。建议装8.0，同时把MySQL驱动版本调到对应的8.x。

为什么不建议上微服务？

这个必须重点说。我见过好几届学生，学了点Spring Cloud的皮毛，非要在一个毕设项目里拆出什么用户服务、商品服务、订单服务三个模块，结果服务间调用用Feign，分布式事务解决不了，最后熬几个通宵回到单体架构。毕设项目的时间精力是有限的，单体应用 + 模块化代码分包，完全能撑起这个业务规模。微服务是给团队协作和流量弹性的场景准备的，一个毕设硬上微服务，只会暴露你在分布式理论和工程实践上的薄弱。

1.3 核心业务流程梳理

这个项目的核心业务链路其实并不复杂，整个系统中你只需要理清三个角色：

普通用户（买家/卖家双角色合一）：注册后既可以发布自己的闲置商品，也可以浏览购买其他人的商品。这就意味着用户表不需要区分买家表、卖家表，一个user表加个角色字段就搞定，商品表里用user_id关联发布者即可。

管理员：负责审核商品是否合规（比如有没有违禁品、广告、垃圾信息），管理用户状态（封号、解封），维护商品分类，查看平台运营数据。

游客（未登录用户）：可以浏览商品列表、查看商品详情，但下单、收藏、发布商品都需要登录后才能操作。这种权限控制通过拦截器 + 用户登录状态校验来实现。

业务链路从用户角度可以概括为：注册登录 -> 发布闲置 -> 管理员审核 -> 商品上架展示 -> 买家浏览搜索 -> 加入购物车/直接下单 -> 订单状态流转 -> 买家确认收货 -> 交易完成。

有一点值得注意：二手交易平台和普通电商在订单流程上有区别。普通电商有库存概念，二手平台一般来说一件商品只有一件，卖出去就下架。所以商品表里需要一个status字段控制状态：0待审核、1出售中、2已售出/下架。这个状态流转逻辑写清楚，数据库设计就成功了大半。

2. 核心功能模块与数据库设计解析

2.1 功能模块划分

按毕设论文的标准格式，功能模块一般分为用户端和管理端两个角色维度，再加上公共模块，画功能结构图的时候分层展示即可。

用户端功能：

• 注册登录：手机号+密码注册、登录、退出
• 商品浏览：首页商品列表、按分类筛选、关键字搜索、商品详情
• 商品收藏：收藏商品、取消收藏、我的收藏列表
• 发布闲置：填写商品信息、上传商品图片、设置价格和成色
• 订单管理：作为买家查看我买到的、作为卖家查看我卖出的
• 个人中心：修改个人信息、修改密码、查看我的发布记录

管理端功能：

• 管理员登录（独立账号体系或复用用户表加角色字段）
• 商品审核：审核通过/拒绝、下架违规商品
• 用户管理：查看用户列表、启用/禁用账号
• 分类管理：增删改查商品分类
• 数据统计：平台商品总量、用户量、订单量统计（简单的SQL count + 图表展示）

这里我提醒一句：功能不是越多越好，做到位比铺得开更重要。很多同学喜欢加一堆聊天室、评论、点赞功能，到Deadline前又做不完，最后每个功能都是半成品。二手交易平台的核心就是"发布—浏览—交易"这三个环节，把这几个功能打磨顺了，论文工作量已经完全足够。

2.2 数据库表结构设计

数据库设计是毕设论文里的重头戏，也是答辩时老师必问的环节。我按这个项目的业务需求，给你列一份经过实战验证的标准表结构：

user 用户表

密码加密这一点我要特别强调一下。我见过太多学生毕设代码里明文存密码，甚至写死在SQL脚本里。这要是让答辩老师看到，轻则扣分，重则被质疑工程素养。Spring Security里自带的BCryptPasswordEncoder，或者用Spring的DigestUtils工具类做MD5加盐处理，二选一就行。从企业实际开发的角度来讲，BCrypt更安全，因为它是自适应哈希，自带盐值，防彩虹表攻击。

category 商品分类表

字段：id、name（分类名称）、sort（排序号）、create_time

分类表就这三个核心字段够了。建议预置几类常见二手商品分类：数码产品、图书教材、生活家电、服饰美妆、运动户外、其他。

goods 商品表

这个status字段是整个商品模块的核心，每一次状态变更都对应一个业务动作。待审核是发布者提交后的初始状态；管理员审核通过后变为出售中；买家下单并支付后，变成已售出；卖家自己可以主动下架。这个状态机想明白了，商品模块的代码逻辑就顺了。

orders 订单表

订单编号的生成要注意并发问题，不要用简单的时间戳，高并发下可能重复。建议用时间戳 + 随机数或者UUID替换横杠，我在项目中用的是"yyyyMMddHHmmss + 4位随机数"组合，简单可靠。

collect 收藏表

字段：id、user_id、goods_id、create_time。加一个唯一索引(user_id, goods_id)，防止重复收藏。

这套表结构下来，总共5张核心表，关系清晰、前后端联调顺畅、论文ER图好画。如果你想把项目做得更充实，可以再加一张notice公告表或banner轮播图表，但不是必须。

2.3 JWT登录认证与权限设计

登录认证这块，目前毕设项目里最流行的方案是JWT（JSON Web Token）。这个方案的核心思想是：用户在登录成功后，后端签发一个经过签名的令牌返回给前端，前端后续请求都带上这个令牌，后端通过拦截器校验令牌的合法性来识别用户身份。

我在项目中实际落地方式是：

1. 用户登录成功后，生成JWT token，里面包含userId、username、role，设置过期时间24小时。
2. 前端将token存入localStorage，在axios请求拦截器里统一添加Authorization头。
3. 后端写一个拦截器（HandlerInterceptor），对需要登录的接口进行token校验，从token里解析出用户信息存入ThreadLocal。
4. 后端提供UserContext工具类，在Controller层直接通过UserContext.getUserId()获取当前用户。

这里要特别说一句：有些同学会用Spring Security整合JWT，说实话对毕设来说有点过度设计，配置复杂度高，学习成本大，而且很多学生配了半天还是没搞懂Security的过滤链机制。用拦截器 + JWT + ThreadLocal这套轻量方案，代码量少、逻辑直观、答辩时也好讲清楚原理。我这样说可能有些老师不同意，但我的经验是：毕设项目的第一优先级是你能完整讲清楚自己写的每一行代码，而不是用自己不理解的框架凑技术栈。

3. 关键功能实现与代码拆解

3.1 商品图片上传：本地存储方案实战

商品图片上传几乎是每个有内容发布的系统都绕不开的功能。这个项目里，我建议直接用本地磁盘存储方案，简单可靠，不依赖第三方云服务。

核心实现思路：前端通过Element UI的el-upload组件选择图片，在后端Controller接收MultipartFile，做文件名校验和大小限制，然后将文件写入服务器的指定目录，最终把访问路径存到数据库。

具体代码片段（伪代码风格）：

java复制@PostMapping("/upload")
public Result upload(@RequestParam("file") MultipartFile file) {
    if (file.isEmpty()) {
        return Result.error("文件不能为空");
    }
    // 原始文件名
    String originalFilename = file.getOriginalFilename();
    // 扩展名
    String suffix = StringUtils.substringAfterLast(originalFilename, ".");
    // 新文件名：UUID.后缀
    String newName = UUID.randomUUID().toString().replace("-", "") + "." + suffix;
    // 存储路径：/upload/2024/05/xx.jpg
    String datePath = new SimpleDateFormat("yyyy/MM/dd").format(new Date());
    File dir = new File(uploadPath + datePath);
    if (!dir.exists()) {
        dir.mkdirs();
    }
    file.transferTo(new File(dir, newName));
    String url = "/files/" + datePath + "/" + newName;
    return Result.success(url);
}

三个关键点切记：

第一，文件名一定要重命名，不能直接用用户上传的文件名。一来中文文件名有编码问题，二来可能有路径穿越等安全风险，三来重名文件会互相覆盖。UUID生成的名字基本不会重复，这是工程上的常规做法。

第二，要对文件类型做白名单校验。只允许jpg、png、gif、webp这些常见图片格式，可以通过扩展名判断，也可以进一步通过ImageIO读取文件头验证真实格式。毕设层面做扩展名校验足够了。

第三，上传目录和访问映射要分开配置。文件中存储在本机的真实路径（比如D:/upload/），而浏览器访问时需要映射一个虚拟路径。在SpringBoot里可以通过配置WebMvcConfigurer来把"/files/**"映射到磁盘目录。

java复制@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Value("${upload.path}")
    private String uploadPath;
    
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/files/**")
                .addResourceHandler("file:" + uploadPath);
    }
}

这一步特别容易踩坑。很多同学文件存到数据库的路径是"/files/xxx.jpg"，但没做虚拟路径映射，结果前端访问图片404。记住了：数据库里存的路径是浏览器访问的URL路径，不是服务器磁盘的真实路径。

3.2 商品发布与审核的状态机设计

商品发布这个功能看起来简单，其实就是前端填个表单、后端insert一条记录，但状态流转的设计直接决定了整个系统的数据结构是否健全。

发布闲置的流程是这样的：用户填写商品标题、描述、分类、成色、价格，上传图片，点击发布。后端将商品status设为0（待审核），同时初始化view_count为0。管理员在后台看到待审核商品列表，可以点击通过或拒绝，通过后status变为1（出售中），拒绝时需要填写拒绝原因（可以在后期优化时加个审核备注字段，答辩加分项）。

真正的关键在于：商品被买家下单之后，status要立刻变为"已售出"，而不是等支付完成才更改。这里要防止超卖——虽然是二手平台一件商品理论上只有一个，但如果有两个买家同时下单同一件商品，不加限制就会产生并发问题。

我实现并发控制的方案有两种：

方案一：在下单更新的SQL语句中加条件判断。

sql复制UPDATE goods SET status = 2 WHERE id = #{goodsId} AND status = 1

通过返回的影响行数判断是否更新成功，如果影响行数为0说明商品已被别人抢先下单。这也是乐观锁的核心思想，用SQL层面的条件来保证原子性。

方案二：在Java代码层面对商品状态排队处理（不推荐高并发场景，但毕设里解释好原理就行）。

基于Spring事务 + synchronized或者处理时重新查询校验。这种方式在单体应用里可行，但无法应对集群部署的场景，答辩时可以如实说明局限。

个人建议采用方案一，代码优雅、逻辑严谨、面试时还能顺势聊出乐观锁和CAS的思想，属于"一行SQL点亮整个项目"的操作。

3.3 商品搜索与分页优化

商品浏览模块是用户最常打交道的功能。首页商品列表、按分类筛选、按关键词搜索、按价格排序，这些需求汇总起来就是：一个支持多条件动态查询的分页接口。

MyBatis-Plus的分页插件在这里非常省力。先配置一个分页拦截器：

java复制@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

然后业务层写一个Page对象，给QueryWrapper拼接条件：

java复制Page<Goods> page = new Page<>(pageNum, pageSize);
LambdaQueryWrapper<Goods> wrapper = new LambdaQueryWrapper<>();
wrapper.eq(Goods::getStatus, 1)  // 只查出售中的
       .eq(StringUtils.isNotBlank(categoryId), Goods::getCategoryId, categoryId)
       .like(StringUtils.isNotBlank(keyword), Goods::getTitle, keyword)
       .orderByDesc(Goods::getCreateTime);
goodsMapper.selectPage(page, wrapper);

这段代码看着简单，但有两个容易被忽视的点：

一是分页参数要校验。pageNum不能小于1，pageSize不能太大（防止一次性查几千条数据把接口拖垮），合理的范围是1到100。

二是模糊搜索的关键词要处理特殊字符，比如%、_这些SQL通配符。否则用户搜一个"100%纯棉"，SQL的LIKE条件可能就失控了。可以用MyBatis-Plus的wrapper的like方法，它会自动处理转义，但如果是手写XML就得自己注意。

至于商品详情页，就是根据id查一条记录，同时把view_count加1。这里可以用一个update语句：

sql复制UPDATE goods SET view_count = view_count + 1 WHERE id = #{id}

注意不要先查出来再加一再更新，多一次查询不说，还有并发更新丢更新问题。

3.4 订单流程与事务管理

订单模块是整个系统里对事务要求最高的地方。以一个完整的下单流程为例，涉及的操作包括：校验商品状态、创建订单记录、修改商品状态、扣减积分/余额（如果做积分系统）。这些操作必须要么全部成功，要么全部失败，绝不能出现订单建了但商品状态没改的脏数据。

Spring的@Transactional注解在这里派上用场。在Service层的下单方法上加这个注解，如果方法抛出运行时异常，事务会自动回滚。需要注意的一点是，@Transactional默认只对RuntimeException和Error回滚，对受检异常（如Exception）不会回滚。如果你在方法里手动catch了异常并吞掉，那事务也会失效。

我建议下单方法的实现逻辑：

java复制@Transactional(rollbackFor = Exception.class)
public Order createOrder(Long goodsId, Long buyerId) {
    // 1. 校验商品存在且状态为出售中
    Goods goods = goodsMapper.selectById(goodsId);
    if (goods == null || goods.getStatus() != 1) {
        throw new BizException("商品不存在或已下架");
    }
    // 2. 不能买自己的商品
    if (goods.getUserId().equals(buyerId)) {
        throw new BizException("不能购买自己发布的商品");
    }
    // 3. 乐观锁更新商品状态
    int rows = goodsMapper.updateStatusById(goodsId, 1, 2); // status from 1 to 2
    if (rows == 0) {
        throw new BizException("商品已被下单，手慢了");
    }
    // 4. 创建订单
    Order order = new Order();
    order.setOrderNo(generateOrderNo());
    order.setGoodsId(goodsId);
    order.setSellerId(goods.getUserId());
    order.setBuyerId(buyerId);
    order.setPrice(goods.getPrice());
    order.setStatus(0); // 待付款
    orderMapper.insert(order);
    return order;
}

这里"不能买自己发布的商品"这个校验，是很多毕设项目会漏掉的逻辑。虽然它是业务细节，但答辩老师如果问到了，你答出来了就会显得考虑问题全面。更重要的还是对数据库表设计、事务控制、并发控制这些基础功底的展现。

从订单状态来看，二手交易平台的支付流程可以先做成模拟支付——页面上点"确认支付"按钮，后端把订单状态从待付款改成已付款，再往前走发货、收货流程。千万不要真去对接支付宝/微信支付接口，那需要企业资质商户号，个人做不了。

4. 环境搭建与部署上线全流程

4.1 开发环境准备清单

一次成功的部署，环境准备至少占一半的功劳。结合这个项目，我列一份最稳妥的开发环境组合，全部安装配置好再动手。

JDK版本这个坑我多说一句：springboot 2.7版本对JDK版本的要求是8到17都能跑，但我强烈建议用JDK8开发，原因很简单，教材、视频、网上答疑案例80%都是JDK8环境，踩坑概率最低。等以后面工作、看项目了再切更高的JDK，毕设阶段别给自己找事儿。

4.2 项目导入与配置修改

拿到完整源码包之后，解压后通常会有两个目录：一个backend（SpringBoot后端），一个frontend（Vue前端），或者直接一个all-in-one的SpringBoot项目。用IDEA导入的步骤：

1. 打开IDEA，选择File -> Open，选择后端项目的pom.xml所在目录。
2. IDEA会自动识别Maven项目并下载依赖，这一步视网络情况可能要几分钟。
3. 等待依赖下载完成后，在src/main/resources目录下找到application.yml（或者application.properties）。

配置文件是部署的第一道关卡，重点看这几个配置项：

yaml复制server:
  port: 8080

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/xianyipin?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 30MB

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  mapper-locations: classpath*:mapper/**/*.xml

upload:
  path: D:/upload/

关于数据库连接的几个细节：

• serverTimezone必须设置，否则MySQL 8.0连接会报时区错误。
• useUnicode和characterEncoding指定UTF-8，防止中文乱码。
• 数据库名要跟脚本里的保持一致，如果你建库时改了个名，URL里的名字也要同步改。
• password换成你自己MySQL的密码。

如果你用的是MySQL 5.7，driver-class-name可以用com.mysql.jdbc.Driver，但更建议统一用新的c3p0驱动，也就是com.mysql.cj.jdbc.Driver，5.7同样兼容。

4.3 数据库初始化和导入

这一步不复杂，但却是翻车率最高的环节之一。标准的操作流程：

1. 用Navicat连接本地MySQL。
2. 新建数据库，字符集选择utf8mb4，排序规则选择utf8mb4_general_ci。
3. 右键数据库 -> 运行SQL文件 -> 选择源码包里的xyp.sql（或其他名字的SQL脚本）。
4. 执行完成后，刷新数据库查看表结构，确认5张核心表（user、category、goods、orders、collect）都在。

这里要特别强调字符集选择。千万不能用latin1或者默认字符集，否则后面中文数据全变成问号。utf8mb4是utf8的超集，还能存表情包、特殊符号这些4字节字符，是当前的主流选择。

另外，源码包里自带SQL脚本时，先打开脚本看一眼有没有CREATE DATABASE语句。如果有，你只需要执行脚本即可；如果只有CREATE TABLE，就先手动建库再导入。还有的脚本里会有drop table if exists，这个影响不大，但要注意它可能会覆盖你之前建的同名表，执行前确认一下库里没有重要数据。

4.4 前后端启动与联调

后端启动流程：

1. 找到主启动类（XianYiPinApplication等），右键Run。
2. 观察控制台日志，看到"Started XxxApplication in xx seconds"字样说明启动成功。
3. 浏览器访问http://localhost:8080，如果配置了静态首页或者Swagger，能看到回应。

前端启动流程（如果是前后端分离项目）：

1. 打开命令行，cd到frontend目录。
2. 执行npm install安装依赖（第一次比较慢，可能需要配置淘宝镜像源）。
3. 执行npm run serve启动开发服务器。
4. 浏览器访问http://localhost:8081（Vue默认端口），如果后端接口有跨域配置，页面能正常访问数据。

前端开发阶段最常见的两个问题：一个是npm install卡死，这个是国内网络问题，建议先执行npm config set registry https://registry.npmmirror.com再装；另一个是Proxy代理配置，前后端联调时Vue.config.js里需要配置devServer的proxy将/api开头的请求转发到后端的8080端口，我见过太多人只启动了前端页面，不配代理，页面能打开但没有数据。

4.5 打包部署到服务器

如果是单机Thymeleaf版本，打包部署非常简单：

bash复制mvn clean package -DskipTests
java -jar target/xianyipin-0.0.1-SNAPSHOT.jar

如果需要后台运行不中断，用nohup命令：

bash复制nohup java -jar target/xianyipin-0.0.1-SNAPSHOT.jar > app.log 2>&1 &

如果是前后端分离版本，前端需要build出静态文件，然后丢给Nginx部署：

bash复制npm run build

构建完成后dist目录下就是纯静态资源，用Nginx把dist目录指向8888端口，后端API通过Nginx反向代理到8080端口，一个简单的代理配置示例：

nginx复制server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        root /var/www/html/dist;
        try_files $uri $uri/ /index.html;
    }
    
    location /api/ {
        proxy_pass http://localhost:8080/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

现在主流的演示方式其实是本地部署 + 远程答辩。毕设答辩时现场跑程序加投屏展示已经完全够用，不必非得买云服务器。如果你想让项目看起来更完整，本地把前后端都跑起来已经能展现出完整的系统面貌。

5. 常见问题与排查技巧实录

5.1 启动阶段典型报错与处理

问题一：端口被占用

启动SpringBoot时控制台报错Port 8080 was already in use。处理方式：

• Windows下打开CMD，输入netstat -ano | findstr 8080查看占用进程PID。
• taskkill /PID 进程号 /F强制杀掉进程。
• 或者改application.yml里的server.port，换成8081、9090等。

这个问题在演示前特别容易出现，尤其是之前跑过其他项目的同学。我习惯是演示前先看一眼任务管理器里有没有残留的Java进程，顺手清理一遍。

问题二：数据库连接失败

报错信息形如Access denied for user 'root'@'localhost' (using password: YES)，或者Communications link failure。

排查思路：

1. 确认MySQL服务已启动（Windows服务管理器里看MySQL服务的状态）。
2. 确认application.yml里的账号密码和本地MySQL一致。
3. 确认数据库URL里的库名和你建库的名称一致。
4. 用Navicat手动连接一次，如果Navicat能连上但程序连不上，基本就是配置文件的问题。

Communications link failure这个报错还有一个常见原因是MySQL 8.0的认证插件问题，如果遇到Authentication plugin 'caching_sha2_password' cannot be loaded，需要把用户加密规则改成mysql_native_password：

sql复制ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';

这个报错在MySQL8 + 老版本驱动组合时经常出现，但你这项目只要JDBC驱动是8.x版本，基本不会碰到。

问题三：依赖下载失败

IDEA里Maven导入依赖时疯狂报红，或者pom.xml里某些依赖一直下载不下来。处理方案：

1. 确认Maven的settings.xml有没有配置阿里云镜像。
2. 确认IDEA的Maven配置指向了正确的本地仓库路径。
3. 删掉本地仓库里下载了一半的jar包残留文件（.lastUpdated后缀的文件），重新点击Reimport。

我踩过最多的坑就是某个依赖下载中断后，idea一直认为这个包存在，反复报错。把本地仓库~/.m2/repository下的相关目录删掉重新下载，基本都能解决。

5.2 运行阶段逻辑Bug与修复

问题一：图片上传成功但前端不显示

这是最高频的问题，原因几乎都是虚拟路径映射没配。检查方向：

1. 数据库里的图片URL路径是什么样，比如是/files/2024/05/xx.jpg，那么浏览器访问这个路径应该能打开。
2. 如果404，检查WebConfig的addResourceHandlers有没有生效。
3. 检查你配置的磁盘路径是否存在，上传时的目录是否真的创建成功。
4. 注意Windows和Linux的路径格式差异，Windows是D:/upload/，Linux是/usr/local/upload/，末尾的斜杠都要加。

这个问题的排查思路其实很有价值，它涉及"URL虚拟路径"和"磁盘真实路径"的区别，建议写进论文的测试章节。

问题二：跨域请求被拦截

前后端分离模式下，前端在8081端口，后端在8080端口，浏览器报CORS错误或者Request failed with status code 401（如果是JWT认证的话可能是预检请求被拦截）。

解决方案：

1. 后端开启CORS全局配置：

java复制@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);
    }
}

2. 前端配置代理转发，这是更推荐的方案，因为它绕过了跨域限制，生产环境也适用。具体在vue.config.js里配置devServer.proxy。

要注意的是，如果你在前后端都配置了跨域处理，有时会出现allowedCredentials冲突的报错，这是allowCredentials(true)和allowedOriginPatterns("*")在某些Spring版本下的限制。解决方法是改成一个来源，或者把allowCredentials设成false。

问题三：中文乱码

页面显示中文全是??或者乱码，排查三处：

1. 数据库连接URL的characterEncoding=utf8，加上后重启。
2. 数据库表、字段的字符集是不是utf8mb4，用SQL改：

sql复制ALTER TABLE goods CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

3. IDEA的编码设置，File -> Settings -> Editor -> File Encodings，把全局和项目编码都设为UTF-8。

我曾经帮一个同学排查乱码，折腾了一个小时，最后发现是他在Windows记事本里改了配置文件后，IDEA识别为GBK编码了，重新用IDEA打开转成UTF-8保存就解决。

5.3 MySQL安装配置实战备注

这个虽然不算系统本身的Bug，但很多同学卡在第一步MySQL就装不上了。如果你是Windows系统，我建议直接用MySQL Installer，一键安装做完初始化。如果是Mac，用Homebrew一行命令：

bash复制brew install mysql

装完之后要把MySQL加到系统服务，Windows直接通过Installation向导启动服务，Mac用brew services start mysql。

初始密码问题也常遇到。Windows下装MySQL 8.0，安装器会让你设置root密码，记住就行。如果忘了，可以在服务停止的状态下用mysqld --skip-grant-tables模式启动后修改密码，但这个操作有点麻烦，还是不推荐好，建议重新装一遍或者用安装时的密码记录器。

6. 论文撰写与答辩准备的实战建议

6.1 论文结构参考与写作要点

拿到完整源码之后，很多同学以为万事大吉，直接跑起来就等着答辩了。但我见得太多：演示很流畅，代码却是一问三不知，最后被导师怀疑代做。所以拿到任何毕设项目源码，最忌讳的是一眼不看、直接交差。我建议你把论文和源码对照着过一遍，重点理解每个模块的实现思路。

标准的毕设论文目录结构如下：

第一章 绪论：课题背景和意义、国内外研究现状、主要研究内容
第二章 相关技术介绍：SpringBoot、MyBatis-Plus、MySQL、Vue技术栈
第三章 系统分析：可行性分析、功能性需求分析、非功能性需求分析
第四章 系统设计：系统架构设计、功能模块设计、数据库设计
第五章 系统实现：按模块展示核心代码和页面截图
第六章 系统测试：功能测试用例、测试结果

写论文最常见的痛点是"代码全是抄的，不知道怎么写实现"。我的建议是，不要试图把每一行代码都贴进去，而是挑核心业务逻辑讲思路。比如商品发布模块，你讲清楚"前端表单收集数据 -> 后端接收实体参数 -> 设置status为待审核 -> 调用Mapper插入数据库"，每一步配上关键代码片段和页面截图，内容既充实又经得起推敲。

6.2 答辩高频问题整理

根据我带过的学生反馈，答辩老师对这类项目的提问高度集中在下面这些点上，提前准备答案心里有数：

问：SpringBoot的自动配置原理是什么？

答：SpringBoot通过@SpringBootApplication注解引入@EnableAutoConfiguration，在启动时会扫描META-INF/spring.factories文件里的自动配置类，再结合@ConditionalOnClass、@ConditionalOnProperty等条件注解按需加载Bean。比如我们引入spring-boot-starter-web后，SpringBoot会根据Classpath里是否有Servlet相关的类来自动配置内嵌Tomcat和DispatcherServlet。

问：MyBatis-Plus分页插件的原理？

答：分页插件实现了MyBatis的Interceptor接口，在Executor执行SQL之前拦截，通过Page对象解析出分页参数，改写原始SQL为带LIMIT的分页语句（MySQL方言），同时执行一条COUNT查询获取总记录数。

问：订单并发问题怎么解决的？

答：通过乐观锁方式，在更新商品状态的SQL语句里加入status = 1的条件，利用数据库的行级锁和原子性保证同一时刻只有一个请求能成功把status从1改为2，影响行数为0则说明已被其他用户抢先下单。

问：JWT和Session有什么区别？

答：Session是把用户信息存在服务端，客户端只有SessionID；JWT是把用户信息加密签名后发给客户端，服务端无状态。JWT适合分布式和前后端分离的架构，不需要考虑Session共享问题，但缺点是无法主动销毁。

问：为什么选择这个课题？

答：围绕二手交易痛点切题。结合环保理念、资源循环利用的消费趋势，以及当前大学生闲置物品处理的现实需求，体现课题的社会价值。

这些问题的答案不只是背下来就行，关键是理解背后的原理，复试时老师追问角度一变，你还能灵活应答。

6.3 二次开发升级方向

答辩之后如果想继续完善系统放入简历，可以从以下几个方向做二次开发：

1. 接入支付模拟：将模拟支付改成可配置的沙箱支付环境，演示时申请测试商户号体验真实的支付回调流程。
2. 缓存优化：把首页热销商品、分类列表这些被高频查询的数据加入Redis缓存，讲解缓存穿透、缓存击穿、缓存雪崩的应对策略。
3. 消息通知：引入WebSocket，实现买家下单后卖家端实时收到新订单通知，或者简单的站内信通知。
4. 数据可视化：管理后台用ECharts展示平台每日新增用户、发布商品量、成交量趋势图，SQL聚合查询 + 图表渲染，这类功能做得好，项目呈现度上升一个档次。
5. 接口安全增强：加入Rate Limiter限制接口调用频率、XSS过滤、SQL注入防护等安全措施。

这些改进每一个都能讲出完整的实现思路，比换一套完全不懂的微服务框架要加分得多。说到底，毕业设计的核心不是项目有多炫酷，而是你能证明自己确实理解了系统的每个角落。

7. 最后的几点心里话

项目本身并不复杂，SpringBoot也好，MyBatis-Plus也好，都是已经被无数人验证过的成熟技术。这个项目真正带给你的东西，在于亲手把一个完整的业务系统从零跑起来的过程中，建立起来的那套"输入—处理—输出"的工程直觉。我见过太多同学在毕设阶段不是被技术难倒的，而是被"不知道从哪儿下手"困住了。看别人的源码不是为了照搬，是为了看别人怎么拆解问题、怎么组织代码、怎么处理边界情况，然后把这些方法内化成自己的习惯。

实操过程中还有一个容易被忽视的细节：源码包的名称、数据库名、项目路径里尽量不要有中文和空格，避免各种奇奇怪怪的运行问题。初次运行如果报错，不要慌，先看一眼完整的异常堆栈，大多数问题在报错信息里已经写明白原因了。调通之后，花一点时间把核心接口用Postman手动测一遍，把每个功能操作一遍，截图留档，这些素材后面写论文和做答辩PPT都用得上。

就分享到这里。希望这份拆解对你做毕设或者学习SpringBoot有实际的帮助。如果你在部署或者二次开发过程中遇到具体问题，按照上面整理的排查清单逐项核对，基本能解决八成以上的坑。剩下的，就靠你自己动手踩一踩了。