SpringBoot校园二手书交易平台：从架构设计到实战部署全解析

简介：这是一套面向计算机专业本科生的毕业设计/课程设计实战资源，聚焦校园二手书交易场景，提供从需求分析、系统设计到完整实现的全链路参考方案。资源采用SpringBoot+Vue+MySQL前后端分离架构，覆盖用户管理、书籍发布、在线沟通、订单处理等核心模块，兼顾教学适配性与工程规范性，助力学生高效完成大作业或提升全栈开发能力。压缩包共809个文件，含125个Java后端逻辑文件、157个JavaScript前端脚本、66个Vue组件、50个CSS样式文件及1个SQL数据库脚本，另有运行说明文档与配套论文，整体大小24.92MB。所有代码经测试可直接运行，配套bat脚本简化部署流程，文档详述环境配置与接口调用方式，降低学习门槛，特别适合零基础实践者快速上手并深入理解分层架构与RESTful开发模式。

1. 项目概述：一个校园里的“闲鱼”是怎么炼成的

每次毕业季，看着宿舍里堆积如山、带不走又舍不得扔的教材和课外书，你是不是也感到头疼？另一边，刚入学的新生又在为动辄上百元的新书发愁。这个经典的校园痛点，催生了我们今天要拆解的项目——基于SpringBoot的校园二手书交易平台。这不仅仅是一个简单的“课程设计”或“毕业设计”，它本质上是一个微型的、垂直领域的电商系统，麻雀虽小，五脏俱全。我见过太多同学做这类项目时，要么停留在简单的CRUD（增删改查），要么被复杂的业务逻辑绕晕，最后交出一个勉强能跑但毫无亮点的Demo。

这个项目的核心价值在于，它用SpringBoot这套现代Java开发框架，将一个真实的商业场景简化并落地到校园环境中。你得到的不仅仅是一套能运行的源码和一篇格式规范的论文，更是一个完整的、可深度学习的全栈开发案例。从用户发帖卖书，到买家搜索、下单、支付（哪怕是模拟支付），再到订单管理和后台数据统计，它覆盖了一个交易平台最核心的链路。对于正在学习Java Web开发、尤其是SpringBoot生态的同学来说，亲手实现一遍这个项目，远比死记硬背面试题来得深刻。接下来，我会带你从设计思路到代码细节，再到那些论文里不会写的“坑”，彻底拆解这个校园二手书交易平台。

2. 整体架构设计与技术选型背后的逻辑

为什么是SpringBoot？这是很多新手第一个会问的问题。在早期，我们搭建一个Java Web项目，需要手动整合Spring、SpringMVC、MyBatis，配置大量的XML文件，处理令人头疼的依赖冲突和服务器部署。SpringBoot的出现，就像给Java开发装上了“自动驾驶”，它通过约定大于配置和自动装配的理念，让开发者能快速搭建一个独立运行、生产级别的应用。

2.1 核心架构：分层与解耦

一个健壮的交易平台，代码绝不能是“一锅粥”。我们采用经典的分层架构，这不仅是代码组织的艺术，更是应对未来需求变化的工程保障。

1. 控制层（Controller）：这是系统的“前台接待”。它负责接收用户的HTTP请求（比如点击“购买”按钮），对请求参数进行基本校验（比如书籍ID不能为空），然后调用对应的服务层方法处理业务，最后将处理结果（成功或失败的消息、跳转的页面等）返回给前端。在SpringBoot中，我们使用@RestController或@Controller注解来标识它。

2. 服务层（Service）：这是系统的“业务大脑”。所有核心逻辑都住在这里，比如：计算书籍总价、检查库存、生成订单号、更新用户积分等。Controller层只负责“转发”，真正的“思考”和“决策”在Service层完成。这样做的好处是业务逻辑高度集中，便于维护和单元测试。我们通常会用@Service注解来标记它。

3. 数据访问层（Mapper/Dao）：这是系统的“仓库管理员”。它的职责非常单一：与数据库打交道。执行SQL语句，将数据库中的记录映射成Java对象（ORM），或者将Java对象的变化持久化到数据库。我们使用MyBatis-Plus作为数据访问框架，它极大地简化了单表CRUD的操作。

4. 实体层（Entity）：这是系统的“数据模型”。它定义了业务中核心对象的结构，比如User（用户）、Book（书籍）、Order（订单）。每个实体类通常对应数据库中的一张表。使用@Data注解（来自Lombok）可以自动生成getter、setter等方法，让代码更简洁。

5. 视图层（View）：在前后端不分离的传统模式中，这里指的是JSP、Thymeleaf等模板页面。但在更现代的架构中，前端往往是一个独立的Vue.js或React项目，通过RESTful API与后端交互。本项目源码可能采用前者，因为对于课程设计来说更直观。

注意：分层架构的关键在于单向依赖：Controller -> Service -> Mapper。绝对要避免Service层直接调用Controller，或者Mapper层包含业务逻辑。清晰的边界是代码可维护性的生命线。

2.2 技术栈深度解析

除了SpringBoot这个核心，项目中用到的其他技术每一个都有其不可替代的作用：

• MyBatis-Plus vs 原生MyBatis：如果你看到代码中有类似bookService.save(book)或bookMapper.selectList(queryWrapper)的写法，那就是用了MyBatis-Plus。它是对MyBatis的增强，内置了通用Mapper和Service，无需编写简单SQL，能提升数倍开发效率。但切记，复杂联表查询仍需手写XML或注解SQL。
• Thymeleaf 模板引擎：它允许你在HTML中直接使用Spring表达式来渲染后端数据（如<span th:text="${book.price}">）。相比于古老的JSP，它语法更自然，支持HTML5，且能与SpringBoot无缝集成。
• MySQL 数据库：关系型数据库是存储交易、用户、订单这类强一致性数据的最佳选择。表结构设计是重中之重，比如“书籍”表与“订单”表如何关联？“用户”表如何存储加密后的密码？
• Lombok：这是一个开发“神器”，通过注解（如@Data，@AllArgsConstructor）在编译时自动生成代码，让你的实体类变得异常简洁，避免了冗长的getter/setter和构造方法。
• Spring Security 或 Shiro（可能选用）：用于权限控制。例如，未登录用户不能发布商品，卖家不能修改别人的书籍信息。这是保障平台安全性的关键组件。

选型心得：对于校园二手平台这种并发量不高但业务模块清晰的项目，SpringBoot + MyBatis-Plus + Thymeleaf + MySQL 的组合是“黄金搭档”。它平衡了开发效率、学习成本和运行性能，能让开发者更专注于业务逻辑本身，而不是框架配置。

3. 核心功能模块拆解与实现要点

一个交易平台，无论大小，都绕不开“商品”、“交易”、“人”这三个核心要素。我们来逐一拆解。

3.1 用户系统：不止于注册登录

用户模块是平台的基石。它远不止“输入用户名密码”那么简单。

1. 安全是第一要务

• 密码存储：绝对不能用明文存密码！必须使用BCrypt等强哈希算法进行加密。Spring Security提供了现成的BCryptPasswordEncoder，调用encode(rawPassword)和matches(rawPassword, encodedPassword)即可。
• 会话管理：用户登录后，如何维持其登录状态？通常使用HttpSession或Token（如JWT）。对于校园内网应用，Session更简单直接。核心是将在服务器端创建的Session ID与用户信息关联，并通过Cookie传递给浏览器。
• 权限设计：至少需要区分“普通用户”、“管理员”。更细化的可以设计“未认证学生”、“已认证学生”、“毕业生”等角色，对应不同的发布权限。可以使用注解如@PreAuthorize("hasRole('ADMIN')")进行方法级控制。

2. 用户画像与积分体系（增值点）为了让平台更有粘性，可以引入简单的积分体系。例如：

• 成功发布一本书籍：+10积分。
• 成功完成一笔交易：买卖双方各+20积分。
• 积分可用于兑换平台优惠券或参与抽奖。 这需要在用户表中增加credit字段，并在相应的Service方法中增加积分更新逻辑。

3.2 商品（书籍）模块：如何高效地“淘书”

这是平台的核心资源。设计重点在于如何让买家快速找到想要的书。

1. 书籍信息结构化书籍表（book）的设计不能只有一个title字段。应考虑：

• isbn：国际标准书号，用于精确匹配。
• title：书名。
• author：作者。
• press：出版社。
• edition：版次。
• major：所属专业（计算机、经管、外语等）。
• course：对应课程名称。
• degree_of_wear：磨损程度（全新、九成新、有笔记等）。
• original_price&current_price：原价和现价。
• cover_image：封面图片URL。
• seller_id：关联卖家用户ID。
• status：状态（上架、已售、下架）。

2. 搜索与筛选功能实现这是用户体验的关键。不能只靠数据库的LIKE模糊查询。

• 多条件动态查询：使用MyBatis-Plus的QueryWrapper可以优雅地构建动态SQL。前端传递专业、课程、价格区间等参数，后端根据参数是否为空动态拼接查询条件。

  QueryWrapper<Book> wrapper = new QueryWrapper<>(); wrapper.eq(StringUtils.isNotBlank(major), "major", major) .like(StringUtils.isNotBlank(keyword), "title", keyword) .between(priceMin != null && priceMax != null, "current_price", priceMin, priceMax) .eq("status", "ON_SALE"); // 只查在售的 List<Book> bookList = bookMapper.selectList(wrapper);

• 简易全文搜索：如果对搜索要求更高，可以引入Elasticsearch，但对于课程项目，使用MySQL的FULLTEXT索引配合MATCH...AGAINST语句也是一个不错的折中方案。

3. 图片上传处理SpringBoot处理文件上传非常方便，使用MultipartFile接口即可。关键点：

• 限制上传文件大小（在application.yml中配置spring.servlet.multipart.max-file-size）。
• 对文件名进行重命名（如UUID），防止重名覆盖和安全问题。
• 指定一个独立的静态资源目录（如/upload/）存放图片，并配置静态资源映射，使得http://localhost:8080/upload/xxx.jpg可以访问到图片。

3.3 交易与订单模块：构建信任闭环

交易是平台的价值体现，订单则是交易的法律凭证。这里逻辑最复杂。

1. 购物车 vs 直接购买对于二手书平台，单品交易居多，购物车并非必需。但实现一个简易购物车能提升体验。核心是：

• 未登录时，购物车信息可暂存于浏览器本地（LocalStorage）。
• 登录后，合并本地购物车到服务器端的用户购物车表（cart）中，表结构通常包含user_id,book_id,quantity。

2. 订单状态机订单（order）表的设计和状态流转是核心。一个典型的二手书订单状态流如下：待付款-> (买家取消) ->已取消待付款-> (买家付款) ->待发货-> (卖家发货) ->待收货-> (买家确认收货) ->已完成待收货-> (买家退款/退货) ->退款中-> ... (后续可能涉及仲裁)

在代码中，可以用枚举类（Enum）来定义这些状态，确保状态变更的严谨性。

3. 模拟支付与库存扣减校园项目通常不需要对接真正的支付网关（如支付宝、微信支付）。可以模拟支付流程：

• 点击“支付”后，调用一个PaymentService.pay(orderId)方法。
• 在该方法内，首先校验订单状态是否为“待付款”，然后模拟一个支付成功的逻辑（如睡眠2秒模拟网络请求），最后将订单状态更新为“待发货”。
• 关键操作：在支付成功的逻辑里，必须同步将对应书籍的status字段从“上架”改为“已售”。这个操作需要放在一个数据库事务（@Transactional）中，确保“订单状态更新”和“书籍状态更新”要么同时成功，要么同时失败，防止出现书卖了但订单没生成的数据不一致灾难。

3.4 后台管理模块：平台的驾驶舱

后台是给管理员（通常是学生会或社团）使用的，用于监控和治理平台。

核心功能应包括：

• 用户管理：查看所有用户，封禁违规用户。
• 商品审核：新发布的书籍可能需要审核后才能公开显示，防止不良信息。
• 订单监控：查看所有订单，处理异常订单（如长期不发货）。
• 数据统计：简单的图表展示，如每日交易额、最热销书籍类别、用户增长曲线等。可以使用ECharts等前端库来可视化。

实现技巧：后台的前端页面可以单独使用一套模板（如AdminLTE），通过权限控制确保只有管理员角色才能访问/admin/**路径下的资源。

4. 数据库设计与关键表结构分析

数据库设计是系统的骨架，设计得好，后期编码顺风顺水；设计得差，到处是坑。这里给出几个核心表的设计思路。

用户表 (user)

书籍表 (book)

订单表 (order)

踩坑实录：订单ID设计：为什么订单主键不直接用自增ID？因为自增ID有规律，容易被猜测，存在一定的安全风险（如遍历订单号）。使用随机的UUID或“时间戳+随机数”生成的订单号，安全性和唯一性更好。order_no字段则可以设计成更友好的格式，如202405210001（日期+序列）。

表关系图（概念）：

用户 (User) │ 1 │ owns ▼ n 书籍 (Book) 1 ────── n 订单 (Order) │ │ │ (seller) │ (buyer) ▼ (关联) ▼ (关联) 用户 (User) 用户 (User)

一个用户可以发布多本书（1:n）。一本书在一个时间点只能属于一个订单（1:1），但历史上有多个订单（1:n）。一个订单关联一个买家和一本具体的书。

5. 典型业务场景代码实现剖析

光说不练假把式，我们看几个核心业务逻辑的代码片段，理解SpringBoot如何让这些逻辑落地。

5.1 用户注册与密码加密

@Service public class UserServiceImpl implements UserService { @Autowired private UserMapper userMapper; @Autowired private BCryptPasswordEncoder passwordEncoder; // 注入密码编码器 @Override @Transactional // 开启事务，确保数据一致性 public boolean register(UserRegisterDTO userDTO) { // 1. 校验用户名是否已存在 QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq("username", userDTO.getUsername()); if (userMapper.selectOne(wrapper) != null) { throw new RuntimeException("用户名已存在"); } // 2. DTO转Entity，并加密密码 User user = new User(); BeanUtils.copyProperties(userDTO, user); // 使用Spring工具类复制属性 user.setPassword(passwordEncoder.encode(userDTO.getPassword())); // 关键！加密存储 user.setRole("USER"); // 默认角色 user.setCreateTime(LocalDateTime.now()); // 3. 插入数据库 return userMapper.insert(user) > 0; } }

注意：UserRegisterDTO是一个数据传输对象，用于接收前端参数，它通常只包含注册必需的字段（用户名、密码、邮箱等），而不包含id、createTime等系统字段。这符合领域驱动设计（DDD）的思想，将入参、实体、出参分离，使代码更清晰。

5.2 书籍发布与图片上传

@RestController @RequestMapping("/book") public class BookController { @Autowired private BookService bookService; @PostMapping("/publish") public Result publishBook(@RequestParam("file") MultipartFile file, BookPublishDTO bookDTO, HttpSession session) { // 1. 权限校验：必须登录 User currentUser = (User) session.getAttribute("user"); if (currentUser == null) { return Result.error("请先登录"); } // 2. 处理上传的封面图片 if (file.isEmpty()) { return Result.error("请上传书籍封面"); } String originalFilename = file.getOriginalFilename(); // 生成唯一文件名，防止冲突和攻击 String fileExtension = originalFilename.substring(originalFilename.lastIndexOf(".")); String newFileName = UUID.randomUUID().toString() + fileExtension; Path filePath = Paths.get("/upload/cover/", newFileName); // 指定存储目录 try { Files.copy(file.getInputStream(), filePath, StandardCopyOption.REPLACE_EXISTING); } catch (IOException e) { e.printStackTrace(); return Result.error("文件上传失败"); } // 构建可访问的URL String coverUrl = "/upload/cover/" + newFileName; bookDTO.setCoverImage(coverUrl); // 3. 设置卖家ID，并调用Service发布书籍 bookDTO.setSellerId(currentUser.getId()); boolean success = bookService.publish(bookDTO); return success ? Result.ok("发布成功") : Result.error("发布失败"); } }

5.3 下单与模拟支付（事务控制）

这是整个系统最需要保证数据一致性的地方。

@Service public class OrderServiceImpl implements OrderService { @Autowired private OrderMapper orderMapper; @Autowired private BookMapper bookMapper; @Override @Transactional(rollbackFor = Exception.class) // 声明式事务，任何异常都回滚 public boolean createOrder(OrderCreateDTO orderDTO) { // 1. 校验书籍是否存在且状态为在售 Book book = bookMapper.selectById(orderDTO.getBookId()); if (book == null || !"ON_SALE".equals(book.getStatus())) { throw new RuntimeException("书籍不存在或已售出"); } // 2. 创建订单对象 Order order = new Order(); order.setOrderNo(generateOrderNo()); // 生成订单号 order.setBookId(book.getId()); order.setSellerId(book.getSellerId()); order.setBuyerId(orderDTO.getBuyerId()); order.setTotalAmount(book.getCurrentPrice()); order.setStatus("PENDING_PAYMENT"); // 待付款 order.setCreateTime(LocalDateTime.now()); // 3. 保存订单 int insertCount = orderMapper.insert(order); if (insertCount <= 0) { return false; } // 4. 立即更新书籍状态为“已售”，防止超卖 Book updateBook = new Book(); updateBook.setId(book.getId()); updateBook.setStatus("SOLD"); int updateCount = bookMapper.updateById(updateBook); if (updateCount <= 0) { // 如果更新失败，上面插入的订单会被事务回滚 throw new RuntimeException("书籍状态更新失败，订单创建失败"); } // 5. 可以在这里发送通知给卖家（如站内信、邮件） // notificationService.notifySeller(book.getSellerId(), "您的书籍已被下单！"); return true; } @Override @Transactional public boolean payOrder(String orderNo) { // 模拟支付逻辑 Order order = orderMapper.selectByOrderNo(orderNo); if (!"PENDING_PAYMENT".equals(order.getStatus())) { throw new RuntimeException("订单状态异常，无法支付"); } // 模拟支付处理... try { Thread.sleep(2000); // 模拟网络延迟 } catch (InterruptedException e) { Thread.currentThread().interrupt(); } // 更新订单状态为“待发货” Order updateOrder = new Order(); updateOrder.setId(order.getId()); updateOrder.setStatus("PENDING_DELIVERY"); updateOrder.setPaymentTime(LocalDateTime.now()); return orderMapper.updateById(updateOrder) > 0; // 注意：书籍状态在createOrder时已改为SOLD，这里无需再改 } private String generateOrderNo() { // 简单示例：时间戳+随机数 return "ORD" + System.currentTimeMillis() + (int)((Math.random()*9+1)*1000); } }

核心要点：@Transactional注解是保证“下单”这个操作原子性的关键。它确保“插入订单记录”和“更新书籍状态”这两个数据库操作，要么一起成功，要么一起失败。在并发情况下，虽然这里仍有极小的超卖风险（两个请求同时查到同一本ON_SALE的书），但对于校园级应用，可以通过在查询时使用SELECT ... FOR UPDATE（悲观锁）或使用Redis分布式锁来进一步规避，这在课程设计中属于加分项。

6. 前端页面交互与用户体验优化

后端逻辑再扎实，前端交互拉胯，项目也会大打折扣。对于使用Thymeleaf模板的项目，前后端耦合较紧，更需要注意逻辑清晰。

6.1 页面跳转与数据传递

Thymeleaf通过在Controller中向Model添加属性，在HTML页面中直接渲染。

@GetMapping("/book/detail/{id}") public String bookDetail(@PathVariable Long id, Model model) { Book book = bookService.getBookDetailById(id); if (book == null) { return "error/404"; // 返回错误页面 } model.addAttribute("book", book); // 可以同时查询卖家其他书籍 List<Book> otherBooks = bookService.getBooksBySeller(book.getSellerId()); model.addAttribute("otherBooks", otherBooks); return "book/detail"; // 对应 /templates/book/detail.html }

在detail.html中，可以使用Thymeleaf语法获取数据：<h2 th:text="${book.title}">书名</h2>。

6.2 异步交互提升体验

即使不用Vue/React，也可以用jQuery或原生JavaScript实现局部刷新，提升体验。

• 加入购物车：点击按钮，通过Ajax将书籍ID发送到后端，后端操作成功后，前端动态更新页面上的购物车图标数量，而不是刷新整个页面。
• 收藏书籍：同理，通过Ajax请求，后端更新用户-书籍关联表，前端切换按钮状态（实心❤️/空心🤍）。

6.3 响应式布局考虑

学生可能用电脑，也可能用手机访问。使用Bootstrap等前端框架可以快速搭建响应式页面，确保在手机端也能正常浏览和操作。这是论文和答辩中的亮点。

7. 项目部署与上线实践

开发完成只是第一步，让项目在服务器上跑起来，才是真正的完成。

7.1 环境准备与打包

1. 确保生产环境配置：在application-prod.yml中配置生产环境的数据库连接、日志级别、文件上传路径等。使用spring.profiles.active=prod激活。
2. 打包项目：在项目根目录下执行Maven命令：mvn clean package -DskipTests。这会在target目录下生成一个可执行的JAR包（如campus-secondhand-book-0.0.1-SNAPSHOT.jar）。SpringBoot内置了Tomcat服务器，因此这个JAR包是自包含的。

7.2 Linux服务器部署（以CentOS为例）

# 1. 通过SFTP或Git将JAR包上传到服务器，例如 /home/app/ # 2. 在服务器上运行（后台运行并输出日志） nohup java -jar /home/app/campus-secondhand-book-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod > /home/app/app.log 2>&1 & # 3. 使用简单的脚本管理（start.sh） #!/bin/bash APP_NAME=campus-secondhand-book-0.0.1-SNAPSHOT.jar APP_HOME=/home/app cd $APP_HOME nohup java -jar $APP_NAME --spring.profiles.active=prod > app.log 2>&1 & echo "Application started." # 4. 查看日志 tail -f /home/app/app.log

7.3 使用Nginx进行反向代理

直接使用8080端口访问不专业，且无法部署前端静态资源。Nginx可以解决这个问题。

# 在 /etc/nginx/conf.d/ 下新建一个配置文件，如 book.conf server { listen 80; server_name your-domain.com; # 或服务器IP # 静态资源（如图片）由Nginx直接处理，效率更高 location /upload/ { alias /home/app/upload/; # 指向你文件上传的实际目录 expires 7d; # 设置缓存 } # 将所有API请求转发给后端SpringBoot应用 location / { proxy_pass http://127.0.0.1:8080; # SpringBoot应用默认端口 proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

配置完成后，重启Nginx：sudo systemctl restart nginx。现在，用户访问http://your-domain.com就能看到你的网站了。

8. 开发中常见问题与调试技巧

在实际编码中，你一定会遇到下面这些问题。

8.1 依赖冲突与版本问题

这是SpringBoot项目最经典的“坑”。表现为启动报ClassNotFoundException、NoSuchMethodError或功能异常。

• 排查方法：使用mvn dependency:tree命令打印完整的依赖树，查看是否有同一个库的不同版本。SpringBoot的spring-boot-starter-parent已经管理了大量常用依赖的版本，不要轻易覆盖。
• 解决方案：在pom.xml中，使用<exclusions>标签排除冲突的传递性依赖，然后显式引入正确的版本。

8.2 数据库连接池耗尽

在高并发测试或编写不当的循环中，可能会出现Cannot get connection from datasource的错误。

• 原因：数据库连接没有正确关闭。
• 解决：确保在使用MyBatis-Plus的Service或Mapper时，框架会自动管理连接。但如果手写了JDBC代码或复杂逻辑，务必在finally块中关闭Connection、Statement、ResultSet。推荐使用try-with-resources语法。
• 配置优化：在application.yml中调整HikariCP（SpringBoot默认连接池）参数：

  spring: datasource: hikari: maximum-pool-size: 10 # 根据实际情况调整 connection-timeout: 30000 idle-timeout: 600000

8.3 事务失效的几种情况

@Transactional注解不生效，导致数据不一致。

1. 方法非public：@Transactional只能用于public方法。
2. 自调用问题：在同一个类中，一个没有@Transactional注解的方法A，调用了有@Transactional注解的方法B，事务不会生效。因为事务是基于AOP代理的，自调用不走代理。
3. 异常被捕获：如果在方法中try-catch了异常，但没有在catch块中重新抛出（throw new RuntimeException(e)），事务管理器会认为方法执行成功，从而提交事务。
4. 异常类型不匹配：默认只回滚RuntimeException和Error。如果抛出的是IOException等受检异常，需要指定@Transactional(rollbackFor = Exception.class)。

8.4 跨域问题（CORS）

如果后期你想单独开发一个Vue前端来对接这个SpringBoot后端，就会遇到跨域问题。浏览器出于安全考虑，会阻止前端页面向不同源（协议、域名、端口任一不同）的后端发起请求。

• 解决方案：在后端添加一个全局CORS配置。

  @Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") // 对所有接口 .allowedOriginPatterns("*") // 允许所有源，生产环境应指定具体前端地址 .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowCredentials(true) .maxAge(3600); } }

8.5 日志排查问题

当线上出现问题，日志是唯一的救命稻草。不要再用System.out.println()了。

• 使用SLF4J + Logback：SpringBoot默认已集成。
• 分级打印：在application.yml中配置不同包的日志级别。

  logging: level: com.yourpackage: DEBUG # 你的业务代码打DEBUG日志 org.springframework.web: INFO org.mybatis: INFO

• 关键位置打日志：在Service层的方法入口、出口、关键分支、异常捕获处打印日志。

  @Slf4j // Lombok注解，自动提供log变量 @Service public class OrderService { public boolean createOrder(OrderDTO dto) { log.info("开始创建订单，参数: {}", dto); try { // ...业务逻辑 log.info("订单创建成功，订单号: {}", orderNo); return true; } catch (Exception e) { log.error("创建订单失败，参数: {}", dto, e); throw e; } } }

9. 从项目到论文：如何提炼你的设计文档

很多同学代码写得不错，但论文写得像流水账。论文的核心是展现你的思考过程、设计决策和系统性总结。

论文结构建议：

1. 绪论：讲清楚背景和意义（校园二手书浪费与需求矛盾）、国内外研究现状（可以简单提及其他二手平台）、本文主要工作。
2. 相关技术介绍：不要罗列SpringBoot、MyBatis是什么，要结合你的项目，讲为什么选它（如SpringBoot简化配置，快速迭代），以及它在项目中具体用在哪儿（如MyBatis-Plus简化了单表操作）。
3. 系统分析：包括可行性分析（技术、经济、操作）、需求分析（画出用例图，区分买家和卖家的功能）。
4. 系统设计：这是重中之重。
   • 架构设计：画出你的分层架构图。
   • 功能模块设计：用文字和图表（如功能结构图）详细说明用户、商品、订单、后台管理模块。
   • 数据库设计：给出核心表的E-R图，并附上关键表的字段说明（就像本文第4部分那样）。
5. 系统实现：不要贴大段代码！选择2-3个核心、有难度、能体现你技术能力的模块，用伪代码、流程图、核心代码片段+讲解的方式呈现。例如：“订单创建与事务控制”就是一个绝佳的章节。
6. 系统测试：设计测试用例（功能测试、界面测试、性能测试）。例如，测试并发下单是否会导致超卖。记录测试过程和结果。
7. 总结与展望：总结项目完成了什么，有哪些亮点（如完整的事务控制、良好的分层设计），还有哪些不足（如未实现即时通讯、推荐算法），以及未来可以如何改进。

个人心得：论文不是代码的翻译稿。老师想看到的是，你通过这个项目，掌握了如何将一个现实问题抽象成软件模型，并运用合适的工具和技术去实现它的完整能力。多画图（架构图、流程图、ER图），多讲“为什么”，你的论文分数一定不会低。

最后，这个项目做完，你收获的不仅仅是一个毕业设计的分数。你完整地走完了一个小型互联网产品的开发流程：需求分析、技术选型、数据库设计、编码实现、测试部署。这份经历和其中沉淀下来的代码，是你未来面试时最有力的谈资。当你被问到“你的项目如何保证数据一致性？”时，你可以从容地讲出订单创建时的事务控制；当被问到“如何设计一个可扩展的系统？”时，你可以从分层架构和模块化设计说起。这才是做这个项目最大的价值。

本文还有配套的精品资源，点击获取