SpringBoot+Vue+MySQL水果商城系统源码解析与运行指南

不说废话直接进入正题。你看到的这个标题——飘香水果购物网站信息管理系统源码-SpringBoot后端Vue前端MySQL【可直接运行】说的就是一套完整的前后端分离电商项目以水果生鲜为业务场景从用户注册登录、商品浏览、购物车、下单支付模拟到后台的商品管理、订单管理、分类管理功能链条非常完整。对于正在做Java课程设计、毕业设计或者想系统学习SpringBootVue前后端分离开发的同学来说这是一个极佳的参考项目和练手素材。我花了一整天时间把整套源码下载、导入、配置、跑通又顺着代码把所有关键流程捋了一遍整理出这篇文章。下面会从项目架构、核心代码逻辑、数据库设计、本地运行步骤、常见故障排查这几个维度展开尽量把每个环节的“为什么”也讲明白而不只是给你一个“照着做就能跑”的教程。如果你也准备拿这套代码做二次开发、写论文或者面试讲项目这篇内容值得仔细看。1. 项目整体设计与思路拆解1.1 为什么偏偏是SpringBootVueMySQL这个组合先聊一个很多人忽略的问题市面上课设项目那么多为什么“SpringBoot Vue MySQL”成了绝对的主流这套组合背后的选型逻辑恰恰是它最值得学习的地方。从后端看SpringBoot把Spring那个曾经繁琐到劝退新人的配置过程大幅简化内嵌Tomcat一个java -jar就能起服务配合SpringMVC做接口暴露、MyBatis-Plus做数据库操作开发效率非常高。从招聘市场的真实情况来看Java后端岗位几乎绕不开SpringBoot所以拿它做课设本身就是提前进入工业级开发节奏。从前端看Vue的渐进式框架设计让它对新手特别友好。你不需要一开始就掌握完整的前端工程化体系只需要理解组件、路由、状态管理这几个核心概念就能搭出一个像模像样的管理后台和用户商城页面。配合Element UI这样的组件库做出来的界面不会像传统JSP项目那样停留在“能用”的水平而是真的接近商业网站质感。再来看MySQL它依然是中小型项目最稳妥的数据库选型。够用、免费、资料多出了任何问题都能在搜索引擎找到解决方案。水果商城这种业务场景表结构不算复杂MySQL完全能扛住而且Navicat、Workbench这些可视化工具让建表和调试变得很直观。1.2 果蔬商城到底“卖”的是什么功能“水果购物网站”听起来简单但真正拆开来看你会发现它其实是一个麻雀虽小、五脏俱全的电商系统。前端用户端要覆盖完整的购物链路后端管理端要覆盖完整的运营链路。用户端核心链路是这样的游客可以浏览商品列表、查看商品详情一旦想下单就必须走注册登录。登录之后可以把商品加入购物车在购物车里修改数量或删除确认后提交订单。订单生成后模拟支付流程通常直接置为已支付或引导用户点击“模拟支付”按钮用户可以在“我的订单”里查看所有历史订单和订单状态。管理端则是另一个视角管理员登录后进入后台看到仪表盘统计用户数、订单数、销售额之类的汇总然后可以管理商品分类、管理商品上下架与库存、处理订单发货、完成、取消、查看注册用户列表。有的版本还包含轮播图管理和公告管理算是卖点加分项。从教学角度这套需求设计非常聪明每一条功能都能对应到一个经典的技术知识点。比如登录对应JWT或Session会话管理购物车对应Redis或数据库存储方案选型订单状态变化对应枚举与状态机设计商品搜索对应SQL模糊查询或全文索引。这意味着你做完这个项目学到的不只是一堆“增删改查”而是电商业务中真实存在的表设计思路和接口约定方式。1.3 拿到源码后的第一件事看懂目录结构很多人下载完源码就直接双击运行报错了再到处搜解决办法这其实是最低效的学习路径。我的建议是先花半小时把项目目录结构“读”一遍搞清楚每一层是干什么的后面出问题你才知道去哪排查。这套项目的后端通常是标准的Maven多模块或单模块结构核心包名类似com.piaoxiang或com.fruit。controller包放接口入口service包放业务逻辑mapper或dao包负责数据库交互entity或pojo、domain包放数据库实体类config包放配置类跨域、拦截器、全局异常处理等common或utils包放工具类和统一返回结果封装。前端则通常是一个Vue CLI创建的项目src/api目录封装所有后端请求src/router配置路由src/views按页面划分组件src/store管理全局状态Vuex或Pinia。把这层结构弄懂了你会发现“前后端分离开发”这个概念变得很具体前端只负责页面渲染和交互后端只负责数据处理和业务逻辑两者通过JSON格式的HTTP接口通信。调试的时候前端看Network面板确认请求是否发出、响应是什么后端看控制台日志和SQL输出问题出在哪一层一目了然。1.4 为什么“可直接运行”并不是一句废话说实话我在拿到源码之前对这五个字是半信半疑的。因为很多标榜“可直接运行”的源码实际配套资料不齐全数据库脚本缺表、前端依赖版本冲突、后端JDK版本不匹配一个接一个的坑。但这套水果商城的完整度确实值得夸一句压缩包内通常包含完整的后端代码、前端代码、数据库SQL脚本、以及一份部署说明文档SQL脚本里的数据也是现成的包括管理员账号、测试商品、测试用户。这背后其实反映了一个优质课设项目的标准不是功能越多越好而是让人能复现、能扩展、能讲清楚。我见过太多同学买源码回来东缺一个依赖西缺一个配置花了两天时间在配环境最后项目没跑起来还要被导师质疑是不是自己写的。所以这次我特意花了时间把运行过程中所有可能踩的坑都试了一遍后面的内容全部是实战记录。2. 后端核心细节解析与实现原理2.1 SpringBoot项目结构里的“标准答案”这套项目的后端结构基本可以作为SpringBoot入门项目的教科书式范例。启动类上标注SpringBootApplication内部组合了Configuration、EnableAutoConfiguration、ComponentScan三个注解自动配置加组件扫描让Spring容器知道去哪里找Bean。application.yml或application.properties里配置服务端口、数据库连接信息、MyBatis-Plus相关配置。实体类与数据库表一一对应例如User实体对应user表属性使用驼峰命名法与数据库下划线字段通过MyBatis-Plus的驼峰映射自动转换。这里特别提一下主键ID通常会使用TableId(type IdType.AUTO)指定自增策略插入数据后会自动回填主键值这个细节在编写新增接口时很有用比如订单创建后需要立刻拿到订单ID来生成订单详情。Mapper层全部继承BaseMapperT这是MyBatis-Plus最让人舒服的地方。你要查一个用户不需要写selectByUsername的XML直接selectOne(new LambdaQueryWrapperUser().eq(User::getUsername, username))就完事了。条件构造器看起来像魔法但本质上就是帮你动态拼接SQL掌握LambdaQueryWrapper的eq、like、between、orderByDesc这几个方法这个项目的所有查询你都能看懂。Service层在接口定义方法、在实现类中用Service注解标注。业务方法上习惯添加Transactional(rollbackFor Exception.class)保证多步数据库操作要么全部成功、要么全部回滚。比如创建订单这个操作需要先插入订单主表、再批量插入订单详情表、还要扣减商品库存三步操作绝不能执行一半就中断事务在这里就是必不可少的保证。2.2 登录认证与拦截器的实现思路看这套代码时登录认证的设计非常值得仔细研究因为它直接反映了对HTTP无状态特性的理解。传统JSP项目用Session保存登录态但前后端分离项目里更常见的方案是Token机制JWT或自定义Token。前端登录成功后把Token存到localStorage之后每次请求都在请求头里带上Authorization: token值后端通过拦截器统一验证。具体到代码后端通常会定义一个LoginInterceptor实现HandlerInterceptor接口在preHandle方法里从请求头取出Token调用工具类解析如果解析失败直接返回401状态码和统一JSON提示如果成功就把用户信息放入ThreadLocal或request属性中方便Controller层直接获取当前登录用户。然后在WebMvcConfigurer实现类中注册拦截器并通过addPathPatterns和excludePathPatterns精细控制哪些路径需要登录、哪些路径放行比如登录接口、注册接口、商品列表接口。这种设计的学习价值在于它把“认证”从每个业务接口中抽离出来变成了横切关注点。你不必在每个需要登录的接口里写一遍Token验证代码而是通过配置统一搞定后面要加新的需登录接口只需在拦截器路径配置里加一行。2.3 统一返回结果与全局异常处理的必要性如果你在前后端联调时见过那种“明明后端报错了前端却只拿到一串看不懂的堆栈信息”的情况就会明白统一返回结果封装有多重要。这套项目的Controller层方法返回值一般不直接返回实体类而是返回ResultT这类统一封装对象里面通常包含三个字段code状态码如200成功、500失败、msg提示信息、data业务数据。配合全局异常处理代码优雅程度能上一个台阶。定义一个类标注RestControllerAdvice里面写多个ExceptionHandler方法分别处理业务异常、参数校验异常、空指针异常等。Controller层就不用大量try-catch包裹业务逻辑了像throw new ServiceException(库存不足)这样抛出异常后会被全局处理器捕获并转换成标准JSON返回给前端前端根据code值弹出对应的提示消息。这个小设计看着不起眼但在课程答辩时是很好的加分点因为它体现的是对“接口设计规范”的理解而不是只会写增删改查。我在代码里注意到它对参数校验也有处理实体类字段上使用NotBlank、NotNull等校验注解Controller参数前加Validated触发校验校验失败的信息会被全局异常处理器捕获并返给前端一整套流程串得很完整。2.4 从实际需求理解购物车与订单的核心逻辑购物车和订单是整套系统业务逻辑密度最高的两块值得逐行理解。购物车的实现方案通常有两种一种用Redis缓存性能好但需要额外配置Redis另一种存在数据库表中使用cart表关联用户ID和商品ID增加数量字段。这套代码考虑到“可直接运行”的需求很务实地选择了数据库存储方案毕竟对大多数课设场景数据量不大数据库方案完全够用且更容易让评委看懂。加入购物车时先查一下用户是否已添加过同一商品如果已存在则数量加一否则新增一条记录这个逻辑避免重复数据很关键。订单这块更有意思。下单时会生成订单编号常见格式是时间戳加随机数或日期加用户ID的组合比如20250104153000123456这样能保证唯一性也可以直接用数据库自增ID。一次下单可能包含多个不同商品所以设计上拆成order主表和order_item子表主表记录订单总金额、订单状态、收货信息、下单时间子表记录每个商品的快照信息商品名称、单价、数量、小计金额。把商品快照存进子表是电商系统的经典做法因为商品价格和名称后续可能变化但订单一旦生成就必须忠实记录下单那一刻的信息。订单状态通常用数字表示0待支付、1已支付待发货、2已发货、3已完成、4已取消。用户在用户端可以取消待支付订单管理员在管理端可以发货、完成订单。这种状态流转如果用if-else硬写后期维护会非常痛苦但课设阶段通常采用常量或枚举定义状态值然后在Service层写更新状态的逻辑理解起来会清晰很多。3. 数据库设计与SQL脚本分析3.1 核心表结构梳理拿到SQL脚本后我建议你先不要急着执行而是用Navicat或Workbench打开看一遍表结构从上到下理清楚这几十个字段之间的关系。这个项目的数据表数量一般在6到8张左右核心无非这几张user、category、product、cart、order、order_item有的版本还有banner轮播图和address收货地址。user表是用户基础信息表包含username、password通常是MD5加密存储、nickname、avatar、phone、email、role区分管理员和普通用户、status是否禁用、create_time。这里有个安全意识要说一下密码加密是课设项目中容易被忽略但答辩时可能被追问的点MD5虽然不算安全但比明文存储强很多如果你学有余力可以改用BCrypt加盐加密完全兼容这套项目的登录流程改造。product商品表的字段设计很典型product_name、product_subtitle副标题、category_id关联分类表、price折扣价、original_price原价、stock库存、sales销量、main_image商品主图、detail富文本详情、status上下架状态。关联分类表比直接在商品表里保存分类名称要规范得多这样如果分类改名只需要改分类表不需要批量更新商品数据。order订单表和order_item订单明细表上文已经提过最关键的是它们之间的外键关联通过order_id字段关联但数据库中未必一定建立物理外键。很多生产级别项目故意不建物理外键而是在代码层面维护一致性这样既保证了一定的灵活性也避免了对性能的影响。课设阶段建不建外键都能讲出道理关键是你得能回答上来为什么这么设计。3.2 测试数据里的小心思打开SQL文件的INSERT语句你会发现里面的测试数据非常有讲究。管理员账号通常是admin/admin123普通用户可能是user/123456商品数据覆盖了水果商城的各个品类苹果、香蕉、橙子、榴莲、车厘子、西瓜等价格和库存都设置得比较合理部分商品甚至配有真实的商品图片URL。这些种子数据看着简单但其实是从“能跑”到“好看”的关键一步。想象一下如果你登录后台看到的是一片空白很难判断是功能坏了还是真的没数据。而有了这些现成数据前端页面一打开就是琳琅满目的商品列表购物车和订单也能立刻演示起来整个系统的演示效果立刻上一个台阶。如果你打算在这个项目基础上做二次开发我强烈建议你自己把种子数据替换一遍改成你论文里需要的商品类别和名称。很多同学答辩翻车就是因为在演示时被老师发现商品名字还是源码默认的一眼就露馅。替换数据不需要改代码只要改SQL脚本里的INSERT语句重新导入即可。3.3 索引设计与SQL性能观察虽然课设阶段数据量不大很难出现性能问题但在关键字段上建索引依然是值得做的好习惯也方便你答辩时被问到优化问题时作答。user表的username字段应该建唯一索引因为登录时要根据用户名查询product表的category_id字段建普通索引因为商品列表页要按分类筛选order表的user_id字段建索引因为用户查询“我的订单”场景很常见。另一个值得看的小点是日志中打印的SQL语句。SpringBoot配合MyBatis-Plus在application.yml里设置mybatis-plus.configuration.log-implorg.apache.ibatis.logging.stdout.StdOutImpl后控制台会打印每条执行的SQL。运行项目后你可以在控制台观察到分页查询、条件查询这些SQL是怎么动态生成的。下次启用前端页面、触发一个商品搜索再回头看控制台输出的SQL你就对“持久层”有了很直观的感知。4. 前端Vue工程与页面交互流程4.1 前端目录结构与组件设计Vue前端这块一眼看过去是标准Vue CLI搭建的工程结构。node_modules存放依赖包public放静态资源如index.html和网站Logosrc下面是核心源码。src/main.js是入口文件负责创建Vue实例、挂载路由和状态管理、引入全局样式src/App.vue是根组件通常只放一个router-view /所有页面内容都根据路由动态渲染。src/router/index.js文件里配置了所有页面路由并设置了路由守卫。这个路由守卫是实现“登录后才能访问”的关键router.beforeEach((to, from, next) { ... })在跳转前检查localStorage里是否存在Token如果没有就跳转到登录页并带上redirect参数方便登录成功后跳回原页面。如果你发现“明明登录了但刷新页面后还是被踢回登录页”大概率就是路由守卫那里的读取逻辑有问题例如没有从localStorage读取或Token字段名不一致。src/api目录下的文件是对Axios请求的二次封装通常会创建一个request.js设置baseURL例如http://localhost:8080、超时时间、请求拦截器附加Token请求头、响应拦截器统一处理code非200的情况例如登录失效时跳转登录页。每个业务模块再单独建文件如user.js放登录注册接口product.js放商品列表和详情接口order.js放下单和订单查询接口。这种按模块组织API的方式是Vue项目中非常推荐的工程化实践后续维护接口时不需要在几十个页面里搜索请求代码。4.2 用户端核心页面拆解用户端页面通常包括首页、商品分类页、商品详情页、购物车页、结算页、订单列表页、个人中心页。首页往往是“门面担当”设计上会花最多心思顶部导航栏Logo、搜索框、购物车入口、用户信息、轮播图banner、商品分类快捷入口、热销商品列表。数据请求通常在created生命周期钩子里发起调用API函数把响应数据存到data或Vuex中模板部分通过v-for循环渲染商品卡片。商品详情页是一个动态路由页面路由配置类似path: /product/:id组件内通过this.$route.params.id获取商品ID再调用商品详情接口。页面核心信息是主图、标题、价格、库存、购买数量选择器、加入购物车和立即购买按钮。加入购物车成功后通常用this.$message.success弹窗提示这个交互反馈很重要没有的话用户点按钮会以为没反应。购物车页和结算页是交互密集型页面。购物车列表有勾选框控制选中商品页面底部实时计算总价全选、单选、数量加减、删除商品每一个操作都会触发重新计算。结算页一般让用户选择收货地址、确认商品清单、填写备注最后点“提交订单”按钮前端就把要买的商品数据通过POST请求发给后端成功后跳转到订单列表或支付模拟页。这套交互流程在“前端展示与用户操作反馈”这部分是很典型的案例值得逐行阅读源码理解数据的流向。4.3 管理后台权限控制与菜单渲染逻辑管理后台是另一套独立的路由和页面布局。通常路径带/admin前缀菜单项包括仪表盘、用户管理、商品管理、分类管理、订单管理等。权限控制方面前端路由会区分用户端路由和管理端路由前端在路由守卫里检查当前登录用户的role字段如果非管理员则不能进入任何/admin开头的页面。后端配合这个逻辑管理员接口在拦截器或注解层面校验权限双重防护。这里的思路非常清晰前端限制只是为了用户体验真正的安全性必须由后端保证因为API是可以被直接调用的。后台商品管理页面是一个典型的“表格表单弹窗”组合页面顶部是搜索栏支持按商品名称关键词搜索中间是el-table展示商品列表最后一列是操作按钮编辑、上下架、删除。点击“新增商品”按钮则弹出一个el-dialog表单里面各表单组件分别对应商品表的各个字段上传图片组件会先把图片上传到服务器或直接填图片地址提交时把整个表单数据POST给后端。4.4 Axios封装与跨域调试经验在前面提到request.js是Axios二次封装的核心这里展开说一个实际开发中一定会遇到的痛点跨域问题。前端开发服务器一般是http://localhost:8081或8080后端是http://localhost:8080虽然端口只差一位但浏览器的同源策略会直接拦住请求。解决跨域的方式主要有两种第一种是后端开启CORS在SpringBoot中通过WebMvcConfigurer添加CorsRegistry允许指定来源或所有来源访问第二种是前端通过Vue CLI的devServer.proxy配置代理把前端的/api请求转发到http://localhost:8080这样浏览器的请求看起来是同源的就不会报跨域错误。这套项目使用的是哪种方式不重要重要的是你要理解如果你启动后能看到页面但所有数据都是空的打开F12的Console看到诸如Access-Control-Allow-Origin的错误那十有八九就是跨域没配好。我在后面的常见问题部分还会展开写排查步骤。5. 本地运行完整实操指南5.1 环境准备JDK、Maven、Node、MySQL版本怎么选再三强调环境版本是“可直接运行”的第一道门槛。根据这套项目的技术栈我对推荐版本做了一个整理跟着来可以少踩很多坑。组件推荐版本说明JDKJDK 8 或 11大多数SpringBoot 2.x项目的标准选择Maven3.6.x 或 3.8.x用于后端依赖管理和打包MySQL5.7 或 8.0注意8.0的驱动和时区配置Node.js14.x 或 16.x对应Vue CLI 4.x/5.x的兼容范围IDEIntelliJ IDEA VSCode后端IDEA前端VSCode或IDEA均可具体到这套源码如果它是基于SpringBoot 2.4左右版本写的JDK 8完全没问题MySQL 5.7和8.0都能连。但如果源码基于SpringBoot 3.x那就必须用JDK 17以上MySQL驱动也要换新的。拿到项目后先打开pom.xml看一眼spring-boot-starter-parent的版本号再确定JDK版本。Node版本不要太新我试过用Node 18配Vue CLI 4会报OpenSSL错误经典的ERR_OSSL_EVP_UNSUPPORTED解决方案是升级Vue CLI或降低Node版本。为了避免这种问题建议直接Node 16稳妥起步。5.2 初始化数据库SQL脚本导入与账号配置第一步把源码包里sql或db目录下的SQL文件通常叫fruit_shop.sql或piaoxiang.sql用Navicat或命令行导入。打开Navicat新建连接输入MySQL的用户名密码默认root/root或root/123456具体看源码文档右键新建数据库名称建议与脚本内的库名保持一致比如piaoxiang_fruit字符集选utf8mb4排序规则选utf8mb4_general_ci或utf8mb4_unicode_ci。选中新创建的数据库右键“运行SQL文件”选择那个sql文件执行完成后刷新表列表如果看到那七八张表说明导入成功。这时候建议先双击每张表看一看数据确认不是空表。第二步修改后端数据库连接配置。在application.yml里找到这一段改成你自己的账号和密码spring: datasource: url: jdbc:mysql://localhost:3306/piaoxiang_fruit?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 你的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver关于连接串有几个参数值得说明useUnicodetruecharacterEncodingutf-8解决中文乱码useSSLfalse避免MySQL 8.0的SSL警告serverTimezoneAsia/Shanghai解决时区报错MySQL 8.0如果没配时区就会报The server time zone value的异常。5.3 启动后端从Maven导入到控制台运行后端启动的常规操作是用IDEA打开后端文件夹等待Maven自动下载依赖。这一步可能比较耗时取决于网速和Maven仓库配置。我第一次导入时等了将近十分钟如果你的网络不太顺畅强烈建议在IDEA的Maven配置里设置阿里云镜像mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror依赖下载完成后在IDEA右侧Maven面板执行clean和install然后找到启动类比如FruitShopApplication.java右键“Run”。看到Console里出现Started FruitShopApplication in x.xxx seconds和Tomcat started on port(s): 8080字样说明后端启动成功。这时可以先用浏览器或Postman测试一个接口例如访问http://localhost:8080/api/product/list具体路径以源码为准返回JSON数据就说明后端没问题。控制台如果打印出了SQL语句说明数据库连接和MyBatis-Plus配置都是通的。5.4 启动前端npm依赖安装与页面访问前端启动相对容易踩坑主要坑在依赖安装这一步。打开终端进入前端目录先执行依赖安装命令。由于默认npm源在国内速度较慢建议先切换成淘宝镜像npm config set registry https://registry.npmmirror.com npm installnpm install执行时间取决于依赖数量和机器性能有时候会因网络问题中断重试即可。如果执行过程中报node-sass相关的错那基本就是Node版本不对建议改用Node 16或者把依赖里的node-sass替换成sass再重新安装。依赖安装完成后执行启动命令npm run serve看到App running at: Local: http://localhost:8081/说明启动成功浏览器访问这个地址就能看到商城首页了。如果你的后端端口是8080前端是8081那么此前配置的跨域或代理设置就派上了用场。正常访问后用SQL脚本里的管理员账号登录后台用普通用户账号登录用户端把购物、下单、发货全流程走一遍这个项目就算真正“跑通”了。5.5 线上部署的思路与注意点加分项课设如果能做到本地运行通常已经满足基本要求但如果想拿高分可以顺便提一句如何部署到云服务器。打包后端时在项目根目录执行mvn clean package -DskipTests会生成一个jar包前端执行npm run build会把所有静态文件打包到dist目录这个目录可以直接交给Nginx托管。Nginx配置里的proxy_pass负责把/api开头的请求转发到后端端口再配合一个域名和HTTPS证书就是一个标准的线上前后端分离部署方案。部署这种话题在答辩时很容易延展但如果你只是课设不建议实际操作因为服务器还要额外花钱而且部署过程本身坑也不少。知道原理、能说出关键步骤就够了。6. 常见问题与排查技巧实录6.1 前端页面能打开但所有数据都是空的这个问题的出现频率非常高几乎每个第一次启动前后端分离项目的同学都会遇到。排查思路要按顺序走第一步打开浏览器F12开发者工具切到Network标签栏刷新页面看请求列表里有没有红色状态4xx或5xx。第二步看请求是不是打到后端正确端口了如果你后端在8080但请求显示的是8081那肯定是代理或baseURL配置不对。第三步看响应内容如果提示CORS跨域错误说明后端没有开启跨域支持如果响应404说明路径不对如果响应500要看后端控制台的错误日志。这里有一种情况特别迷惑后端启动成功了但数据库没导入或有改动导致SQL查询报错前端会拿到500状态码但页面上一片空白看不到任何错误提示。所以我一般建议“先测后端再连前端”确保http://localhost:8080/api/product/list能直接返回数据后再去排查前端。6.2 后端报错端口被占用怎么办SpringBoot默认端口是8080如果你本机已经运行了其他占用8080的服务比如另一个Java进程、Tomcat、或某些中间件那启动时就会看到Port 8080 was already in use的报错。解决办法有两种一是找到占用进程并结束它二是直接改端口在application.yml里设置server.port: 8088改了之后记得前端代理或axios的baseURL也要同步修改。在Windows下查找端口占用推荐使用一行命令解决netstat -ano | findstr :8080找到占用8080端口的进程PID后再执行taskkill /PID 对应PID /F在Mac或Linux下是lsof -i :8080找到PID再用kill -9 对应PID杀掉。6.3 数据库连接失败提示Access denied或Unknown database这类报错基本都指向两个文件application.yml里的数据库账号密码以及SQL导入时创建的库名。Access denied for user rootlocalhost说明用户名或密码不对去确认你的MySQL安装时设置的root密码这里有一个小坑很多同学安装MySQL时随手设的密码过了一周自己都忘了建议用Navicat测试连接能通之后再启动项目。Unknown database xxx说明配置里的库名和实际导入的库名不一致。要么把SQL重新导入到配置指定的库名里要么把配置改成实际库名两者对齐即可。另一个数据库相关但更隐蔽的是Public Key Retrieval is not allowed这是MySQL 8.0的认证机制导致的问题在连接串后面加allowPublicKeyRetrievaltrue即可解决。6.4 npm install成功但npm run serve报错依赖安装了仍然启动失败大多是版本兼容问题。最典型的是前面提到的ERR_OSSL_EVP_UNSUPPORTED原因是新版Node17以上不再支持旧版Webpack使用的md4哈希算法。解决方案有三选一推荐把Node版本降到16.x或14.x用nvm管理Node版本最方便。在package.json的scripts里把serve: vue-cli-service serve改成serve: set NODE_OPTIONS--openssl-legacy-provider vue-cli-service serveWindows下有效。升级Vue CLI和相关依赖但升级可能引发其他连锁问题不太推荐课设阶段折腾。另一个高频报错是Module not found: Error: Cant resolve xxx通常是某个依赖没有安装成功删除node_modules目录和package-lock.json文件后重新npm install再启动基本就能恢复。6.5 订单提交总是不成功看了日志才知道原因我在测试这套项目时遇到过一种情况用户端下单时报错“库存不足”但前端明明显示商品是有库存的。查了后端日志才发现商品在数据库里的实际库存字段值是0前端页面显示的数据是缓存的或者卖家忘了更新库存。这个问题的根源不是代码bug而是业务数据问题但也说明前端显示和后端校验之间存在时间差。类似这种和业务状态相关的问题在排查时一定要学会看后端日志。SpringBoot的日志里会打印异常堆栈和SQL语句很多问题的答案其实都写在堆栈里。比如某个字段为空报空指针、某条SQL执行失败报SQL语法错误都能通过日志里的信息直接定位到具体代码行。遇到报错不要急先把异常信息完整复制下来搜索一下关键报错字段十有八九能找到解决方案。写在最后的个人体会这套“飘香水果购物网站”源码我前前后后跑了三遍第一遍按部就班走通第二遍断点调试了核心接口第三遍把前端页面和后端代码对照着读完。整体感受是它不是一个花哨炫技的项目但它的“标准”和“完整”恰恰就是最大的优点。对于准备找Java开发实习或参加校招的同学来说在简历上写“熟悉前后端分离开发流程能够独立完成电商系统模块设计与实现”如果背后没有一套真正跑通的项目撑着面试官一问细节就会露馅。我的建议是拿到源码跑通之后一定要自己动手改几个地方。比如给商品表加一个“产地”字段让前端页面能展示产地标签比如给订单列表加一个按时间筛选的功能比如把登录从简单的token改成带过期时间的token。这些改动都能让你真正理解这套代码的来龙去脉。等到答辩或面试时你能讲清楚的不只是“我用了SpringBoot和Vue”而是“为什么订单表要拆成主表和明细表”“为什么购物车不在前端存而是存后端数据库”“为什么前端路由守卫不能替代后端权限校验”这才是一套源码带给你最值钱的东西。最后再分享一个小技巧如果你打算拿这套代码参加课程设计答辩提前把管理员后台上传的商品主图换成本地图片不要在答辩现场依赖外部图片链接。很多公开授课或演示翻车都发生在网络不好、图片全部加载失败的时候这种细节平时看不出来关键时刻却是致命的。