尧图网站建设 
简介基于SpringBoot的二手物品交易系统毕业设计项目面向计算机相关专业毕设学生及Java实战学习者提供完整可运行的项目源码与配套数据库可直接用于课程设计、期末大作业或毕业设计参考。包内共633个文件压缩包约18.27MB涵盖Java源文件、MyBatis映射、FreeMarker模板、SpringBoot配置等后端内容前端资源以JavaScript、CSS和图片为主并包含bootstrap等UI组件便于理解前后端交互。已有293人学习下载。项目包含数据库脚本、软件工具、项目说明等经严格调试保证可运行整体结构清晰从用户登录、商品发布到交易流程均有完整实现适合快速掌握SpringBootMySQL开发模式也可作为二次开发与毕设答辩的有力支撑。1. Spring Boot二手物品交易系统先看这份毕业设计能落地成什么做Java毕业设计十个人里三四个会选二手物品交易系统模板多、逻辑清晰、答辩时也好讲。这份Spring Boot二手物品交易系统项目源码数据库就是把这类项目做成了一套可以直接复现的完整工程包压缩包里含着后端工程结构和SQL脚本解压配置后就能启动。它适合两类人一是正在为毕设发愁、想拿现成Spring Boot项目做二次开发的学生二是想快速搭一个校园内部闲置交易Demo、用来练手或做课程设计的开发者。我第一次拆这类源码时最大的感受是结构常规、没有乱堆代码但配置细节里藏着不少坑比如数据库编码、JDK版本、Mapper扫描路径。下面我按实际拆包和跑通项目的顺序把每一步讲清楚。2. 源码包解剖目录结构、表设计与技术栈选型2.1 先别急着双击运行看清包结构再动手拿到压缩包后第一步不是解压乱点而是先建一个干净的目录把zip放进去再解压。解压后我习惯先扫三个东西有没有README、SQL文件的扩展名与编码、pom.xml里的依赖版本。这三个决定了后面能不能顺利跑起来。这类Spring Boot毕设项目的典型结构基本是统一的核心工程目录如下目录/文件职责src/main/java后端Java源码src/main/resources/application.yml数据源、端口、上传配置src/main/resources/mapperMyBatis的XML文件src/main/resources/templatesThymeleaf页面模板src/main/resources/staticJS、CSS、图片等静态资源sql/ 或 db/建库建表脚本Java包名一般是com.xxx具体以你解压出的为准包下按controller、service、mapper、entity、config、common分层。controller层负责接收页面请求service层写业务逻辑mapper层对接数据库entity是数据实体。config里通常是拦截器、静态资源映射、跨域配置。从pom.xml能看出项目的依赖底子常见的关键依赖包裹着spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-java、thymeleaf。如果看到版本号没锁死建议锁成与Spring Boot父依赖一致的版本避免启动时依赖冲突。我拆包时习惯先把pom过一遍确认有没有引入多余依赖比如同时引入两个JSON解析库这种操作很容易在接口返回时翻车。2.2 数据库设计五张核心表就能撑起一个交易闭环解压后看一眼SQL脚本二手交易系统的基础表设计基本围绕用户、商品、订单三条主线展开。典型的设计是五张核心表具体表名以你解压出的SQL为准但规律是通用的表名核心字段作用userid, username, password, nickname, phone, avatar, create_time买卖双方共用一张用户表categoryid, name, parent_id商品分类goodsid, title, description, price, original_price, images, status, seller_id, category_id, create_time闲置商品主表favoritesid, user_id, goods_id, create_time收藏/关注ordersid, order_no, buyer_id, seller_id, goods_id, price, status, create_time交易订单goods表里的status字段很关键一般用0表示在售、1表示已售、2表示下架用整数存而不是字符串方便排序和后期扩展。orders表里的status用另一套状态值这个我在第四章具体展开。user表同时承担买家卖家两种角色因为二手交易场景里一个用户既能发布商品也能下单购买拆成两张表反而增加复杂度。看SQL脚本的重点是字符集和排序规则。如果建表语句里写的是utf8而不是utf8mb4后面存表情符号或者部分生僻字就会报错。导入后我用一条SQL验证编码SELECT table_name, table_collation FROM information_schema.tables WHERE table_schema second_hand;结果里如果出现utf8mb4_general_ci或utf8mb4_unicode_ci说明表结构没问题。这里没写在信息里也没关系表多表少不影响整体逻辑核心交易闭环就是这五张表。2.3 技术栈选型为什么是Spring Boot MyBatis Thymeleaf这套组合是Java毕设里最保守也最稳的方案。Spring Boot负责自动装配和快速启动MyBatis让SQL手写可控Thymeleaf在后端直接渲染页面不引入前后端分离的复杂度。MySQL做存储配合Bootstrap或原生CSS把页面撑起来。为什么不是MyBatis-Plus不是说Plus不好而是毕业设计答辩时老师大概率会问你SQL细节手写Mapper能让你把“分页怎么写、多表联查怎么优化”讲清楚。如果你拿到手的项目里已经用了MyBatis-Plus也别慌核心业务逻辑不变只是BaseMapper替你把单表CURD封装好了反而更快。一个常见的想法是“我能不能改成前后端分离Vue打包后放进Spring Boot里跑”。这个思路完全可行其实就是在resources/static下放Vue的dist包再把Controller层改成返回JSON数据。路径上注意后端接口不要放在受拦截器保护的目录里不然打包上线后接口全被拦截页面能打开但数据全是空的。这一块后面第六章我专门说。3. 从压缩包到运行页面环境准备、数据库导入与启动配置3.1 环境对齐JDK 8和Maven镜像优先搞定跑Spring Boot 2.x项目最稳的JDK是1.8不要一上来就用JDK 17甚至21。Spring Boot 2.x在JDK 8下编译运行几乎零兼容问题换到JDK 17经常出现IllegalAccessError或者Lombok失效查起来很头疼。我一般先确认三件事java -version mvn -v mysql --versionjava -version出现1.8字样说明JDK没问题mvn -v能看到Maven版本和Java运行时mysql --version确认数据库装的是5.7还是8.0。你本地MySQL如果是8.0驱动和连接URL都要按8.0的写法这个后面配置章节会说到。Maven如果没有配置过国内镜像首次拉依赖的过程会极其痛苦。mvn执行时长时间卡在下载进度条最后大概率是超时失败。打开Maven安装目录下conf/settings.xml把镜像换成阿里云仓库mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror替换后重新执行mvn -v再随便拉一个依赖测试网络。这一步做扎实后面启动项目能省掉半小时的等待。3.2 导库指定utf8mb4避开乱码坑SQL脚本常见的位置是项目根目录下的sql文件夹文件名类似second_hand.sql或db.sql。导入前先建好数据库再按指定字符集导入mysql -uroot -p -e CREATE DATABASE second_hand DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p --default-character-setutf8mb4 second_hand sql/second_hand.sql第一条命令创建数据库并指定字符集为utf8mb4第二条命令导入SQL。注意--default-character-setutf8mb4这个参数很关键少了它部分SQL工具或Windows终端下导入中文数据会出现乱码导入后页面显示全是问号。导入完成后验证一下关键表mysql -uroot -p -e USE second_hand; SHOW TABLES;能看到user、goods、orders等表说明导入成功。如果某个表没建出来多半是SQL脚本里语法与MySQL 8.0不兼容最常见的是老脚本里用了ENGINEMyISAM或者过时的默认值写法单独执行那个表的建表语句就能定位。3.3 改配置application.yml里需要动的地方其实就三处项目能不能启动最终都落在配置文件上。打开src/main/resources/application.yml重点看数据源部分。绝大多数项目的初始配置都长这样server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/second_hand?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.entity需要改的就是password、username、url里的数据库名。如果你的MySQL是8.0以上驱动类名是com.mysql.cj.jdbc.Driver如果是5.7要改成com.mysql.jdbc.Driver。URL里的serverTimezoneAsia/Shanghai必须保留去掉以后连接MySQL 8.0会报时区错误。还有一处容易被忽略spring.datasource.url里的characterEncodingutf8建议直接改成characterEncodingutf8mb4保持和数据库一致。改完保存没有任何一个地方需要改业务代码。3.4 启动mvn spring-boot:run还是java -jar跑Spring Boot项目有两种常见方式。本地调试阶段我用Maven直接启动mvn spring-boot:run首次执行会下载大量依赖日志会停在三五分钟不动这时候别急着按CtrlC。看到Started Application in x.xxx seconds后说明启动成功。浏览器访问http://localhost:8080能跳转到登录页或首页就算过第一关。第二种方式是打包后运行适合确认交付可用mvn clean package -DskipTests java -jar target/*.jar-DskipTests跳过单元测试避免测试类里连不上数据库导致打包失败。target目录下的jar包可以拷到别的机器上运行前提是那台机器能访问到同一个MySQL。如果启动时提示端口被占修改server.port为8081再启动这是最省事的处理方式。4. 核心业务实现拆解登录鉴权、商品发布与订单状态流转4.1 登录鉴权Session加拦截器别引入没必要的复杂度二手交易系统的登录设计绝大多数同类项目走的是Session加拦截器方案不需要引入JWT和Spring Security。登录成功后把用户对象放进Session后续请求通过拦截器统一校验没有登录就去不了发布、订单、个人中心等受保护页面。登录逻辑上Service层按用户名查询用户再用MD5或BCrypt比对密码比对成功就写Session。关键代码是拦截器里的校验逻辑public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 从Session里取登录时存入的用户对象 Object user request.getSession().getAttribute(loginUser); if (user null) { // 没登录就踢回登录页带上当前地址方便登录后回跳 response.sendRedirect(/login?redirect request.getRequestURI()); return false; } return true; } }这段代码逻辑很简单Session里没有用户就重定向到登录页有就放行。redirect参数是很多同学会漏掉的小细节带上它登录成功后再跳回原来想访问的页面演示时不至于被人说“体验差”。注册拦截器时注意放行范围不然静态资源全被拦住Configuration public class WebConfig implements WebMvcConfigurer { Autowired private LoginInterceptor loginInterceptor; Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(loginInterceptor) .addPathPatterns(/**) .excludePathPatterns(/login, /register, /logout, /static/**, /css/**, /js/**, /images/**, /goods/list, /goods/detail/**); } }.excludePathPatterns里放行登录、注册、静态资源和商品浏览接口。这里有个常见失误有些同学把/goods/list也拦截了结果未登录用户看不到商品列表首页一片空白。4.2 商品发布MultipartFile接收图片数据库只存相对路径商品发布是二手交易系统的核心功能。页面表单提交商品信息和图片后端用MultipartFile接收上传文件保存到磁盘再把图片URL写进数据库。注意一个工程习惯图片不要存到IDEA工作目录下的webapp里重启或重打包容易丢要存到独立的磁盘目录。PostMapping(/goods/add) public String addGoods(Goods goods, RequestParam(imageFile) MultipartFile imageFile, HttpSession session) throws IOException { // 图片为空直接打回避免后续保存出空路径 if (imageFile.isEmpty()) { return redirect:/goods/publish?errorempty_image; } // 保存到本地磁盘固定目录目录不存在就自动创建 String dir D:/upload/goods/; File dirFile new File(dir); if (!dirFile.exists()) { dirFile.mkdirs(); } // 用时间戳做文件名避免不同用户上传同名文件互相覆盖 String originalFilename imageFile.getOriginalFilename(); String suffix originalFilename.substring(originalFilename.lastIndexOf(.)); String fileName System.currentTimeMillis() suffix; imageFile.transferTo(new File(dir fileName)); // 数据库里只存相对URL页面展示时再拼映射 goods.setImageUrl(/upload/goods/ fileName); // 从Session取当前登录用户作为卖家 User user (User) session.getAttribute(loginUser); goods.setSellerId(user.getId()); goods.setStatus(0); // 0在售 goodsService.addGoods(goods); return redirect:/goods/my; }参数说明imageFile对应前端表单里的nameimageFile的file输入框System.currentTimeMillis()生成文件名防止重名transferTo把临时上传文件移动目标位置。数据库只存/upload/goods/xxx.jpg展示页拼上域名端口就能访问。但这样存了还不够Spring Boot默认访问不到磁盘上的/upload路径需要加静态资源映射Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 把 /upload/** 映射到磁盘目录重启服务不丢图片 registry.addResourceHandler(/upload/**) .addResourceLocations(file:D:/upload/); }file:D:/upload/末尾的斜杠不能丢。丢了以后路径拼接会错图片全部404这个问题排查起来不动脑筋很难发现。4.3 订单状态整数状态值比字符串好维护得多订单状态是交易系统的核心设计得好不好直接影响代码可维护性。常见做法是用整数存状态把常量集中到一个状态类里public class OrderStatus { // 待付款 public static final Integer WAIT_PAY 0; // 已付款 public static final Integer PAID 1; // 已完成 public static final Integer DONE 2; // 已取消 public static final Integer CANCELED -1; }为什么不用字符串“待付款”“已付款”第一是排序和比较不方便第二是万一状态文案要改数据库里的字符串也得跟着改。用整数存页面展示时再映射成中文职责清晰。状态流转要控制好边界不能任何状态都能跳转到任何状态。比如已付款订单不能直接取消只能走完成或售后流程public boolean cancelOrder(Integer orderId, Integer buyerId) { Order order orderMapper.selectById(orderId); // 只有待付款状态允许买家取消且必须是本人订单 if (order ! null order.getStatus() OrderStatus.WAIT_PAY order.getBuyerId().equals(buyerId)) { Order update new Order(); update.setId(orderId); update.setStatus(OrderStatus.CANCELED); orderMapper.updateById(update); return true; } return false; }这段代码把校验和更新放在一起先查订单、比对状态位和买家ID、再做更新三个条件缺一不可。如果状态校验不严会出现买家取消别人订单、已付款订单被撤销的问题答辩演示时翻车概率极高。5. 避坑指南跑通Spring Boot毕设最容易翻车的五个坑5.1 启动报错Failed to configure a DataSource八成是配置没对上现象mvn spring-boot:run执行到一半控制台直接抛Failed to configure a DataSource。原因Spring Boot在启动时自动装配了数据源但application.yml里的数据库连接信息配不上。最常见的是密码错误、数据库名不存在、MySQL服务没启动。解决按顺序检查三步。第一步确认MySQL进程在运行mysql -uroot -p能登进去第二步核对username和password第三步确认数据库名与URL里的库名一致。改完配置重新启动不要只改一个字段就重启浪费时间。5.2 页面中文全是问号导库时没管字符集现象登录后首页商品标题显示???但英文和数字正常。原因SQL脚本导入时使用了系统默认字符集latin1中文被转成了问号数据已经损坏。解决把表删掉重新按utf8mb4导入mysql -uroot -p --default-character-setutf8mb4 second_hand sql/second_hand.sql如果不想删表可以用ALTER TABLE goods CONVERT TO CHARACTER SET utf8mb4;修正存量表但已经变成问号的数据恢复不回来只能重新导。所以导库这一关务必一次做对。5.3 登录成功又跳回登录页拦截器放行范围设窄了现象用户名密码正确登录接口也返回了成功但页面立刻跳回登录页像没登录一样。原因登录请求本身被拦截器拦住了Session还没来得及写入用户对象就被重定向或者写Session的时机在重定向之后登录信息根本没存进去。解决确认拦截器的excludePathPatterns放行了/login和/register这两个路径。再看登录Controller里写Session的代码是否在sendRedirect之前先request.getSession().setAttribute(loginUser, user)再重定向。5.4 Mapper接口找不到Invalid bound statement (not found)现象启动不报错但一调用某个查询接口就抛Invalid bound statement (not found)。原因MyBatis的Mapper接口和XML文件没绑定上。要么是MapperScan没加要么是application.yml里的mapper-locations路径不对。解决启动类上加MapperScan(com.xxx.mapper)同时检查yml配置mybatis: mapper-locations: classpath:mapper/*.xmlclasspath:mapper/*.xml要求XML文件必须放在src/main/resources/mapper/下。如果XML放在其他目录把路径改成对应的位置。5.5 端口被占用Port 8080 was already in use现象启动日志显示Port 8080 was already in use项目起不来。原因本机其他进程占用了8080端口比如之前跑过一次项目没关干净、Tomcat或别的开发工具占着端口。解决两种方式任选。第一种改端口application.yml里server.port: 8081第二种杀掉占用进程Windows下用命令查PID再结束进程netstat -ano | findstr 8080 taskkill /PID 1234 /Ffindstr后面返回值第二列就是进程PID/F强制结束。注意如果项目里有前端页面写死了8080的接口地址改端口后要同步改前端不然页面能开但数据请求全失败。6. 进阶玩法用启动日志给项目做体检验收前过一遍Checklist6.1 用启动日志倒推模块加载情况跑通不算完还要学会用日志验证项目的健康状态。每次mvn spring-boot:run启动时控制台输出的日志是有规律的。看到Tomcat started on port(s): 8080 (http)说明Web容器起来了看到Started Application in x.xxx seconds说明Spring容器装配完成启动过程中如果出现BeanCreationException或UnsatisfiedDependencyException说明某个Bean没装配成功按异常信息里的类名往下查。接口层面可以用curl快速验证不用打开浏览器curl http://localhost:8080/goods/list返回HTML或JSON都正常如果返回404或500再看Spring Boot日志里对应请求的异常堆栈。推荐把spring.main.banner-mode改成off日志干净一点像这种spring: main: banner-mode: off logging: level: com.example.mapper: debuglogging.level配成debug后MyBatis会把执行的SQL打印到控制台验证订单状态更新时直接能看到SQL语句和参数排查比对着数据库猜快得多。6.2 验收演示前把这三件小事做掉答辩或给别人演示前我习惯强制过一遍流程准备好一个演示用的买家账号和一个卖家账号密码别搞太复杂准备一张小于1MB的JPG图片用于发布因为部分项目把上传大小限制在1MB或2MB超出直接报错把所有测试产生的垃圾数据和脏订单清掉演示时从头走一遍“登录→发布→下单→确认收货”确保流程完整走通。以前帮一个朋友排查询他的毕设问题他跟我说数据库密码是对的但项目一直报Access denied。我从配置文件查到密码再到命令行里试登录发现他密码里有个符号被IDEA自动转义了yml里写成纯文本后被解析成了乱码。从那以后我每次拿到新的Spring Boot项目都强制自己先看一遍application.yml和启动日志再谈改代码的事。这套流程看着琐碎却能省下后面一晚上的排查时间希望帮到你。本文还有配套的精品资源点击获取 Spring Boot二手物品交易系统毕业设计源码解析与部署指南
简介基于SpringBoot的二手物品交易系统毕业设计项目面向计算机相关专业毕设学生及Java实战学习者提供完整可运行的项目源码与配套数据库可直接用于课程设计、期末大作业或毕业设计参考。包内共633个文件压缩包约18.27MB涵盖Java源文件、MyBatis映射、FreeMarker模板、SpringBoot配置等后端内容前端资源以JavaScript、CSS和图片为主并包含bootstrap等UI组件便于理解前后端交互。已有293人学习下载。项目包含数据库脚本、软件工具、项目说明等经严格调试保证可运行整体结构清晰从用户登录、商品发布到交易流程均有完整实现适合快速掌握SpringBootMySQL开发模式也可作为二次开发与毕设答辩的有力支撑。1. Spring Boot二手物品交易系统先看这份毕业设计能落地成什么做Java毕业设计十个人里三四个会选二手物品交易系统模板多、逻辑清晰、答辩时也好讲。这份Spring Boot二手物品交易系统项目源码数据库就是把这类项目做成了一套可以直接复现的完整工程包压缩包里含着后端工程结构和SQL脚本解压配置后就能启动。它适合两类人一是正在为毕设发愁、想拿现成Spring Boot项目做二次开发的学生二是想快速搭一个校园内部闲置交易Demo、用来练手或做课程设计的开发者。我第一次拆这类源码时最大的感受是结构常规、没有乱堆代码但配置细节里藏着不少坑比如数据库编码、JDK版本、Mapper扫描路径。下面我按实际拆包和跑通项目的顺序把每一步讲清楚。2. 源码包解剖目录结构、表设计与技术栈选型2.1 先别急着双击运行看清包结构再动手拿到压缩包后第一步不是解压乱点而是先建一个干净的目录把zip放进去再解压。解压后我习惯先扫三个东西有没有README、SQL文件的扩展名与编码、pom.xml里的依赖版本。这三个决定了后面能不能顺利跑起来。这类Spring Boot毕设项目的典型结构基本是统一的核心工程目录如下目录/文件职责src/main/java后端Java源码src/main/resources/application.yml数据源、端口、上传配置src/main/resources/mapperMyBatis的XML文件src/main/resources/templatesThymeleaf页面模板src/main/resources/staticJS、CSS、图片等静态资源sql/ 或 db/建库建表脚本Java包名一般是com.xxx具体以你解压出的为准包下按controller、service、mapper、entity、config、common分层。controller层负责接收页面请求service层写业务逻辑mapper层对接数据库entity是数据实体。config里通常是拦截器、静态资源映射、跨域配置。从pom.xml能看出项目的依赖底子常见的关键依赖包裹着spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-java、thymeleaf。如果看到版本号没锁死建议锁成与Spring Boot父依赖一致的版本避免启动时依赖冲突。我拆包时习惯先把pom过一遍确认有没有引入多余依赖比如同时引入两个JSON解析库这种操作很容易在接口返回时翻车。2.2 数据库设计五张核心表就能撑起一个交易闭环解压后看一眼SQL脚本二手交易系统的基础表设计基本围绕用户、商品、订单三条主线展开。典型的设计是五张核心表具体表名以你解压出的SQL为准但规律是通用的表名核心字段作用userid, username, password, nickname, phone, avatar, create_time买卖双方共用一张用户表categoryid, name, parent_id商品分类goodsid, title, description, price, original_price, images, status, seller_id, category_id, create_time闲置商品主表favoritesid, user_id, goods_id, create_time收藏/关注ordersid, order_no, buyer_id, seller_id, goods_id, price, status, create_time交易订单goods表里的status字段很关键一般用0表示在售、1表示已售、2表示下架用整数存而不是字符串方便排序和后期扩展。orders表里的status用另一套状态值这个我在第四章具体展开。user表同时承担买家卖家两种角色因为二手交易场景里一个用户既能发布商品也能下单购买拆成两张表反而增加复杂度。看SQL脚本的重点是字符集和排序规则。如果建表语句里写的是utf8而不是utf8mb4后面存表情符号或者部分生僻字就会报错。导入后我用一条SQL验证编码SELECT table_name, table_collation FROM information_schema.tables WHERE table_schema second_hand;结果里如果出现utf8mb4_general_ci或utf8mb4_unicode_ci说明表结构没问题。这里没写在信息里也没关系表多表少不影响整体逻辑核心交易闭环就是这五张表。2.3 技术栈选型为什么是Spring Boot MyBatis Thymeleaf这套组合是Java毕设里最保守也最稳的方案。Spring Boot负责自动装配和快速启动MyBatis让SQL手写可控Thymeleaf在后端直接渲染页面不引入前后端分离的复杂度。MySQL做存储配合Bootstrap或原生CSS把页面撑起来。为什么不是MyBatis-Plus不是说Plus不好而是毕业设计答辩时老师大概率会问你SQL细节手写Mapper能让你把“分页怎么写、多表联查怎么优化”讲清楚。如果你拿到手的项目里已经用了MyBatis-Plus也别慌核心业务逻辑不变只是BaseMapper替你把单表CURD封装好了反而更快。一个常见的想法是“我能不能改成前后端分离Vue打包后放进Spring Boot里跑”。这个思路完全可行其实就是在resources/static下放Vue的dist包再把Controller层改成返回JSON数据。路径上注意后端接口不要放在受拦截器保护的目录里不然打包上线后接口全被拦截页面能打开但数据全是空的。这一块后面第六章我专门说。3. 从压缩包到运行页面环境准备、数据库导入与启动配置3.1 环境对齐JDK 8和Maven镜像优先搞定跑Spring Boot 2.x项目最稳的JDK是1.8不要一上来就用JDK 17甚至21。Spring Boot 2.x在JDK 8下编译运行几乎零兼容问题换到JDK 17经常出现IllegalAccessError或者Lombok失效查起来很头疼。我一般先确认三件事java -version mvn -v mysql --versionjava -version出现1.8字样说明JDK没问题mvn -v能看到Maven版本和Java运行时mysql --version确认数据库装的是5.7还是8.0。你本地MySQL如果是8.0驱动和连接URL都要按8.0的写法这个后面配置章节会说到。Maven如果没有配置过国内镜像首次拉依赖的过程会极其痛苦。mvn执行时长时间卡在下载进度条最后大概率是超时失败。打开Maven安装目录下conf/settings.xml把镜像换成阿里云仓库mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror替换后重新执行mvn -v再随便拉一个依赖测试网络。这一步做扎实后面启动项目能省掉半小时的等待。3.2 导库指定utf8mb4避开乱码坑SQL脚本常见的位置是项目根目录下的sql文件夹文件名类似second_hand.sql或db.sql。导入前先建好数据库再按指定字符集导入mysql -uroot -p -e CREATE DATABASE second_hand DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p --default-character-setutf8mb4 second_hand sql/second_hand.sql第一条命令创建数据库并指定字符集为utf8mb4第二条命令导入SQL。注意--default-character-setutf8mb4这个参数很关键少了它部分SQL工具或Windows终端下导入中文数据会出现乱码导入后页面显示全是问号。导入完成后验证一下关键表mysql -uroot -p -e USE second_hand; SHOW TABLES;能看到user、goods、orders等表说明导入成功。如果某个表没建出来多半是SQL脚本里语法与MySQL 8.0不兼容最常见的是老脚本里用了ENGINEMyISAM或者过时的默认值写法单独执行那个表的建表语句就能定位。3.3 改配置application.yml里需要动的地方其实就三处项目能不能启动最终都落在配置文件上。打开src/main/resources/application.yml重点看数据源部分。绝大多数项目的初始配置都长这样server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/second_hand?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.entity需要改的就是password、username、url里的数据库名。如果你的MySQL是8.0以上驱动类名是com.mysql.cj.jdbc.Driver如果是5.7要改成com.mysql.jdbc.Driver。URL里的serverTimezoneAsia/Shanghai必须保留去掉以后连接MySQL 8.0会报时区错误。还有一处容易被忽略spring.datasource.url里的characterEncodingutf8建议直接改成characterEncodingutf8mb4保持和数据库一致。改完保存没有任何一个地方需要改业务代码。3.4 启动mvn spring-boot:run还是java -jar跑Spring Boot项目有两种常见方式。本地调试阶段我用Maven直接启动mvn spring-boot:run首次执行会下载大量依赖日志会停在三五分钟不动这时候别急着按CtrlC。看到Started Application in x.xxx seconds后说明启动成功。浏览器访问http://localhost:8080能跳转到登录页或首页就算过第一关。第二种方式是打包后运行适合确认交付可用mvn clean package -DskipTests java -jar target/*.jar-DskipTests跳过单元测试避免测试类里连不上数据库导致打包失败。target目录下的jar包可以拷到别的机器上运行前提是那台机器能访问到同一个MySQL。如果启动时提示端口被占修改server.port为8081再启动这是最省事的处理方式。4. 核心业务实现拆解登录鉴权、商品发布与订单状态流转4.1 登录鉴权Session加拦截器别引入没必要的复杂度二手交易系统的登录设计绝大多数同类项目走的是Session加拦截器方案不需要引入JWT和Spring Security。登录成功后把用户对象放进Session后续请求通过拦截器统一校验没有登录就去不了发布、订单、个人中心等受保护页面。登录逻辑上Service层按用户名查询用户再用MD5或BCrypt比对密码比对成功就写Session。关键代码是拦截器里的校验逻辑public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 从Session里取登录时存入的用户对象 Object user request.getSession().getAttribute(loginUser); if (user null) { // 没登录就踢回登录页带上当前地址方便登录后回跳 response.sendRedirect(/login?redirect request.getRequestURI()); return false; } return true; } }这段代码逻辑很简单Session里没有用户就重定向到登录页有就放行。redirect参数是很多同学会漏掉的小细节带上它登录成功后再跳回原来想访问的页面演示时不至于被人说“体验差”。注册拦截器时注意放行范围不然静态资源全被拦住Configuration public class WebConfig implements WebMvcConfigurer { Autowired private LoginInterceptor loginInterceptor; Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(loginInterceptor) .addPathPatterns(/**) .excludePathPatterns(/login, /register, /logout, /static/**, /css/**, /js/**, /images/**, /goods/list, /goods/detail/**); } }.excludePathPatterns里放行登录、注册、静态资源和商品浏览接口。这里有个常见失误有些同学把/goods/list也拦截了结果未登录用户看不到商品列表首页一片空白。4.2 商品发布MultipartFile接收图片数据库只存相对路径商品发布是二手交易系统的核心功能。页面表单提交商品信息和图片后端用MultipartFile接收上传文件保存到磁盘再把图片URL写进数据库。注意一个工程习惯图片不要存到IDEA工作目录下的webapp里重启或重打包容易丢要存到独立的磁盘目录。PostMapping(/goods/add) public String addGoods(Goods goods, RequestParam(imageFile) MultipartFile imageFile, HttpSession session) throws IOException { // 图片为空直接打回避免后续保存出空路径 if (imageFile.isEmpty()) { return redirect:/goods/publish?errorempty_image; } // 保存到本地磁盘固定目录目录不存在就自动创建 String dir D:/upload/goods/; File dirFile new File(dir); if (!dirFile.exists()) { dirFile.mkdirs(); } // 用时间戳做文件名避免不同用户上传同名文件互相覆盖 String originalFilename imageFile.getOriginalFilename(); String suffix originalFilename.substring(originalFilename.lastIndexOf(.)); String fileName System.currentTimeMillis() suffix; imageFile.transferTo(new File(dir fileName)); // 数据库里只存相对URL页面展示时再拼映射 goods.setImageUrl(/upload/goods/ fileName); // 从Session取当前登录用户作为卖家 User user (User) session.getAttribute(loginUser); goods.setSellerId(user.getId()); goods.setStatus(0); // 0在售 goodsService.addGoods(goods); return redirect:/goods/my; }参数说明imageFile对应前端表单里的nameimageFile的file输入框System.currentTimeMillis()生成文件名防止重名transferTo把临时上传文件移动目标位置。数据库只存/upload/goods/xxx.jpg展示页拼上域名端口就能访问。但这样存了还不够Spring Boot默认访问不到磁盘上的/upload路径需要加静态资源映射Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 把 /upload/** 映射到磁盘目录重启服务不丢图片 registry.addResourceHandler(/upload/**) .addResourceLocations(file:D:/upload/); }file:D:/upload/末尾的斜杠不能丢。丢了以后路径拼接会错图片全部404这个问题排查起来不动脑筋很难发现。4.3 订单状态整数状态值比字符串好维护得多订单状态是交易系统的核心设计得好不好直接影响代码可维护性。常见做法是用整数存状态把常量集中到一个状态类里public class OrderStatus { // 待付款 public static final Integer WAIT_PAY 0; // 已付款 public static final Integer PAID 1; // 已完成 public static final Integer DONE 2; // 已取消 public static final Integer CANCELED -1; }为什么不用字符串“待付款”“已付款”第一是排序和比较不方便第二是万一状态文案要改数据库里的字符串也得跟着改。用整数存页面展示时再映射成中文职责清晰。状态流转要控制好边界不能任何状态都能跳转到任何状态。比如已付款订单不能直接取消只能走完成或售后流程public boolean cancelOrder(Integer orderId, Integer buyerId) { Order order orderMapper.selectById(orderId); // 只有待付款状态允许买家取消且必须是本人订单 if (order ! null order.getStatus() OrderStatus.WAIT_PAY order.getBuyerId().equals(buyerId)) { Order update new Order(); update.setId(orderId); update.setStatus(OrderStatus.CANCELED); orderMapper.updateById(update); return true; } return false; }这段代码把校验和更新放在一起先查订单、比对状态位和买家ID、再做更新三个条件缺一不可。如果状态校验不严会出现买家取消别人订单、已付款订单被撤销的问题答辩演示时翻车概率极高。5. 避坑指南跑通Spring Boot毕设最容易翻车的五个坑5.1 启动报错Failed to configure a DataSource八成是配置没对上现象mvn spring-boot:run执行到一半控制台直接抛Failed to configure a DataSource。原因Spring Boot在启动时自动装配了数据源但application.yml里的数据库连接信息配不上。最常见的是密码错误、数据库名不存在、MySQL服务没启动。解决按顺序检查三步。第一步确认MySQL进程在运行mysql -uroot -p能登进去第二步核对username和password第三步确认数据库名与URL里的库名一致。改完配置重新启动不要只改一个字段就重启浪费时间。5.2 页面中文全是问号导库时没管字符集现象登录后首页商品标题显示???但英文和数字正常。原因SQL脚本导入时使用了系统默认字符集latin1中文被转成了问号数据已经损坏。解决把表删掉重新按utf8mb4导入mysql -uroot -p --default-character-setutf8mb4 second_hand sql/second_hand.sql如果不想删表可以用ALTER TABLE goods CONVERT TO CHARACTER SET utf8mb4;修正存量表但已经变成问号的数据恢复不回来只能重新导。所以导库这一关务必一次做对。5.3 登录成功又跳回登录页拦截器放行范围设窄了现象用户名密码正确登录接口也返回了成功但页面立刻跳回登录页像没登录一样。原因登录请求本身被拦截器拦住了Session还没来得及写入用户对象就被重定向或者写Session的时机在重定向之后登录信息根本没存进去。解决确认拦截器的excludePathPatterns放行了/login和/register这两个路径。再看登录Controller里写Session的代码是否在sendRedirect之前先request.getSession().setAttribute(loginUser, user)再重定向。5.4 Mapper接口找不到Invalid bound statement (not found)现象启动不报错但一调用某个查询接口就抛Invalid bound statement (not found)。原因MyBatis的Mapper接口和XML文件没绑定上。要么是MapperScan没加要么是application.yml里的mapper-locations路径不对。解决启动类上加MapperScan(com.xxx.mapper)同时检查yml配置mybatis: mapper-locations: classpath:mapper/*.xmlclasspath:mapper/*.xml要求XML文件必须放在src/main/resources/mapper/下。如果XML放在其他目录把路径改成对应的位置。5.5 端口被占用Port 8080 was already in use现象启动日志显示Port 8080 was already in use项目起不来。原因本机其他进程占用了8080端口比如之前跑过一次项目没关干净、Tomcat或别的开发工具占着端口。解决两种方式任选。第一种改端口application.yml里server.port: 8081第二种杀掉占用进程Windows下用命令查PID再结束进程netstat -ano | findstr 8080 taskkill /PID 1234 /Ffindstr后面返回值第二列就是进程PID/F强制结束。注意如果项目里有前端页面写死了8080的接口地址改端口后要同步改前端不然页面能开但数据请求全失败。6. 进阶玩法用启动日志给项目做体检验收前过一遍Checklist6.1 用启动日志倒推模块加载情况跑通不算完还要学会用日志验证项目的健康状态。每次mvn spring-boot:run启动时控制台输出的日志是有规律的。看到Tomcat started on port(s): 8080 (http)说明Web容器起来了看到Started Application in x.xxx seconds说明Spring容器装配完成启动过程中如果出现BeanCreationException或UnsatisfiedDependencyException说明某个Bean没装配成功按异常信息里的类名往下查。接口层面可以用curl快速验证不用打开浏览器curl http://localhost:8080/goods/list返回HTML或JSON都正常如果返回404或500再看Spring Boot日志里对应请求的异常堆栈。推荐把spring.main.banner-mode改成off日志干净一点像这种spring: main: banner-mode: off logging: level: com.example.mapper: debuglogging.level配成debug后MyBatis会把执行的SQL打印到控制台验证订单状态更新时直接能看到SQL语句和参数排查比对着数据库猜快得多。6.2 验收演示前把这三件小事做掉答辩或给别人演示前我习惯强制过一遍流程准备好一个演示用的买家账号和一个卖家账号密码别搞太复杂准备一张小于1MB的JPG图片用于发布因为部分项目把上传大小限制在1MB或2MB超出直接报错把所有测试产生的垃圾数据和脏订单清掉演示时从头走一遍“登录→发布→下单→确认收货”确保流程完整走通。以前帮一个朋友排查询他的毕设问题他跟我说数据库密码是对的但项目一直报Access denied。我从配置文件查到密码再到命令行里试登录发现他密码里有个符号被IDEA自动转义了yml里写成纯文本后被解析成了乱码。从那以后我每次拿到新的Spring Boot项目都强制自己先看一遍application.yml和启动日志再谈改代码的事。这套流程看着琐碎却能省下后面一晚上的排查时间希望帮到你。本文还有配套的精品资源点击获取