SpringBoot3+Vue3+MySQL校园旧书交易漂流系统全栈实战

这次我们来看一个校园旧书交易与漂流场景的全栈项目。核心诉求不复杂学生手里有不再使用的教材、专业书、小说放在系统里展示其他同学可以搜索、收藏、申请交易或者发起“漂流”让书在校园内按标记的轨迹继续流动。技术栈直接写进标题JAVA SpringBoot3 Vue.js3 MySQL。如果你准备做课程设计、毕业设计或者想要一个能完整演示账号登录、权限校验、分页检索、订单状态流转、前端页面联调的 JavaWeb 项目这组选型和业务模型很适合拿来参考。这篇文章不会只贴一个架构图而是把落地的关键环节都过一遍核心能力、系统功能边界、数据库表结构、后端接口与 Token 登录链路、Vue3 前端调用方式、本地启动步骤、功能自测用例、常见报错排查以及批量造数据和后续扩展思路。全程按“能不能跑起来、怎么跑、跑通后怎么验证、踩坑后怎么查”的顺序写。整个项目都是纯 CPU 运算的普通 Web 应用不需要额外显卡资源普通开发笔记本即可开发运行。如果你关心的只是“能不能一键启动”可以直接看第 8 节如果关心“接口怎么设计、前端怎么调用”重点看第 6、7、10 节如果之前经常遇到 MySQL 连接不上、跨域报错、Vue 刷新 404 这类问题建议直接翻到第 12 节的排查表。1. 校园旧书漂流交易系统核心能力速览能力项说明项目类型前后端分离的校园二手旧书交易与漂流系统后端技术栈Java 17 及以上、SpringBoot3.x、Spring Data JPA、Validation、MySQL 驱动前端技术栈Vue.js3、Vite、Vue Router、Pinia、Axios、Element Plus数据库MySQL 8.x建议 utf8mb4 字符集用户角色普通用户学生、管理员后台管理扩展核心业务注册登录、发布旧书、图书检索、收藏、申请交易/漂流、确认交付、流转记录关键业务状态图书状态包含在架、已预约、已下架、已成交交易状态包含待确认、已确认、已完成、已取消登录态方案课程设计可用简单 Token 数据库过期时间进阶可替换为 JWT 或 Redis启动方式后端 Maven 命令启动前端 npm 命令启动也可打包后用 java -jar 部署API 能力前后端通过 RESTful 接口通信接口可用 Postman/Apifox/curl 独立测试批量任务能力基础阶段用 SQL 批量造数据进阶可扩展 Excel 导入图书硬件要求不依赖 GPU普通 Windows/Linux 开发机均可运行这套选型的好处很直接SpringBoot3 对 Java17 的生态整合很顺Spring Data JPA 可以少写大量单表 CRUDVue3 的组合式 API 配合 Element Plus列表页、表单页、弹窗交互都能快速搭出来MySQL 表结构本身也容易被面试官追问比如用户表、图书表、交易表、流转记录表之间的关联关系。2. 系统功能设计、业务场景与使用边界2.1 功能模块划分从业务上看系统至少要拆成四个模块用户模块、图书模块、交易/漂流模块、个人中心模块。用户模块负责注册、登录、密码加密、Token 生成与退出登录。密码不能明文存库建议用 BCrypt 加密登录后返回一个字符串 token前端存到 localStorage后续所有需要身份的业务接口都在 Header 里带上 token。图书模块负责旧书发布、图书上下架、条件检索、图书详情展示。发布时要填写书名、作者、出版社、ISBN、分类、书况、价格、原价/期望价格、封面图片、文字描述。价格填 0 可以表示“免费漂流”这样同一套发布能力既能支持交易也能支持赠送漂流。交易模块负责用户对在架图书发起申请图书所有者确认或拒绝。交易类型可以落地为BUY和DRIFT两种BUY是购买DRIFT是免费漂流。申请通过后图书状态从“在架”变成“已预约”最终交付完成后再变成“已成交”。每次状态变化都写入流转记录这样一本书在多个学生之间的传递路径就是一条清晰的漂流轨迹。个人中心模块用来查看“我发布的图书”“我申请的交易”“我收到的交易申请”。这个模块能直观验证多用户之间的数据隔离是否做对也是面试展示时最好用的入口。2.2 业务规则与使用边界在开发时要把下面几条规则想清楚。第一同一本书被一个用户预约后其他用户不应该再对该书发起新的交易申请。否则会出现超卖问题。实现上可以在发起申请的 Service 方法里加数据库状态校验也可以对book.status字段做乐观锁或条件更新例如UPDATE book SET status RESERVED WHERE id ? AND status ON_SHELF受影响行数为 0 时直接拒绝申请。第二“漂流”不等于无限制转送。实物书一旦离开发布者手里系统只能记录当前归属和流转轨迹无法避免线下丢失、破损、逾期不还。开发设计时要在规则说明里写清楚用户发布漂流书籍即视为同意无偿交给下一位接收者后续是否继续往下传由接收者自己决定平台只做信息撮合。第三版权和合规边界必须做好。这里说的“旧书”是正规出版物不能发布影印版、盗版教材、违法内容和侵权传播物。系统发布入口需要校验文字描述不提供任何盗版资源下载和第三方网盘链接。上线后如果允许用户上传封面图片需要增加图片格式、大小限制并在用户协议中提示不得侵犯他人肖像权与著作权。第四用户隐私问题。手机号、校内学号等隐私字段如果能不收集就不要收集或者只做可选填项。数据库密码字段存的是 BCrypt 哈希值日志中不要打印用户密码和 token。3. 技术选型与本地开发环境准备3.1 技术选型思路选择 SpringBoot3 Vue.js3 MySQL 这套技术栈并不是因为它新而是它非常适合学生从零跑通一个完整业务系统。后端使用 SpringBoot3 时JDK 版本要求最低是 Java 17。如果本机还停留在 JDK 8建议先换到 JDK 17 或 JDK 21否则直接启动会报UnsupportedClassVersionError或无法识别 SpringBoot3 相关注解。数据访问层使用 Spring Data JPA好处是实体类写完后Repository 接口通过方法名或Query就能完成大部分查询不需要单独维护 XML SQL。对于课程设计这种体量JPA 的学习成本反而比 MyBatis 更容易控制。前端使用 Vue3 的script setup语法组织页面逻辑配合 Vite 启动开发服务器。项目根目录里需要分清楚src/api、src/router、src/store、src/views、src/components等目录。Element Plus 主要负责表格、表单、弹窗、分页这些常用组件避免自己造轮子。3.2 环境准备清单检查项建议要求说明JDKJava 17 或更新版本SpringBoot3 不支持 Java 8Maven3.8后端依赖管理和打包Node.js18 或 20 LTS 版本运行 Vite 与 npm 命令MySQL8.x使用 InnoDB 引擎、utf8mb4 字符集开发工具IntelliJ IDEA / VS Code后端需要 Lombok 插件支持端口8080后端、5173前端、3306MySQL本地开发默认端口运行环境准备好之后先检查 Java 版本和 Node 版本。命令行执行下面两条命令java -version node -v如果 Java 版本低于 17需要先卸载旧 JDK 并安装 JDK 17。如果本机已经装过多个 JDK需要在环境变量里把JAVA_HOME指到 17 版本的安装目录。Node.js 建议直接下载 LTS 安装包安装完成后 npm 命令会自动加入 PATH。MySQL 客户端连接工具可以使用命令行、Navicat、DBeaver 或 IDEA 自带的 Database 面板。无论使用哪个客户端创建一个专用数据库账号都比直接使用 root 更稳妥。如果连接时报Access denied优先检查账号密码、端口、主机权限和连接 URL 中的时区参数。3.3 后端依赖与项目创建方式后端项目建议直接使用 Spring Initializr 创建。在依赖选择区勾选以下组件Spring Web提供 REST 接口能力Spring Data JPA提供实体映射与 RepositoryValidation提供参数校验MySQL Driver连接 MySQLLombok减少实体 getter/setter 代码如果完全不熟悉 Spring Initializr也可以直接使用 Maven 创建普通工程再手动加入下面的依赖片段。SpringBoot3 项目通常会有spring-boot-starter-parent管理公共版本因此这里不写具体小版本号dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency dependency groupIdorg.springframework.security/groupId artifactIdspring-security-crypto/artifactId /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency注意spring-security-crypto只用来生成和校验 BCrypt 密码哈希并不会启动整个 Spring Security 过滤器链登录鉴权逻辑仍然由我们自己的拦截器控制这样不会引入默认的登录页面和 CSRF 保护流程更透明。4. 数据库设计与建表 SQL4.1 数据表设计要点数据库名建议使用old_book_system。核心表是用户表、图书表、交易表、流转记录表。图书表里不直接把“借给别人”这种动作存成一堆字段而是用状态字段控制再用流转记录表保存历史轨迹。sys_user表用来保存登录账号、用户昵称和密码哈希。为了方便前后端分离场景下的登录态可以额外保存token和token_expire_at两个字段。这样登录时生成 token拦截器每次从请求 Header 拿 token 去数据库比对简单直观。生产环境如果要求服务端可水平扩展更推荐把 token 改造成 JWT 或者存到 Redis。book表保存图书基本信息。price字段使用DECIMAL(10,2)如果数值为 0表示这本书属于免费漂流不应该展示成“售价 0 元”而应该在前端显示“免费漂流”。book_condition保存书况常见取值可以是NEW、LIKE_NEW、USED、OLD。status保存业务状态取值ON_SHELF、RESERVED、OFF_SHELF、FINISHED。user_id表示这本书的当前发布者。book_trade表保存一次申请动作。trade_type可以是BUY或DRIFT。applicant_id表示发起申请的人owner_id表示图书当前所有者也就是收到申请的人。这样做的好处是两个人之间如果后面牵扯到线下交付确认系统可以在状态机里继续扩展。book_flow表保存一本书的流转历史。每次图书从 A 到 B都插入一条记录包含book_id、from_user_id、to_user_id、action、remark。前端个人中心展示“漂流轨迹”时直接查这张表并按时间正序展示即可。4.2 核心建表 SQLCREATE DATABASE IF NOT EXISTS old_book_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE old_book_system; CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(64) NOT NULL UNIQUE, password_hash VARCHAR(100) NOT NULL, nickname VARCHAR(64), avatar_url VARCHAR(500), phone VARCHAR(32), role VARCHAR(32) NOT NULL DEFAULT USER, status TINYINT NOT NULL DEFAULT 1, token VARCHAR(64), token_expire_at DATETIME, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, INDEX idx_username (username), INDEX idx_token (token) ) ENGINEInnoDB; CREATE TABLE book ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, title VARCHAR(255) NOT NULL, author VARCHAR(255), publisher VARCHAR(255), isbn VARCHAR(64), category VARCHAR(64), cover_url VARCHAR(500), book_condition VARCHAR(32) NOT NULL DEFAULT USED, price DECIMAL(10, 2) NOT NULL DEFAULT 0.00, original_price DECIMAL(10, 2), status VARCHAR(32) NOT NULL DEFAULT ON_SHELF, description TEXT, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, INDEX idx_user_id (user_id), INDEX idx_status (status), INDEX idx_category (category), INDEX idx_created_at (created_at) ) ENGINEInnoDB; CREATE TABLE book_trade ( id BIGINT PRIMARY KEY AUTO_INCREMENT, book_id BIGINT NOT NULL, applicant_id BIGINT NOT NULL, owner_id BIGINT NOT NULL, trade_type VARCHAR(16) NOT NULL, status VARCHAR(32) NOT NULL DEFAULT PENDING, price DECIMAL(10, 2), message VARCHAR(500), created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, INDEX idx_book_id (book_id), INDEX idx_owner_id (owner_id), INDEX idx_applicant_id (applicant_id), INDEX idx_status (status) ) ENGINEInnoDB; CREATE TABLE book_flow ( id BIGINT PRIMARY KEY AUTO_INCREMENT, book_id BIGINT NOT NULL, from_user_id BIGINT, to_user_id BIGINT, action VARCHAR(32) NOT NULL, remark VARCHAR(500), created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, INDEX idx_book_id (book_id), INDEX idx_to_user_id (