1. 项目定位与整体设计思路1.1 这个系统到底要解决什么问题先说说我为什么会对这个项目感兴趣。每年毕业季大量还能用的教材、台灯、小风扇、自行车、甚至九成新的专业课笔记都被直接扔进垃圾桶。而低年级学生正愁买新教材贵、买二手找不到靠谱渠道。这种供需错配正是校园二手物品置换系统存在的根本逻辑。说白了这个系统不是做一个简单的商品列表它要解决几个真正麻烦的问题第一学生之间的信任问题买卖双方都是校内用户需要有校园身份认证的机制第二交易撮合问题用户得能快速找到自己需要的东西所以搜索、分类、筛选这些基础能力一个不能少第三置换而非纯买卖很多场景下学生想要的不是钱而是用我的《高等数学》换你的《线性代数》这种物品互换这就比普通电商系统多了一层业务逻辑。从实际落地的角度说这类项目也特别适合拿来练手。原因很简单业务复杂度适中既有CRUD又有文件上传、权限控制、状态流转这类稍微需动点脑筋的东西还有前端联调和部署覆盖了一个完整项目的全部环节。而SpringBoot作为当前Java后端开发的事实标准正好能把从空项目到可用接口的全过程压缩到极短的时间。1.2 技术选型背后的考量很多人一上来就纠结要不要上微服务要不要用Redis要不要搞个消息队列我的建议是——不要。这不是生产环境的秒杀系统而是一个校园场景的信息撮合平台。技术选型最忌讳的就是为了用技术而用技术。我当时选型是这套组合SpringBoot做后端核心框架MyBatis做持久层MySQL存业务数据Vue 2 Element UI做管理后台和用户端页面文件上传走本地存储如果想要更规范一点也可以上MinIO后面我会细说。整个架构是前后端分离但最终打成传统WAR/JAR包部署而不是拆成独立的Nginx静态服务加后端服务。这么选有几个很实际的考量一是SpringBoot的自动装配极大减少了配置量。我不用再像以前SSM时代那样写一堆XML配置文件只需要在application.yml里声明数据源、端口、上传大小限制即可。对毕设团队或者个人开发者来说省下来的时间足够把一个功能模块打磨得更完善。二是MyBatis够灵活。虽然JPA上手更快但在处理多表联查、动态SQL这种场景时MyBatis的SQL可控性优势非常明显。特别是二手物品这种带多条件筛选分类、价格区间、成色、校区、是否可置换的场景动态SQL写起来几乎零成本。三是前后端分离但合并部署。开发阶段Vue跑在8080端口代理请求到后端8081上线时直接把dist目录拷到SpringBoot的static目录下一个JAR包搞定。对校园服务器资源紧张的情况来说这种部署方式最省事。提示如果后续想升级把存储从本地磁盘迁移到MinIO的改动很小只需要封装一层OSS接口业务代码不用动。这也是封装上传服务这个模块的意义所在。2. 环境准备与数据库设计2.1 开发环境与工具链这个项目对环境的要求其实不高我建议的版本组合如下组件版本说明JDK8 或 11JDK 8最稳JDK 11也行别一上来就上17/21Maven3.6及以上依赖管理和打包MySQL5.7或8.08.0需要注意驱动和时区配置SpringBoot2.7.x别选3.x原因后面讲MyBatismybatis-spring-boot-starter 2.x配合SpringBoot 2.xVue2.x生态成熟坑少Node14/16打包Vue项目用我踩过最大的坑就是SpringBoot版本。标题里很多人写的是springboot版本太高这类热搜词确实是个高频问题。SpringBoot 3.x基于Jakarta EE把javax.*全部换成了jakarta.*很多老教程直接失效一些中间件驱动还没跟上。如果你照着网上教程写import javax.servlet.http.HttpServletRequest在3.x里直接编译不过。所以做这类毕设项目老老实实用2.7.x。2.2 数据库表结构设计思路数据库设计是这个项目真正的核心建议动手写代码前先花一晚上把表设计理清。我最终设计出的核心表包括这些user表用户信息。字段包括id、student_no学号、password、nickname、phone、avatar、role用户/管理员、status、create_time。学号要做唯一索引因为这是校园场景下身份识别的关键。category表物品分类。两级结构parent_id指向父分类比如学习用品下挂教材文具电子产品下挂手机电脑。item表物品信息。这是最核心的表字段包括id、user_id发布者、category_id、title、description、price、original_price、condition_level成色用1-5表示、trade_type1表示出售2表示置换3表示置换补差价、wanted_item想置换什么文本描述、campus校区、status0在售、1已下单、2已完成、3下架、view_count、create_time。item_image表物品图片。为什么单独建表而不是直接放个images字段用逗号拼接因为后续要做主图覆盖、多图标展示单独建表在SQL查询时更清晰也方便后续做图片懒加载。trade_order表订单表。字段包括id、item_id、buyer_id、seller_id、order_type购买/置换、amount、status0待确认、1已完成、2已取消、create_time。favorite表收藏表。user_iditem_id唯一索引避免重复收藏。message表站内私信。这个功能很多人会忽略但实际上是二手交易里用户沟通频率最高的场景。设计时特别注意一点不要把业务状态和流程状态混在一个字段里。比如物品状态status已经包含0-3四种状态了有些同学还会加一个is_deleted来标识删除这两个字段很容易互相干扰。我的做法是下架和删除都通过status表达下架即从列表消失物理删除只用于管理员处理违规物品。3. 核心功能实现拆解3.1 用户注册登录与JWT鉴权用户模块是第一个要实现的它撑起了整个系统的访问控制。我用的是JWT方案流程是登录成功后后端生成一个token返回给前端前端存在localStorage里每次请求在Header里带上Authorization: Bearer token后端通过拦截器校验。核心实现思路是这样的密码不能明文存用BCrypt加密。SpringSecurity自带的BCryptPasswordEncoder可以直接用不要自己写MD5加盐安全性差。注册校验学号唯一、密码强度、手机号格式。这里有个业务细节校园场景建议增加学号姓名匹配校验但考虑到毕设的演示属性可以通过一个管理端的审核机制来代替。JWT的过期时间设计我设了24小时移动端请求频繁过期太短会导致体验差。配合拦截器在token过期时返回401前端再引导用户重新登录。JWT那块最简单的方式是用jjwt库。网上很多教程让你写一大串工具类其实核心逻辑就三点生成token、解析token、判断过期。需要注意的是签名密钥不要太简单我习惯放在配置文件中用Value注入。3.2 商品发布与图片上传商品发布是用户最常用的功能也是后端代码最容易出问题的地方。前端表单字段很多标题、描述、分类、价格、成色、交易方式、期望置换物品、校区、图片九宫格。提交时用FormData提交兼容性最好。后端接收时注意字段用RequestParam逐个接收或者定义一个DTO对象用ModelAttribute接收不要用RequestBody— 因为RequestBody只能接收JSON收不了文件。图片上传这块有个经典问题本地磁盘存储的路径和访问映射。我的做法是upload: dir: /data/upload url: /api/file/**代码里实现一个WebMvcConfigurer把本地目录映射成URL访问路径Override public void addResourceHandlers(ResourceHandlerRegistry registry) { String dir uploadDir.endsWith(/) ? uploadDir : uploadDir /; registry.addResourceHandler(/api/file/**) .addResourceResolver(new FileSystemResourceResolver(dir)); }这样用户上传的图片访问地址就是/api/file/20240101/uuid.jpg前端直接拼这个URL就能展示。文件命名一定要用UUID重命名避免中文名和重名问题。注意如果上传的图片无法预览99%是资源映射路径写错了排查时先看浏览器Network里图片请求返回的是200还是404。3.3 商品搜索与分类筛选商品列表页是整个系统的门面。你写的是校园二手物品置换系统用户进来第一眼看到的就是商品流所以列表接口必须好使。我的设计是统一走一个/api/item/list接口接受这些参数keyword、categoryId、campus、tradeType、minPrice、maxPrice、sort、page、pageSize。放在MyBatis里用动态SQL拼条件select idselectItemList resultTypecom.example.vo.ItemVO SELECT i.*, c.category_name, u.nickname, u.avatar FROM item i LEFT JOIN category c ON i.category_id c.id LEFT JOIN user u ON i.user_id u.id where i.status ! 3 if testkeyword ! null and keyword ! AND (i.title LIKE CONCAT(%, #{keyword}, %) OR i.description LIKE CONCAT(%, #{keyword}, %)) /if if testcategoryId ! null AND (i.category_id #{categoryId} OR i.category_id IN (SELECT id FROM category WHERE parent_id #{categoryId})) /if if testcampus ! null and campus ! AND i.campus #{campus} /if if testtradeType ! null AND i.trade_type #{tradeType} /if if testminPrice ! null AND i.price gt; #{minPrice} /if if testmaxPrice ! null AND i.price lt; #{maxPrice} /if /where ORDER BY choose when testsort price_asci.price ASC/when when testsort price_desci.price DESC/when when testsort newesti.create_time DESC/when otherwisei.create_time DESC/otherwise /choose /select关键词搜索用LIKE %关键词%对毕设来说完全够用。如果你图省事想上Elasticsearch或者HanLP分词纯属过度设计。数据量就几万条MySQL全表扫描带索引也毫秒级返回。3.4 置换/交易流程设计二手置换和普通电商最大的区别在于它的订单状态流转不是付款-发货-收货这么简单而是两者互换。我的做法是在trade_order表里加一个related_order_id字段用于关联换入物和换出物两个订单。流程设计如下A用户对B用户的物品发起置换申请B用户收到一条站内消息。B用户同意后系统自动生成两条订单一条是B物品给A记录卖/换出方向一条是A的置换物品给B记录换入方向。双方在线下约好见面交易后在线点击确认完成两条订单同时状态改为已完成。这个流程看似简单实际写代码时需要注意一个并发问题同一件物品可能同时被好几个人申请置换。我用的方案是给item表加一列transaction_lock发起置换申请时用UPDATE item SET transaction_lock 1 WHERE id ? AND transaction_lock 0这种原子操作抢占影响行数为1才说明抢到了否则提示该物品正在处理中。这个乐观锁思路是面试时最爱问的一个点也是实打实能跑通业务的方案。4. 前后端对接与项目部署4.1 接口设计与统一响应结构前后端分离的项目最怕的就是接口约定不一致。我强烈建议从第一个接口开始就统一返回值结构不要这里返回JSON、那里返回字符串。我封装了一个ApiResultTpublic class ApiResultT { private Integer code; // 200成功401未登录500异常 private String message; private T data; public static T ApiResultT success(T data) { ... } public static T ApiResultT error(Integer code, String message) { ... } }前端拿到响应先判断code再取data。这大大减少了联调时这个接口怎么返回格式不一样的痛苦。另外全局异常处理一定要做。用RestControllerAdvice捕获业务异常和系统异常返回统一格式。否则MyBatis一抛SQL异常用户看到一堆堆栈信息既不安全也不好看。4.2 Vue打包与SpringBoot集成前端开发完以后执行npm run build会生成dist目录里面是index.html和一堆带hash的静态资源。把dist目录里的内容复制到SpringBoot项目的src/main/resources/static下重新打包一个JAR就包含全部前端页面。如果暂时不想复制也可以直接在application.yml里配置spring: web: resources: static-locations: file:D:/workspace/dist/,classpath:/static/开发阶段改前端代码直接刷新就能看到效果上线时再复制进static目录。这个小技巧能让开发和部署的切换效率提高不少。还有一个细节容易被忽略打包进JAR的静态资源跟后端接口用的是同一端口。如果Vue路由用的是history模式直接刷新前端页面会导致404。解决办法是后端加一个转发规则把非/api/开头的路径都转发到index.htmlController public class ForwardController { RequestMapping(value {/, /index.html, /item/**, /profile/**, /admin/**}) public String forward() { return forward:/index.html; } }4.3 项目打包部署要点打包部署我用的是Maven命令很简单mvn clean package -DskipTests打包后JAR在target目录下直接java -jar就能跑。但有几个细节值得说上传文件目录必须放在JAR包外。我放在/data/upload下这个目录不属于classpath打包进去重打也没了。生产环境数据库连接、上传目录等配置要用外部配置文件覆盖启动时指定--spring.config.location/data/conf/application-prod.yml。如果部署在校园内网的Windows服务器上记得关掉机器防火墙的相应端口或者直接在局域网测试环境改端口。这里说一句肺腑之言别在自己电脑上觉得能跑就万事大吉。把项目拿到一台干净的服务器上重新配置、重新打包、重新运行这一整个过程走一遍你才会真正理解什么叫环境不一致。5. 常见问题与排查经验5.1 SpringBoot版本引发的连锁问题这个锅基本上每个写SpringBoot的人都背过。版本太高最直接的后果就是网上教程全是2.x的写法你的3.x项目里javax变jakarta一堆第三方配置类失效然后你开始怀疑人生。如果你确实手滑新建了3.x项目解决办法是调回2.7.x。直接在pom.xml里改parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent如果改了以后Maven下载依赖报错记得在IDEA的Maven设置里把Always update snapshots勾上或者清一遍本地仓库里的lastUpdated文件。这也算是Maven项目构建方法里最常遇到的一个坑。5.2 上传文件大小限制这个几乎是必踩的坑。SpringBoot默认单文件上传上限是1MB一旦前端传多张图片总会莫名其妙地报FileSizeLimitExceededException。在application.yml里配置spring: servlet: multipart: max-file-size: 10MB max-request-size: 50MB建议把单文件上限设成5MB或10MB一次请求最多10张图总量控制在50MB内。另外在Controller方法上最好也做一层业务限制前端也要压缩图片不然手机拍的照片轻松就是5MB以上服务端存储压力也大。5.3 时间字段的时区问题MySQL 8.0的默认时区是UTC如果你连接的字符串没带serverTimezone参数查出来的时候所有时间会比中国时间少8小时。连接串里明确加上url: jdbc:mysql://localhost:3306/campus_market?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4同时MySQL启动时也可以加--default-time-zone08:00。这个问题很隐蔽前端展示刚刚、后端返回昨天用户一脸懵排查了半天才发现是时区问题。5.4 静态资源404和拦截器放行如果登录拦截器写得太粗暴把所有请求都拦了那登录页面自己的CSS、JS、图片也全挂了。我的放行规则是/api/user/login和/api/user/register放行/api/item/list、/api/item/detail放行/api/file/**放行/error放行其余全部走JWT校验。经验之谈开发阶段可以用HandlerInterceptor加一个开关配置里写auth.enabledfalse能快速关闭校验方便前端单独联调接口。上线再打开。6. 一些项目落地的小建议如果这个项目是你用来做毕设的有个建议给到把功能分层做先把核心链路注册、登录、发布、列表、详情、下单、确认完成跑通再补辅助功能收藏、评论、私信、管理后台。我见过太多同学卡在图片上传上搞了两三天结果课设答辩时连商品列表都没做出来。管理后台这个模块也别真做摆设。最简单的后台只需要三个页面用户管理禁用/解禁、物品管理下架违规物品、分类管理后端对应三个Controller就够。这样做完以后整个系统管理员、卖家、买家三种角色都有功能完整度和答辩说服力会提高一个档次。另外别忘了项目里的README和数据库初始化脚本。我每次拿到一个项目第一件事就是看数据库脚本能不能一步导入。用PRIMARY KEY AUTO_INCREMENT、统一的utf8mb4字符集外键约束合理设置这些看起来不起眼的小事恰恰是评审老师最关注的基本功。按我这个路线把一个校园二手物品置换系统做完你对SpringBoot的理解绝对不止于会用而是真正建立起了从需求到上线的完整链路需求分析、数据库设计、接口设计、权限控制、文件处理、打包部署、问题排查。这些能力比任何一个单独的技术点都要值钱。