简介这是一份基于Java Spring Boot框架和MySQL数据库实现的外卖管理系统源代码属于实战型教学项目面向正在学习Java Web开发的初中级开发者也适合作为高校课程设计或毕业设计的参考模板。系统围绕用户、商家、菜品、订单等核心业务模块展开完整覆盖Spring Boot接口开发、Spring Data JPA数据持久化、MySQL多表关系设计、Spring Security安全控制等关键知识点。项目内附有标准的Maven工程结构、配置文件与资源目录代码注释清晰模块间耦合度低便于逐块阅读、本地调试和二次扩展。资源压缩包共72个文件以Java源码、HTML页面、JavaScript脚本、CSS样式表为主同时包含PNG图片、字体文件和图标等前端资源整体大小约4.01MB解压后可直接导入常见开发工具运行。目前已有133人学习使用特别适合用来看懂外卖系统从数据库建模、后端接口实现到前端页面联调的整体流程也是项目答辩、课程作业或日常积累代码经验的有效素材。 学生们做课程设计或者毕业设计十个里有六七个都会选“外卖管理系统”这个题目。原因很简单业务场景贴近生活功能边界清晰做完能看懂、能演示、能写进简历。但正因为做的人多网上流传的所谓“源代码”质量参差不齐有的是十几年前的老框架有的缺表结构有的甚至跑不起来。我最近刚好重构了一个基于 Java Spring Boot MySQL 的简单外卖管理系统把前后端、数据库、部署这些串了一遍这篇文章就围绕这套源代码展开说说它到底包含什么、怎么跑起来、有哪些坑是可以提前避开的。无论你是正在做课程设计的在校生还是想快速上手 Spring Boot 的初学者这套项目源码都值得拿来当练习素材。1. 项目整体设计与思路拆解1.1 这个外卖系统解决了什么问题外卖管理系统的核心需求其实就三件事用户能点餐、商家能出餐、管理员能管人管单。听起来简单但落到系统设计上牵扯的细节并不少。以这套源代码为例它不是一个玩具级的单体页面而是按角色拆分了用户端、商家端和管理员端三个入口每个端口对应一套操作逻辑。从实际业务角度看用户端要能注册登录、浏览菜品、加入购物车、下单支付模拟、查看订单状态商家端要能维护菜品信息、处理订单状态管理员端要能管理用户和商家账号。这些功能拆开来看都不复杂但组合在一起就需要合理的模块划分和数据库设计这也是这套源码最有学习价值的地方。1.2 为什么选 Spring Boot MySQL 这套组合很多人在技术选型时纠结SSM 不是也行吗Spring Boot 和 SSM 不是一回事吗这里我直接说结论。SSMSpring Spring MVC MyBatis是传统的手动配置方案光 XML 配置文件就能写好几页Spring Boot 则把大部分配置自动化了内嵌 Tomcat启动时不用额外部署 war 包非常适合中小型项目和初学者上手。这套方向组合还有一层实际考量就业市场。目前国内 Java 后端岗位的日常开发基本围绕 Spring Boot 展开而 MySQL 又是最主流的关系型数据库。哪怕你将来去做微服务、分布式底层还是离不开这些基础能力。所以拿这个项目练手投入产出的性价比很高。1.3 功能模块如何划分这套项目的模块划分是典型的 MVC 变种按业务域拆分为用户模块、商家模块、菜品模块、购物车模块、订单模块和公共配置模块。用户模块注册、登录、个人信息维护商家模块商家注册、菜品管理、订单处理菜品模块菜品列表、按分类搜索、菜品上下架购物车模块加购、修改数量、删除、清空订单模块创建订单、订单状态流转、历史订单公共模块统一返回结果、全局异常处理、拦截器这种划分的好处是职责清晰一个 Controller 只管一类请求后续想扩展功能比如加一个优惠券模块也方便。初学者拿到源码后先按这个模块地图去看代码会比从头到尾瞎翻效率高得多。2. 核心技术点与项目结构解析2.1 项目目录结构一览拿到源代码后第一步不是急着点运行而是先把目录结构看明白。这套项目采用标准的 Maven 结构核心代码在src/main/java下按包名分层资源文件在src/main/resources下。src/main/java/com/example/delivery ├── common/ # 公共类统一返回结果、常量、异常处理 ├── config/ # 配置类拦截器、跨域配置、WebMvc 配置 ├── controller/ # 控制层接收请求、返回视图或数据 ├── service/ # 业务层核心业务逻辑 │ └── impl/ # 业务实现类 ├── mapper/ # MyBatis 数据访问层接口 ├── entity/ # 实体类对应数据库表 ├── dto/ # 数据传输对象 └── DeliveryApplication.java # Spring Boot 启动类resources 目录下则是application.yml配置文件、mapper/MyBatis XML 文件和static/或templates/前端静态资源或模板页面。2.2 数据库表设计思路数据库表设计是整个外卖系统最核心的部分也是面试官喜欢追问的内容。这套项目的表结构不算多但表之间的关系设计值得细细品味。主要包含以下表表名用途核心字段user用户表id, username, password, phone, address, rolebusiness商家表id, name, phone, address, statusdish菜品表id, business_id, name, price, description, statuscart_item购物车表id, user_id, dish_id, quantityorders订单表id, order_no, user_id, business_id, total_amount, status, create_timeorder_item订单明细表id, order_id, dish_id, quantity, price这里有个容易踩的坑很多初学者会把订单里的菜品信息直接设计成几个字段存进订单表比如dish_names、dish_prices。这种设计在演示阶段看不出问题但一旦需要改价或统计销量就会乱套。正确做法是拆出订单明细表订单只存总金额和状态明细表记录每一道菜的单价和数量。这套源码用的就是标准的订单加明细方案写论文的时候也可以强调这一点。2.3 核心流程用户下单的完整链路整个系统最值得捋清楚的一条线就是用户从登录到下单的完整请求链。理解了这条链路套餐里所有模块的代码就串起来了。用户点击“提交订单”后前端把地址和备注传给后端订单 Controller 接收到请求后先调用购物车 Service 获取当前用户购物车里的所有菜品接着计算总金额生成唯一的订单编号把订单主表和明细表的数据插入数据库这里必须放在一个事务里保证不出现订单已创建但明细缺失的情况最后清空购物车把订单对象返回给前端。这套流程代码上不复杂但需要注意几个细节。第一是事务注解的使用下单方法必须加Transactional否则中途报错会导致数据不一致。第二是金额计算应该在后端完成不能信任前端传过来的总价因为请求可以被篡改。第三是订单编号的生成规则这套源码用的是时间戳加随机数的组合量小够用量大则需要更严谨的分布式 ID 方案。3. 实操过程与核心环节实现3.1 环境准备JDK、Maven、MySQL 的版本搭配这里要说一个真实的痛点很多人项目跑不起来不是代码的问题而是环境版本不匹配。Spring Boot 的版本和 JDK、MySQL 驱动之间是有对应关系的版本太高或太低都会导致各种怪异报错。我自己的建议组合是JDK 1.8 Maven 3.6.3 Spring Boot 2.7.x MySQL 8.0。这套组合网上资料最多踩坑教程最齐全对新手最友好。不要一上来就追新直接上 Spring Boot 3.x那玩意要求 JDK 17很多学校的机房电脑还没装而且javax.servlet变成了jakarta.servlet老代码会大面积报错。MySQL 安装完成之后记得用客户端工具Navicat、DataGrip 或者命令行执行项目里提供的delivery.sql脚本初始化数据库和表数据。不要省略这一步直接启动项目否则会因为找不到表而报一堆红色异常。3.2 application.yml 核心配置解读配置是 Spring Boot 项目的命门。这套源码的application.yml配置并不复杂但每一项都值得弄清楚含义server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/delivery?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 thymeleaf: cache: false mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.delivery.entity这里最容易被忽略的是 URL 里那一长串参数。useSSLfalse是关闭 SSL 连接避免本地环境下的证书警告serverTimezoneAsia/Shanghai是设定时区不写的话会报 CST 和 UTC 的时间差错误characterEncodingutf-8解决中文乱码问题。这三个参数少一个运行阶段都可能出现莫名其妙的 bug。3.3 核心代码下单接口的完整实现下面看一段下单接口的核心代码这是理解整套系统运行逻辑的关键入口PostMapping(/order/submit) Transactional public ResultString submit(RequestBody OrderSubmitDTO dto) { // 1. 获取当前登录用户的 ID从 session 中取 Long userId (Long) session.getAttribute(userId); if (userId null) { return Result.error(请先登录); } // 2. 查询购物车中该用户的全部菜品 ListCartItem cartList cartMapper.selectByUserId(userId); if (cartList null || cartList.isEmpty()) { return Result.error(购物车不能为空); } // 3. 计算总金额同时构造订单明细列表 BigDecimal totalAmount new BigDecimal(0); ListOrderItem orderItemList new ArrayList(); for (CartItem cartItem : cartList) { Dish dish dishMapper.selectById(cartItem.getDishId()); if (dish null || dish.getStatus() 0) { return Result.error(部分菜品已下架请重新确认); } BigDecimal itemAmount dish.getPrice().multiply(new BigDecimal(cartItem.getQuantity())); totalAmount totalAmount.add(itemAmount); OrderItem orderItem new OrderItem(); orderItem.setDishId(dish.getId()); orderItem.setQuantity(cartItem.getQuantity()); orderItem.setPrice(dish.getPrice()); orderItemList.add(orderItem); } // 4. 生成订单号并插入订单主表 String orderNo generateOrderNo(); Orders order new Orders(); order.setOrderNo(orderNo); order.setUserId(userId); order.setTotalAmount(totalAmount); order.setStatus(1); // 1 表示待接单 order.setCreateTime(new Date()); orderMapper.insert(order); // 5. 批量插入订单明细 orderItemMapper.batchInsert(order.getId(), orderItemList); // 6. 清空购物车 cartMapper.deleteByUserId(userId); return Result.success(orderNo); }简单解释几个关键点。第一步从 session 获取用户 ID说明这个项目的登录状态是放在服务端 session 里的这是单体应用常用的方式代码简单但注意要搭配拦截器做登录校验。第三步为什么要重新查一遍菜品价格因为购物车表里可能存的是加购当时的价格如果后来商家改了价用户结算时应该按最新价格走。这个细节体现了真实业务中的一致性考虑面试时能主动聊出来会很加分。3.4 手动实现拦截器做登录校验Spring Boot 开发时很多人图省事在每个 Controller 里都写一遍“是否已登录”的判断代码冗余不说漏写一个就是安全漏洞。这套源码用的是拦截器方案统一处理登录校验。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口 String uri request.getRequestURI(); if (uri.contains(/login) || uri.contains(/register)) { return true; } Object userId request.getSession().getAttribute(userId); if (userId null) { response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } return true; } }然后在配置类里注册拦截器指定拦截路径Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns(/login, /register, /dish/**, /business/**); } }这样业务接口里就不再需要写登录判断了拦截器统一拦截代码干净很多。要注意的是放行路径要仔细配置比如首页展示菜品列表和商家列表的接口必须放行否则用户没登录连菜品都看不见这就不符合真实外卖平台的交互逻辑了。4. 常见问题与排查技巧实录4.1 端口被占用Web server failed to start这是新手遇到最多的报错之一。尤其是电脑上装了多个 Java 服务或者之前启动过没关掉8080 端口就容易被占。Description: Web server failed to start. Port 8080 was already in use.解决办法有三种。第一种是找到占用进程并杀掉Windows 下执行netstat -ano | findstr 8080拿到 PID然后taskkill /PID xxx /FMac/Linux 下用lsof -i:8080拿到进程号后kill -9。第二种是直接换端口修改application.yml里的server.port。第三种最省事把服务停掉比如强制退出 IDE 里之前运行的实例。4.2 时区问题Cannot create PoolableConnectionFactory这个报错的具体提示是The server time zone value is unrecognized or represents more than one time zone核心原因就是 MySQL 连接 URL 里没有设置时区。解决办法是在 datasource 的 url 后面加上serverTimezoneAsia/Shanghai。如果你用的是 MySQL 5.x驱动类名要写com.mysql.jdbc.Driver如果用 MySQL 8.0驱动类名必须是com.mysql.cj.jdbc.Driver。这个区别很多人不注意导致导入项目后一启动就报“ClassNotFound”。4.3 MyBatis 绑定异常Invalid bound statement这个报错说明 Mapper 接口和 XML 文件没有正确关联。通常有三种原因一是 XML 文件没有放在resources/mapper目录下二是 XML 里的 namespace 没有写对三是application.yml里的mapper-locations配置缺失。检查方法很简单看 XML 文件的 namespace 是否等于 Mapper 接口的全限定名比如com.example.delivery.mapper.UserMapper看 XML 中的 id 是否等于接口方法名看 target/classes 目录下有没有把 XML 编译过去。平时用 IDEA 的话还要确认 resources 文件有没有被标记为资源根目录。4.4 常见问题速查表问题现象可能原因解决办法启动时报数据库连接失败MySQL 未启动/密码错误/表未初始化启动 MySQL、检查账号密码、执行 sql 初始化脚本中文乱码数据库编码不是 utf8或连接参数没配建库时指定 utf8mb4url 加 characterEncodingutf-8登录后访问接口返回 401拦截器配置过严session 失效检查拦截器 excludePathPatterns确认请求携带 sessionId菜品列表图片加载不出来图片路径是绝对路径或未做静态资源映射用相对路径或配置 WebMvc 映射/upload/**到本地目录购物车或订单数据错乱多用户之间用了同一个 userId 缓存确认登录后 session 中存入的是当前用户 ID4.5 有一个坑很多人没意识到注意前端请求的跨域问题如果你是前后端分离开发前端跑在 5173 端口后端跑在 8080 端口直接请求会报跨域错误。这套源代码里 WebConfig 配置了跨域支持但如果你自己写项目忘了这步就会卡在浏览器控制台的红字上。registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowCredentials(true) .maxAge(3600);注意allowedOriginPatterns和allowedOrigins的区别如果开启了allowCredentials(true)allowedOrigins不能写*必须用allowedOriginPatterns指定否则部分浏览器会直接拒绝请求。这个细节很小但排查起来很浪费时间。5. 项目部署与扩展建议5.1 将项目打包发布到服务器本地跑通只是第一步真正完整的学习流程还包括部署。Spring Boot 项目有一个天然优势可以打成可执行 jar 包在服务器上一条命令启动。mvn clean package -DskipTests java -jar target/delivery-0.0.1-SNAPSHOT.jar如果服务器也装了 MySQL把本地导出的delivery.sql导入到服务器的数据库再修改打包前application.yml里的数据库地址和密码其他地方基本不用动。这套源码在本地开发和服务器部署的环境差异很小移植成本低这也是它适合练手的另一个原因。5.2 还能再扩展哪些功能如果你做完这个项目觉得意犹未尽想进一步提升可以按以下顺序加功能加入 Redis 缓存菜品信息降低数据库查询压力使用 JWT 替换 Session 登录机制实现无状态认证增加商家端订单状态流转的可视化控制比如接单、制作、配送、完成引入 Spring Security 做基于角色的权限控制加入支付模块的模拟对接支付宝沙箱或微信支付沙箱前后端分离改造前端用 Vue 3 Element Plus 重写每加一个功能都会迫使你去学习一个新的技术栈。建议每次只加一个改完跑通再动下一个不要一次性想把所有功能都怼上去否则出了 bug 都不知道从哪里查。我自己的习惯是在学习阶段给这类项目单独建一个 Git 仓库每完成一个功能就提交一次看提交历史就能直观地看到项目是怎么一步步长大成型的。这种管理方式也方便你在面试前快速回顾自己写过的东西。最后说一个实际体会做这类管理系统真正的难点从来不是某一个技术点而是把所有简单功能串起来之后如何保证数据准确、流程顺畅、代码不被乱成一团。把这套源码吃透你会发现 Spring Boot 的开发模式、MyBatis 的 CRUD 操作、MySQL 的表关系设计这些东西一下就通了。后续再去学更复杂的分布式项目底子就是从这里打起来的。本文还有配套的精品资源点击获取 
长河君 · 2026/9/2 13:59:12 · 阅读 1.2k Spring Boot+MySQL外卖管理系统源码解析：从架构设计到部署避坑
简介这是一份基于Java Spring Boot框架和MySQL数据库实现的外卖管理系统源代码属于实战型教学项目面向正在学习Java Web开发的初中级开发者也适合作为高校课程设计或毕业设计的参考模板。系统围绕用户、商家、菜品、订单等核心业务模块展开完整覆盖Spring Boot接口开发、Spring Data JPA数据持久化、MySQL多表关系设计、Spring Security安全控制等关键知识点。项目内附有标准的Maven工程结构、配置文件与资源目录代码注释清晰模块间耦合度低便于逐块阅读、本地调试和二次扩展。资源压缩包共72个文件以Java源码、HTML页面、JavaScript脚本、CSS样式表为主同时包含PNG图片、字体文件和图标等前端资源整体大小约4.01MB解压后可直接导入常见开发工具运行。目前已有133人学习使用特别适合用来看懂外卖系统从数据库建模、后端接口实现到前端页面联调的整体流程也是项目答辩、课程作业或日常积累代码经验的有效素材。 学生们做课程设计或者毕业设计十个里有六七个都会选“外卖管理系统”这个题目。原因很简单业务场景贴近生活功能边界清晰做完能看懂、能演示、能写进简历。但正因为做的人多网上流传的所谓“源代码”质量参差不齐有的是十几年前的老框架有的缺表结构有的甚至跑不起来。我最近刚好重构了一个基于 Java Spring Boot MySQL 的简单外卖管理系统把前后端、数据库、部署这些串了一遍这篇文章就围绕这套源代码展开说说它到底包含什么、怎么跑起来、有哪些坑是可以提前避开的。无论你是正在做课程设计的在校生还是想快速上手 Spring Boot 的初学者这套项目源码都值得拿来当练习素材。1. 项目整体设计与思路拆解1.1 这个外卖系统解决了什么问题外卖管理系统的核心需求其实就三件事用户能点餐、商家能出餐、管理员能管人管单。听起来简单但落到系统设计上牵扯的细节并不少。以这套源代码为例它不是一个玩具级的单体页面而是按角色拆分了用户端、商家端和管理员端三个入口每个端口对应一套操作逻辑。从实际业务角度看用户端要能注册登录、浏览菜品、加入购物车、下单支付模拟、查看订单状态商家端要能维护菜品信息、处理订单状态管理员端要能管理用户和商家账号。这些功能拆开来看都不复杂但组合在一起就需要合理的模块划分和数据库设计这也是这套源码最有学习价值的地方。1.2 为什么选 Spring Boot MySQL 这套组合很多人在技术选型时纠结SSM 不是也行吗Spring Boot 和 SSM 不是一回事吗这里我直接说结论。SSMSpring Spring MVC MyBatis是传统的手动配置方案光 XML 配置文件就能写好几页Spring Boot 则把大部分配置自动化了内嵌 Tomcat启动时不用额外部署 war 包非常适合中小型项目和初学者上手。这套方向组合还有一层实际考量就业市场。目前国内 Java 后端岗位的日常开发基本围绕 Spring Boot 展开而 MySQL 又是最主流的关系型数据库。哪怕你将来去做微服务、分布式底层还是离不开这些基础能力。所以拿这个项目练手投入产出的性价比很高。1.3 功能模块如何划分这套项目的模块划分是典型的 MVC 变种按业务域拆分为用户模块、商家模块、菜品模块、购物车模块、订单模块和公共配置模块。用户模块注册、登录、个人信息维护商家模块商家注册、菜品管理、订单处理菜品模块菜品列表、按分类搜索、菜品上下架购物车模块加购、修改数量、删除、清空订单模块创建订单、订单状态流转、历史订单公共模块统一返回结果、全局异常处理、拦截器这种划分的好处是职责清晰一个 Controller 只管一类请求后续想扩展功能比如加一个优惠券模块也方便。初学者拿到源码后先按这个模块地图去看代码会比从头到尾瞎翻效率高得多。2. 核心技术点与项目结构解析2.1 项目目录结构一览拿到源代码后第一步不是急着点运行而是先把目录结构看明白。这套项目采用标准的 Maven 结构核心代码在src/main/java下按包名分层资源文件在src/main/resources下。src/main/java/com/example/delivery ├── common/ # 公共类统一返回结果、常量、异常处理 ├── config/ # 配置类拦截器、跨域配置、WebMvc 配置 ├── controller/ # 控制层接收请求、返回视图或数据 ├── service/ # 业务层核心业务逻辑 │ └── impl/ # 业务实现类 ├── mapper/ # MyBatis 数据访问层接口 ├── entity/ # 实体类对应数据库表 ├── dto/ # 数据传输对象 └── DeliveryApplication.java # Spring Boot 启动类resources 目录下则是application.yml配置文件、mapper/MyBatis XML 文件和static/或templates/前端静态资源或模板页面。2.2 数据库表设计思路数据库表设计是整个外卖系统最核心的部分也是面试官喜欢追问的内容。这套项目的表结构不算多但表之间的关系设计值得细细品味。主要包含以下表表名用途核心字段user用户表id, username, password, phone, address, rolebusiness商家表id, name, phone, address, statusdish菜品表id, business_id, name, price, description, statuscart_item购物车表id, user_id, dish_id, quantityorders订单表id, order_no, user_id, business_id, total_amount, status, create_timeorder_item订单明细表id, order_id, dish_id, quantity, price这里有个容易踩的坑很多初学者会把订单里的菜品信息直接设计成几个字段存进订单表比如dish_names、dish_prices。这种设计在演示阶段看不出问题但一旦需要改价或统计销量就会乱套。正确做法是拆出订单明细表订单只存总金额和状态明细表记录每一道菜的单价和数量。这套源码用的就是标准的订单加明细方案写论文的时候也可以强调这一点。2.3 核心流程用户下单的完整链路整个系统最值得捋清楚的一条线就是用户从登录到下单的完整请求链。理解了这条链路套餐里所有模块的代码就串起来了。用户点击“提交订单”后前端把地址和备注传给后端订单 Controller 接收到请求后先调用购物车 Service 获取当前用户购物车里的所有菜品接着计算总金额生成唯一的订单编号把订单主表和明细表的数据插入数据库这里必须放在一个事务里保证不出现订单已创建但明细缺失的情况最后清空购物车把订单对象返回给前端。这套流程代码上不复杂但需要注意几个细节。第一是事务注解的使用下单方法必须加Transactional否则中途报错会导致数据不一致。第二是金额计算应该在后端完成不能信任前端传过来的总价因为请求可以被篡改。第三是订单编号的生成规则这套源码用的是时间戳加随机数的组合量小够用量大则需要更严谨的分布式 ID 方案。3. 实操过程与核心环节实现3.1 环境准备JDK、Maven、MySQL 的版本搭配这里要说一个真实的痛点很多人项目跑不起来不是代码的问题而是环境版本不匹配。Spring Boot 的版本和 JDK、MySQL 驱动之间是有对应关系的版本太高或太低都会导致各种怪异报错。我自己的建议组合是JDK 1.8 Maven 3.6.3 Spring Boot 2.7.x MySQL 8.0。这套组合网上资料最多踩坑教程最齐全对新手最友好。不要一上来就追新直接上 Spring Boot 3.x那玩意要求 JDK 17很多学校的机房电脑还没装而且javax.servlet变成了jakarta.servlet老代码会大面积报错。MySQL 安装完成之后记得用客户端工具Navicat、DataGrip 或者命令行执行项目里提供的delivery.sql脚本初始化数据库和表数据。不要省略这一步直接启动项目否则会因为找不到表而报一堆红色异常。3.2 application.yml 核心配置解读配置是 Spring Boot 项目的命门。这套源码的application.yml配置并不复杂但每一项都值得弄清楚含义server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/delivery?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 thymeleaf: cache: false mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.delivery.entity这里最容易被忽略的是 URL 里那一长串参数。useSSLfalse是关闭 SSL 连接避免本地环境下的证书警告serverTimezoneAsia/Shanghai是设定时区不写的话会报 CST 和 UTC 的时间差错误characterEncodingutf-8解决中文乱码问题。这三个参数少一个运行阶段都可能出现莫名其妙的 bug。3.3 核心代码下单接口的完整实现下面看一段下单接口的核心代码这是理解整套系统运行逻辑的关键入口PostMapping(/order/submit) Transactional public ResultString submit(RequestBody OrderSubmitDTO dto) { // 1. 获取当前登录用户的 ID从 session 中取 Long userId (Long) session.getAttribute(userId); if (userId null) { return Result.error(请先登录); } // 2. 查询购物车中该用户的全部菜品 ListCartItem cartList cartMapper.selectByUserId(userId); if (cartList null || cartList.isEmpty()) { return Result.error(购物车不能为空); } // 3. 计算总金额同时构造订单明细列表 BigDecimal totalAmount new BigDecimal(0); ListOrderItem orderItemList new ArrayList(); for (CartItem cartItem : cartList) { Dish dish dishMapper.selectById(cartItem.getDishId()); if (dish null || dish.getStatus() 0) { return Result.error(部分菜品已下架请重新确认); } BigDecimal itemAmount dish.getPrice().multiply(new BigDecimal(cartItem.getQuantity())); totalAmount totalAmount.add(itemAmount); OrderItem orderItem new OrderItem(); orderItem.setDishId(dish.getId()); orderItem.setQuantity(cartItem.getQuantity()); orderItem.setPrice(dish.getPrice()); orderItemList.add(orderItem); } // 4. 生成订单号并插入订单主表 String orderNo generateOrderNo(); Orders order new Orders(); order.setOrderNo(orderNo); order.setUserId(userId); order.setTotalAmount(totalAmount); order.setStatus(1); // 1 表示待接单 order.setCreateTime(new Date()); orderMapper.insert(order); // 5. 批量插入订单明细 orderItemMapper.batchInsert(order.getId(), orderItemList); // 6. 清空购物车 cartMapper.deleteByUserId(userId); return Result.success(orderNo); }简单解释几个关键点。第一步从 session 获取用户 ID说明这个项目的登录状态是放在服务端 session 里的这是单体应用常用的方式代码简单但注意要搭配拦截器做登录校验。第三步为什么要重新查一遍菜品价格因为购物车表里可能存的是加购当时的价格如果后来商家改了价用户结算时应该按最新价格走。这个细节体现了真实业务中的一致性考虑面试时能主动聊出来会很加分。3.4 手动实现拦截器做登录校验Spring Boot 开发时很多人图省事在每个 Controller 里都写一遍“是否已登录”的判断代码冗余不说漏写一个就是安全漏洞。这套源码用的是拦截器方案统一处理登录校验。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口 String uri request.getRequestURI(); if (uri.contains(/login) || uri.contains(/register)) { return true; } Object userId request.getSession().getAttribute(userId); if (userId null) { response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } return true; } }然后在配置类里注册拦截器指定拦截路径Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns(/login, /register, /dish/**, /business/**); } }这样业务接口里就不再需要写登录判断了拦截器统一拦截代码干净很多。要注意的是放行路径要仔细配置比如首页展示菜品列表和商家列表的接口必须放行否则用户没登录连菜品都看不见这就不符合真实外卖平台的交互逻辑了。4. 常见问题与排查技巧实录4.1 端口被占用Web server failed to start这是新手遇到最多的报错之一。尤其是电脑上装了多个 Java 服务或者之前启动过没关掉8080 端口就容易被占。Description: Web server failed to start. Port 8080 was already in use.解决办法有三种。第一种是找到占用进程并杀掉Windows 下执行netstat -ano | findstr 8080拿到 PID然后taskkill /PID xxx /FMac/Linux 下用lsof -i:8080拿到进程号后kill -9。第二种是直接换端口修改application.yml里的server.port。第三种最省事把服务停掉比如强制退出 IDE 里之前运行的实例。4.2 时区问题Cannot create PoolableConnectionFactory这个报错的具体提示是The server time zone value is unrecognized or represents more than one time zone核心原因就是 MySQL 连接 URL 里没有设置时区。解决办法是在 datasource 的 url 后面加上serverTimezoneAsia/Shanghai。如果你用的是 MySQL 5.x驱动类名要写com.mysql.jdbc.Driver如果用 MySQL 8.0驱动类名必须是com.mysql.cj.jdbc.Driver。这个区别很多人不注意导致导入项目后一启动就报“ClassNotFound”。4.3 MyBatis 绑定异常Invalid bound statement这个报错说明 Mapper 接口和 XML 文件没有正确关联。通常有三种原因一是 XML 文件没有放在resources/mapper目录下二是 XML 里的 namespace 没有写对三是application.yml里的mapper-locations配置缺失。检查方法很简单看 XML 文件的 namespace 是否等于 Mapper 接口的全限定名比如com.example.delivery.mapper.UserMapper看 XML 中的 id 是否等于接口方法名看 target/classes 目录下有没有把 XML 编译过去。平时用 IDEA 的话还要确认 resources 文件有没有被标记为资源根目录。4.4 常见问题速查表问题现象可能原因解决办法启动时报数据库连接失败MySQL 未启动/密码错误/表未初始化启动 MySQL、检查账号密码、执行 sql 初始化脚本中文乱码数据库编码不是 utf8或连接参数没配建库时指定 utf8mb4url 加 characterEncodingutf-8登录后访问接口返回 401拦截器配置过严session 失效检查拦截器 excludePathPatterns确认请求携带 sessionId菜品列表图片加载不出来图片路径是绝对路径或未做静态资源映射用相对路径或配置 WebMvc 映射/upload/**到本地目录购物车或订单数据错乱多用户之间用了同一个 userId 缓存确认登录后 session 中存入的是当前用户 ID4.5 有一个坑很多人没意识到注意前端请求的跨域问题如果你是前后端分离开发前端跑在 5173 端口后端跑在 8080 端口直接请求会报跨域错误。这套源代码里 WebConfig 配置了跨域支持但如果你自己写项目忘了这步就会卡在浏览器控制台的红字上。registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowCredentials(true) .maxAge(3600);注意allowedOriginPatterns和allowedOrigins的区别如果开启了allowCredentials(true)allowedOrigins不能写*必须用allowedOriginPatterns指定否则部分浏览器会直接拒绝请求。这个细节很小但排查起来很浪费时间。5. 项目部署与扩展建议5.1 将项目打包发布到服务器本地跑通只是第一步真正完整的学习流程还包括部署。Spring Boot 项目有一个天然优势可以打成可执行 jar 包在服务器上一条命令启动。mvn clean package -DskipTests java -jar target/delivery-0.0.1-SNAPSHOT.jar如果服务器也装了 MySQL把本地导出的delivery.sql导入到服务器的数据库再修改打包前application.yml里的数据库地址和密码其他地方基本不用动。这套源码在本地开发和服务器部署的环境差异很小移植成本低这也是它适合练手的另一个原因。5.2 还能再扩展哪些功能如果你做完这个项目觉得意犹未尽想进一步提升可以按以下顺序加功能加入 Redis 缓存菜品信息降低数据库查询压力使用 JWT 替换 Session 登录机制实现无状态认证增加商家端订单状态流转的可视化控制比如接单、制作、配送、完成引入 Spring Security 做基于角色的权限控制加入支付模块的模拟对接支付宝沙箱或微信支付沙箱前后端分离改造前端用 Vue 3 Element Plus 重写每加一个功能都会迫使你去学习一个新的技术栈。建议每次只加一个改完跑通再动下一个不要一次性想把所有功能都怼上去否则出了 bug 都不知道从哪里查。我自己的习惯是在学习阶段给这类项目单独建一个 Git 仓库每完成一个功能就提交一次看提交历史就能直观地看到项目是怎么一步步长大成型的。这种管理方式也方便你在面试前快速回顾自己写过的东西。最后说一个实际体会做这类管理系统真正的难点从来不是某一个技术点而是把所有简单功能串起来之后如何保证数据准确、流程顺畅、代码不被乱成一团。把这套源码吃透你会发现 Spring Boot 的开发模式、MyBatis 的 CRUD 操作、MySQL 的表关系设计这些东西一下就通了。后续再去学更复杂的分布式项目底子就是从这里打起来的。本文还有配套的精品资源点击获取