SpringBoot二手交易平台毕业设计：从架构设计到部署上线的完整实战指南-编程实验室

简介：这是一套面向计算机专业本科生的毕业设计级二手交易平台源码，基于SpringBoot后端框架与JSP前端技术栈构建，聚焦校园二手书籍及社区闲置物品交易场景，兼顾信息化管理与轻量级电商功能，适合毕设、课程设计或Java全栈入门实践。压缩包共119个文件，含42个Java核心业务类（如UsersController、ShorderController等）、36个JSP页面模板、22个XML配置文件（涵盖Spring与MyBatis配置），辅以CSS样式、图片资源及基础配置文件，整体仅1.69MB，结构紧凑、依赖清晰，开箱即用。已有287人学习下载，资源附带完整项目笔记与文档，覆盖需求分析、数据库设计、前后端交互逻辑及部署说明；代码模块划分明确，包含用户管理、商品发布、订单处理、收货地址、分类维护等典型电商子系统，便于理解MVC分层架构并进行功能扩展与二次开发。

1. 项目概述与核心价值

最近几年，毕业季一到，总能看到不少计算机专业的同学在为毕业设计发愁。选题、技术选型、文档编写、代码实现，每一步都像在闯关。其中，“二手交易平台”这个题目，尤其是聚焦在校园书籍或者社区场景的，几乎成了每年毕业设计的热门选择。原因很简单，它贴近生活，业务逻辑清晰，技术栈覆盖面广，既能体现Web开发的基本功，又能适当加入一些亮点功能，非常适合作为本科或硕士阶段的综合实践项目。

我手头这个项目，就是一个典型的基于SpringBoot的二手商城系统，配套了完整的源码、笔记和文档。这不仅仅是一堆代码文件，更像是一个从零到一的完整项目开发实录。对于正在寻找毕业设计课题，或者想通过一个实战项目来巩固SpringBoot、前后端分离、数据库设计等技能的朋友来说，这份材料提供了一个非常扎实的“脚手架”和“避坑指南”。你可以直接参考它的架构进行开发，也可以深入研究其代码实现，理解每个功能模块背后的设计思路。接下来，我就把这个项目的里里外外拆解一遍，从设计思路到代码细节，再到那些文档里不会写的“踩坑”经验，希望能给你带来实实在在的帮助。

2. 项目整体架构与设计思路拆解

2.1 为什么选择SpringBoot作为技术核心？

选择SpringBoot作为这个二手交易平台的技术底座，几乎是当前Java Web开发领域的最优解，没有之一。对于毕业设计而言，这个选择背后有非常务实的考量。

首先，快速启动，零配置。SpringBoot最大的魅力在于“约定大于配置”。回想十年前做Java Web项目，光是把SSH（Struts+Spring+Hibernate）框架搭起来，配置各种XML文件就能折腾一两天。而SpringBoot通过自动配置和起步依赖，你只需要在pom.xml里引入spring-boot-starter-web，一个内嵌了Tomcat的Web应用瞬间就活起来了。这对于时间紧迫的毕业设计来说，意味着你可以把精力集中在业务逻辑的实现上，而不是框架的整合上。

其次，技术栈成熟且生态完整。一个二手交易平台涉及用户认证、商品管理、订单处理、支付集成（模拟）、文件上传等多个模块。SpringBoot的生态提供了对应的starter：用spring-boot-starter-security做安全控制，用spring-boot-starter-data-jpa或mybatis-spring-boot-starter操作数据库，用spring-boot-starter-mail发送通知邮件。你需要什么，就引入什么，它们之间天然兼容，大大降低了集成复杂度。

再者，便于打包和部署。SpringBoot可以将整个应用打包成一个可执行的JAR文件，里面包含了所有依赖和一个内嵌的Servlet容器（如Tomcat）。部署时，你只需要服务器上有Java运行环境，一句java -jar your-project.jar就能跑起来。这对于需要演示的毕业设计来说，无论是在实验室的电脑上，还是在临时申请的云服务器上，部署过程都极其简单。

注意：虽然SpringBoot简化了配置，但理解其背后的原理至关重要。例如，自动配置是如何工作的？application.properties/application.yml中的配置优先级是怎样的？建议在开发过程中，有意识地查看一些自动配置类的源码，这对你理解SpringBoot的运作机制和后续排查问题有巨大帮助。

2.2 业务模型设计：从校园书籍到社区交易

这个项目的标题点明了两个典型场景：“校园二手书籍交易”和“社区二手交易平台”。虽然场景不同，但其核心业务模型是相通的，都可以抽象为一个通用的C2C（消费者对消费者）二手商城模型。我们在设计时，需要兼顾通用性和场景特性。

核心实体分析：

用户（User）：这是系统的基石。除了基本的登录注册，针对二手交易的特点，用户模型需要额外字段，如信誉积分、手机号、头像、收货地址等。对于校园场景，可以增加学号、学院字段；对于社区场景，可以增加楼栋号、房间号（需注意隐私）或由用户自行填写模糊地址。
商品（Product/Item）：这是交易的核心对象。字段应包括：标题、详情描述、价格、原价、分类（如书籍、电子产品、服饰）、图片（多张）、新旧程度、上架状态、所属用户等。对于书籍这个特定品类，可以扩展子类或增加专用字段：ISBN号、作者、出版社、版次，这能极大提升搜索和管理的专业性。
商品分类（Category）：设计多级分类是必要的。例如，一级分类为“书籍”、“数码”、“日用”，书籍下又可分“教材教辅”、“文学小说”、“专业书籍”等。这关系到前端的导航和后端的检索效率。
订单（Order）：交易的法律凭证。包含：订单号、买家、卖家、商品、成交价格、数量、订单状态（待付款、待发货、待收货、已完成、已取消）、物流信息（模拟）、创建时间等。状态机设计是订单模块的关键。
聊天/留言（Chat/Message）：虽然不是所有二手平台都有，但加入一个简单的站内信或基于WebSocket的即时聊天功能，能让买卖双方沟通商品细节、议价，极大提升平台体验，也是毕业设计的一个亮点。
收藏/关注（Favorite）：用户行为数据，用于实现“我的收藏”功能，也能为后续可能的推荐系统埋点。

数据库设计心得：

表关系：用户与商品是一对多关系（一个用户发布多个商品）。商品与订单是一对多（一个商品在不同时间产生多个订单，但同一时间只应有一个有效订单）。订单与用户是多对多关系，通常拆解为买家和卖家两个外键。
索引优化：一定要在经常用于查询条件的字段上建立索引，如商品的标题、分类ID、状态、用户ID；订单的订单号、买家ID、卖家ID、状态。否则，当测试数据量稍大时，页面加载就会变得极其缓慢。
字段选择：价格字段使用Decimal类型，避免浮点数精度问题。对于“新旧程度”这类枚举值，可以用TinyInt存储数字，在代码中用枚举类映射，比直接存字符串更节省空间和提升查询效率。

2.3 技术栈选型与项目结构规划

基于SpringBoot，一个典型的技术选型组合如下，这也是本项目源码所采用的：

后端框架：SpringBoot 2.x + Spring MVC + Spring Data JPA / MyBatis-Plus。JPA的优势在于快速开发，基于方法名自动生成查询；MyBatis-Plus则提供了更灵活的SQL掌控力。本项目源码可能两者之一，理解其区别很重要。
数据库：MySQL 8.0。关系型数据库是这类业务的首选，事务支持完善。记得在本地和部署环境使用相同或兼容的版本。
缓存：Redis。用于存储会话（替代HttpSession）、热门商品列表、验证码等，能显著减轻数据库压力，提升响应速度。
前端：考虑到毕业设计的展示效果和分离趋势，采用前后端分离架构。前端可以选用Vue.js或React，配合Element UI或Ant Design等组件库。后端通过SpringBoot提供RESTful API。
构建与依赖管理：Maven。pom.xml文件的依赖管理是项目健康的晴雨表，要清晰分层。
其他工具：Lombok（简化POJO代码）、Swagger/knife4j（API文档生成）、Logback（日志）、Druid（数据库连接池）。

项目结构规划（Maven多模块建议）：对于稍复杂的毕业设计，推荐使用多模块结构，这能让项目层次更清晰，也显得更专业。

second-hand-mall ├── second-hand-mall-common // 通用模块：工具类、常量、枚举、通用配置 ├── second-hand-mall-dao // 数据持久层：实体、Repository/Mapper ├── second-hand-mall-service // 业务逻辑层：Service接口与实现 ├── second-hand-mall-api // Web控制层：Controller、DTO、VO └── second-hand-mall-web // 前端项目（或单独存放）

在单模块项目中，也应遵循类似的分包原则：com.xxx.entity,com.xxx.repository,com.xxx.service,com.xxx.controller,com.xxx.config。

3. 核心模块实现细节与实操要点

3.1 用户系统：安全与体验并重

用户模块是入口，安全性和用户体验是首要考虑。

1. 注册与登录实现：

密码存储：绝对禁止明文存储密码。使用Spring Security的BCryptPasswordEncoder进行哈希加盐处理。每次加密的盐值都不同，即使密码相同，密文也不同，安全性极高。

@Bean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } // 注册时加密 String encodedPassword = passwordEncoder.encode(rawPassword); // 登录时比对 boolean matches = passwordEncoder.matches(rawPassword, encodedPasswordFromDB);

验证码：为防止恶意注册和爆破登录，必须加入验证码。图形验证码（Kaptcha库）或短信验证码（接入阿里云、腾讯云SDK）均可。验证码需要存入Redis并设置短时过期（如5分钟）。
会话管理：在前后端分离架构下，通常采用无状态的Token机制（如JWT）替代传统的Session。用户登录成功后，服务器生成一个JWT Token返回给前端，前端后续请求在HTTP Header中携带此Token。这种方式更利于水平扩展。

2. 权限控制：二手平台至少需要两种角色：普通用户和管理员。使用Spring Security可以优雅地实现。

在用户实体中增加role字段（如：ROLE_USER,ROLE_ADMIN）。

配置Spring Security，指定不同URL路径所需的权限。

http.authorizeRequests() .antMatchers("/admin/**").hasRole("ADMIN") // 管理员后台路径 .antMatchers("/user/**").hasRole("USER") // 用户中心路径 .antMatchers("/public/**").permitAll() // 公开资源 .anyRequest().authenticated() // 其他所有请求需要认证 .and().formLogin().loginPage("/login") // 自定义登录页 .and().csrf().disable(); // 开发时可禁用CSRF，上线需考虑

在Controller方法上，可以使用@PreAuthorize("hasRole('ADMIN')")进行更细粒度的方法级控制。

实操心得：在开发阶段，为了方便测试，我经常先暂时放开所有权限，等核心功能跑通后再逐步加上安全控制。同时，一定要编写测试用例，模拟不同角色的用户访问受限接口，确保权限系统工作正常。

3.2 商品模块：发布、展示与搜索

商品模块是平台的核心，重点在于信息的结构化展示和高效检索。

1. 商品发布：

表单设计：前端表单应清晰分类，必填项和选填项明确。对于书籍，ISBN号可以设计为选填，但填写后可以尝试通过豆瓣等开放API自动补全书名、作者信息（这是一个不错的亮点）。
图片上传：这是难点也是重点。不能将用户上传的图片直接保存在应用服务器，因为不利于扩容和备份。推荐两种方案：
- 方案A：本地存储+动态路径：在application.yml中配置一个本地目录（如upload.path: /data/upload/），上传时生成唯一文件名（UUID+时间戳），保存到该目录。在Web配置中，将该目录映射为一个静态资源访问路径（如/upload/**）。
- 方案B：对象存储OSS：使用阿里云OSS、腾讯云COS等服务。这是生产环境的标准做法。虽然毕业设计可能不强制，但如果你能集成进去，会是一个大加分项。SDK集成简单，上传后直接返回一个可公网访问的URL存到数据库即可。
富文本详情：商品描述可能需要加粗、换行、列表。可以引入一个轻量级的富文本编辑器，如wangEditor。后端接收HTML字符串，存入数据库的TEXT类型字段。关键安全点：必须对接收到的HTML进行XSS过滤，防止脚本注入。可以使用Jsoup库进行白名单过滤。

2. 商品展示与搜索：

列表分页：使用Spring Data JPA的Pageable或MyBatis-Plus的Page对象，轻松实现分页。前端传递page（页码）和size（每页条数）参数。
多条件搜索：这是商品模块的复杂点。例如，用户想搜索“计算机教材”，价格在50元以下，九成新。后端需要动态构造查询条件。
- JPA方式：可以使用Specification进行动态查询，或者直接使用@Query写JPQL。
- MyBatis-Plus方式：使用QueryWrapper可以方便地链式调用like,eq,between等方法。
- 更复杂的搜索：如果条件非常多（如按品牌、型号、颜色等），可以考虑使用搜索引擎如Elasticsearch，但这对于基础毕业设计可能过重。一个折中方案是，将常用的、可枚举的筛选条件作为数据库字段，使用上述动态查询；对于标题、描述的全文本模糊搜索，使用数据库的LIKE语句（性能需注意，数据量大时考虑全文索引）。
排序：提供按发布时间（最新）、价格（从低到高/从高到低）、热度（浏览量）等多种排序方式。

3.3 订单与交易流程设计

交易流程是平台可信度的体现，状态设计必须严谨。

1. 状态机设计：一个完整的二手交易订单，其状态流转如下图所示（在脑海中构建）：待付款-> (已取消或超时取消) ->已付款/待发货->已发货/待收货->已收货/待评价->已完成。此外，还可能存在退款中、退款成功等状态。

在代码中，最好用一个枚举类来定义所有状态：

public enum OrderStatus { PENDING_PAYMENT, // 待付款 CANCELLED, // 已取消 PAID, // 已付款，待发货 SHIPPED, // 已发货，待收货 RECEIVED, // 已收货，待评价 COMPLETED, // 已完成 REFUNDING, // 退款中 REFUNDED // 已退款 }

并在订单实体中，记录状态变更日志（如statusLog字段），便于追溯。

2. 下单与库存（或状态）锁定：二手商品具有唯一性。当用户下单时，必须确保该商品在付款期间不会被其他人买走。这涉及到“库存”概念，虽然二手商品库存通常为1，但逻辑相通。

悲观锁：在查询商品信息准备创建订单时，使用SELECT ... FOR UPDATE锁定该商品记录，防止其他事务同时修改。这种方式简单直接，但并发度低。
乐观锁：在商品表中增加一个version版本号字段。更新商品状态时，同时检查version是否与查询时一致。这是更推荐的方式，并发性能更好。
```
UPDATE product SET status = 'SOLD', version = version + 1 WHERE id = ? AND version = ?;
```
业务状态判断：在下单逻辑的最开始，先检查商品状态是否为“在售”。这是一种最前置的、低成本的检查。

3. 支付集成（模拟）：对于毕业设计，真实对接微信支付或支付宝可能过于复杂且涉及企业资质。通常采用“模拟支付”的方式。

创建一个“支付”Controller，接收订单号。
在该接口中，直接修改订单状态为“已付款”，并可能模拟调用一个第三方支付成功的回调URL。
为了更逼真，可以设计一个简单的支付密码验证，或者生成一个模拟的支付流水号。

踩坑记录：订单超时取消是关键功能。我最初用了一个定时任务每分钟扫描所有“待付款”订单，检查创建时间是否超过30分钟。但在测试时发现，如果服务器重启，任务可能错过一些订单。后来改用延迟消息队列（如RabbitMQ的TTL+死信队列）来实现。更简单的方案是，在用户查询“我的订单”时，如果发现有待付款订单已超时，则异步触发取消逻辑。虽然不精确，但对于毕业设计演示足够。

3.4 聊天功能实现：提升平台互动性

站内信或即时聊天功能能极大提升用户体验。这里介绍两种实现思路：

1. 简易站内信：

数据库设计一张message表，字段包括：id,sender_id,receiver_id,content,related_product_id（关联的商品，可选），is_read,create_time。
提供API：发送消息、获取与某个用户的对话列表、将某个对话的消息标记为已读。
前端可以做一个简单的消息列表页，点击后进入对话详情页。这种方式实现简单，但实时性差，需要用户刷新页面。

2. 基于WebSocket的即时聊天：这是更高级、更吸引人的实现。

后端引入spring-boot-starter-websocket依赖。
配置WebSocket端点，并定义一个WebSocketHandler来处理连接、收发消息、断开连接等事件。
核心在于会话管理。当用户登录后，前端建立WebSocket连接，并将自己的用户ID作为参数传递。后端需要维护一个ConcurrentHashMap，将用户ID和其对应的WebSocketSession关联起来。
当用户A给用户B发送消息时，后端根据用户B的ID从Map中找到其Session，然后通过该Session将消息发送出去。如果用户B不在线，则消息存入数据库，待其上线后拉取。
前端需要处理WebSocket的连接、接收消息、发送消息以及断线重连的逻辑。

注意事项：WebSocket连接是长连接，需要考虑连接数对服务器资源的消耗。在毕业设计中，演示几个用户同时在线聊天没有问题。此外，消息内容同样需要进行XSS过滤和安全审查。

4. 开发、调试与部署实战

4.1 本地开发环境搭建与配置

基础环境：确保本地安装JDK 8或11、Maven、MySQL、Redis、IDE（IntelliJ IDEA或Eclipse）。
导入项目：将源码导入IDE，Maven会自动下载依赖。检查pom.xml，确认SpringBoot版本和各依赖版本无冲突。
数据库初始化：在MySQL中创建数据库（如second_hand_db）。项目通常会提供数据库脚本（schema.sql和data.sql）或使用JPA的ddl-auto配置（开发时可设为update，生产环境必须设为none或validate）。务必先备份，再执行脚本。

配置文件：修改application.yml或application.properties中的关键配置：

spring: datasource: url: jdbc:mysql://localhost:3306/second_hand_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379 password: # 如果设置了的话 servlet: multipart: max-file-size: 10MB # 文件上传大小限制 max-request-size: 20MB # 自定义配置 upload: path: /tmp/upload/ # 本地文件上传路径

启动项目：找到主启动类（通常有@SpringBootApplication注解），直接运行。观察控制台日志，确保没有报错，并看到Tomcat启动在8080端口的提示。

4.2 接口调试与API文档生成

在前后端分离开发中，后端工程师需要一种方式清晰地告诉前端API的细节。Swagger（或国内更流行的knife4j）是完美解决方案。

集成knife4j：在pom.xml中引入com.github.xiaoymin:knife4j-spring-boot-starter依赖。

添加配置类：

@Configuration @EnableSwagger2WebMvc public class SwaggerConfig { @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.basePackage("com.xxx.controller")) // 指定扫描的包 .paths(PathSelectors.any()) .build(); } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("校园二手平台API文档") .description("毕业设计项目接口文档") .version("1.0") .build(); } }

使用注解：在Controller和API方法上使用@Api,@ApiOperation,@ApiParam等注解描述接口。
访问文档：启动项目后，访问http://localhost:8080/doc.html即可看到美观的API文档页面，并可以直接在页面上进行接口调试，无需Postman。

4.3 常见问题排查与解决实录

在开发过程中，你几乎一定会遇到下面这些问题：

问题1：启动报错Failed to configure a DataSource: 'url' attribute is not specified

原因：SpringBoot没有找到数据库配置，或者配置有误。
解决：
1. 检查application.yml中spring.datasource下的配置项拼写是否正确，缩进是否对齐（YAML对缩进敏感）。
2. 确认MySQL服务是否已启动。
3. 检查数据库驱动依赖是否引入（mysql-connector-java）。

问题2：插入中文数据到MySQL变成乱码

原因：数据库、连接、表三者的字符集不统一。
解决：
1. 确保MySQL数据库和表的字符集为utf8mb4（支持所有Unicode字符，包括emoji）。
2. 在JDBC连接URL中显式指定字符集：jdbc:mysql://...?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai。
3. 检查IDE和控制台的输出字符集是否为UTF-8。

问题3：静态资源（如图片）无法访问

原因：SpringBoot对静态资源的映射路径有默认规则，自定义上传路径后需要额外配置。

解决：创建一个配置类实现WebMvcConfigurer，添加资源映射。

@Configuration public class WebConfig implements WebMvcConfigurer { @Value("${upload.path}") private String uploadPath; @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 将本地文件路径映射为网络访问路径 registry.addResourceHandler("/upload/**") .addResourceLocations("file:" + uploadPath); } }

上传文件保存到/tmp/upload/abc.jpg后，即可通过http://localhost:8080/upload/abc.jpg访问。

问题4：事务不回滚

原因：Spring事务默认只对运行时异常（RuntimeException）进行回滚，对检查时异常（Exception）不回滚。
解决：
1. 在Service方法上使用@Transactional(rollbackFor = Exception.class)，指定所有异常都回滚。
2. 确保数据库引擎是支持事务的InnoDB。
3. 确保调用事务方法的方式是在代理对象上调用。在同一个类内部，方法A调用方法B，即使B有@Transactional注解，事务也不会生效。这是Spring AOP代理的机制。

问题5：前端跨域（CORS）错误

原因：当前端项目运行在localhost:3000，后端在localhost:8080，浏览器出于安全策略会阻止跨域请求。

解决：在后端配置全局CORS。

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

4.4 项目部署上线（以Linux服务器为例）

毕业设计最终需要演示，部署到公网可访问的服务器是最好的方式。

环境准备：购买一台云服务器（如阿里云ECS，学生有优惠），安装CentOS/Ubuntu系统。通过SSH连接。

安装基础软件：

# 更新系统 sudo apt update && sudo apt upgrade -y # 安装JDK sudo apt install openjdk-11-jdk -y # 安装MySQL sudo apt install mysql-server -y # 安装Redis sudo apt install redis-server -y # 配置MySQL（设置root密码，创建数据库和用户） sudo mysql_secure_installation mysql -u root -p CREATE DATABASE second_hand_db CHARACTER SET utf8mb4; CREATE USER 'secondhand'@'%' IDENTIFIED BY 'StrongPassword123!'; GRANT ALL PRIVILEGES ON second_hand_db.* TO 'secondhand'@'%'; FLUSH PRIVILEGES;

打包项目：在本地项目根目录下，使用Maven打包。
```
mvn clean package -DskipTests
```
打包成功后，在target目录下会生成一个xxx-0.0.1-SNAPSHOT.jar文件。

上传与运行：使用FTP工具（如FileZilla）或scp命令将JAR包上传到服务器。

scp target/your-project.jar user@your-server-ip:/home/ubuntu/

在服务器上运行：

cd /home/ubuntu # 后台运行，并将日志输出到nohup.out nohup java -jar your-project.jar --spring.profiles.active=prod > nohup.out 2>&1 & # 查看进程和日志 ps aux | grep java tail -f nohup.out

配置生产环境：在服务器上创建application-prod.yml文件，配置生产环境的数据库连接、Redis地址、文件上传路径（需确保目录存在且有写权限）等。在启动命令中通过--spring.profiles.active=prod指定使用该配置。
域名与Nginx（可选但推荐）：如果你有域名，可以配置Nginx反向代理，将80端口的HTTP请求转发到8080端口的SpringBoot应用，还可以配置SSL证书实现HTTPS。
```
server { listen 80; server_name your-domain.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }
```

5. 毕业设计文档与答辩要点

一份优秀的毕业设计，除了可运行的代码，清晰规范的文档和有条理的答辩同样重要。

5.1 如何组织你的项目文档？

文档不是代码的简单重复，而是对设计思路、实现过程和结果的系统性阐述。建议包含以下部分：

需求分析说明书：阐述项目背景（校园/社区二手交易痛点）、目标用户、功能性需求（用例图/用例描述）、非功能性需求（性能、安全性等）。
系统设计说明书：
- 总体设计：系统架构图（展示前后端、数据库、缓存等组件）、技术选型表。
- 数据库设计：ER图、核心表结构说明（字段名、类型、含义、约束）。
- 接口设计：核心功能的API列表（可用Swagger截图补充），重点接口的请求/响应示例。
- 模块设计：对用户、商品、订单、聊天等核心模块的类图、时序图（如“用户下单时序图”）。
部署与使用手册：详细说明如何配置环境、导入数据、启动项目、访问系统。最好能提供两种方式：本地运行和服务器部署。
测试报告：单元测试（JUnit）覆盖了哪些核心Service方法；接口测试（Postman或Swagger）的主要用例和结果；系统主要功能的手工测试用例和截图。
总结与展望：总结项目完成情况、遇到的难点及解决方案、个人收获。对项目的不足和未来可扩展方向进行展望（如引入推荐算法、接入真实支付、开发移动端APP等）。

5.2 答辩准备与演示技巧

答辩是展示你工作成果的关键时刻。

PPT精炼，突出重点：PPT不是文档的复制。首页：题目、姓名、导师。内容页：项目背景与意义（1页）、系统架构与技术栈（1页）、核心功能演示（这是重点，3-4页，用流程图+界面截图串联讲一个完整故事，如“从发布商品到完成交易”）、难点与解决方案（1-2页，展示你的思考深度）、总结与展望（1页）。总共控制在15页以内。
演示环境准备万全：
- Plan A（首选）：将项目部署到公网服务器，直接浏览器访问演示。确保网络通畅，提前测试所有演示流程。
- Plan B（备用）：在本地电脑运行，准备好所有环境，关闭无关软件。可以提前录屏，以防现场环境出问题。
- 数据准备：提前在数据库里插入一些真实的测试数据（用户、商品、订单），让演示看起来更饱满。
讲述逻辑清晰：不要念PPT。用讲故事的方式：“我们发现校园里二手书交易有XX问题，所以我想做一个平台来解决它。我选择了SpringBoot因为...。大家看，这是首页，用户可以...。这里我遇到了一个商品并发下单的问题，我是通过乐观锁解决的...”。
预判评委问题：
- 技术细节：“SpringBoot自动配置原理？”“你的数据库事务是怎么管理的？”“如何防止SQL注入？”（回答：MyBatis使用#{}预编译，JPA使用参数化查询）。
- 设计思考：“为什么用Redis而不用本地缓存？”“你的搜索功能如果数据量很大，怎么优化？”“聊天功能为什么选WebSocket而不是轮询？”
- 项目扩展：“如果用户量暴增，你的系统架构哪里会成为瓶颈？如何改进？”
态度诚恳，实事求是：对评委提出的问题，知道就清晰回答，不知道或没考虑过，可以坦诚地说“这个问题我在设计时确实没有深入考虑，根据我的理解，可能的思路是...”，展现你的学习能力和思维过程，远比强行辩解要好。