简介这是一套面向Java毕业设计、课程设计与期末大作业场景的完整外卖点餐系统源码包基于SpringBoot技术栈开发适合具备一定Java Web基础、需要独立完成项目实战的学生与开发者参考学习。资源共包含639个文件以121个java源码、79个vue组件、72个html页面、64个js脚本及84张jpg、75张gif等图片素材为主另含sql建库脚本、xml配置、docx开发说明与pptx答辩文档压缩包约27.9MB。系统采用前后端分离模式覆盖用户浏览菜单、购物车、订单提交、支付处理、库存管理等核心流程并涉及Spring Security安全框架与Spring Data JPA数据访问层的应用。配套文档系统阐述了环境搭建、依赖管理、项目配置与业务逻辑处理要点2万字参考论文则提供需求分析与行业背景支撑。已有28人学习源码注释完整便于运行调试与二次开发对同类项目设计具有参考价值。1. 从一份外卖点餐系统源码说起这套 SpringBoot 项目到底能跑通什么如果你正在为毕业设计或者期末大作业找一个能直接跑起来、结构完整、还能讲清楚技术点的项目那这套基于 SpringBoot 的外卖点餐系统值得花时间拆一遍。它不是那种只有增删改查的玩具 Demo而是把菜品管理、订单流转、购物车、用户下单、后台接单这条完整链路都串起来了。拿到手之后你面对的是一个标准的 SpringBoot 单体应用配合 MyBatis 做持久层前端大概率是 Thymeleaf 或者前后端分离的 Vue 页面数据库用 MySQL。适合谁适合那些不想从零搭架子、但又需要理解每一层在干什么的开发者。你不需要是 SpringBoot 老手但至少得知道 Controller、Service、Mapper 这三层大概是怎么回事否则跑起来也改不动。这套东西最大的价值在于它把外卖业务里最核心的状态流转——从浏览菜品到下单再到订单状态变更——用代码写清楚了你照着改改就能变成自己的东西。2. 环境搭建与数据库初始化把项目从压缩包变成能访问的页面2.1 先确认版本别让 JDK 和 SpringBoot 打架拿到压缩包解压之后第一件事不是急着点运行而是看pom.xml里的 SpringBoot 版本和 JDK 版本要求。常见的情况是项目用 SpringBoot 2.7.x 配 JDK 8 或者 JDK 11如果你本地装的是 JDK 17 甚至更高启动时大概率会报Unsupported class file major version或者NoSuchMethodError。我一般会先打开pom.xml看parent里的版本号再确认java.version属性。如果项目写的是 1.8而你只有 JDK 17最省事的做法是装一个 JDK 8 或者 JDK 11 并在 IDEA 里把项目 SDK 切过去而不是硬改 pom 去适配高版本——改依赖版本引发的连锁报错对新手来说就是黑匣子。!-- pom.xml 里重点看这几行 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version !-- 版本号决定 JDK 下限 -- /parent properties java.version1.8/java.version !-- 这里写 1.8 就别用 JDK 17 跑 -- /properties上面这段配置说明项目是基于 SpringBoot 2.7.18 构建的这个版本官方推荐 JDK 8 或 JDK 11。java.version设为 1.8 意味着编译目标也是 1.8用高版本 JDK 编译虽然能过但运行时容易出兼容问题。参数上你需要注意如果本地 Maven 的settings.xml配了阿里云镜像依赖下载会快很多如果没有第一次mvn clean install可能要等很久别以为是卡死了。2.2 建库、导数据、改连接串三步不能少数据库这块项目一般会附带一个.sql文件里面是建表语句和初始数据。常见做法是先用 Navicat 或者命令行创建一个空库字符集选utf8mb4排序规则选utf8mb4_general_ci然后把 sql 文件导进去。导完之后去application.yml或者application.properties里改数据库连接信息。这里有个血泪经验很多人只改了 url 里的库名忘了改用户名和密码启动时报Access denied for user然后开始怀疑人生。其实就看一眼配置文件的事。# application.yml 里数据库配置段 spring: datasource: url: jdbc:mysql://localhost:3306/waimai?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/Shanghai username: root password: your_password # 改成你本地 MySQL 的密码 driver-class-name: com.mysql.cj.jdbc.Driver这段配置里serverTimezoneAsia/Shanghai很关键不写的话 MySQL 8 以上版本会报时区错误。characterEncodingutf-8保证中文菜品名不会乱码。改完这些在 IDEA 里点启动类的绿色三角控制台看到Started Application in x.x seconds就算成功了。如果报Table waimai.xxx doesnt exist说明 sql 没导全或者导到了别的库里回去检查库名和表数量。2.3 前端页面放在哪静态资源怎么映射如果项目是 Thymeleaf 模板页面文件通常在src/main/resources/templates下静态的 css、js、图片在src/main/resources/static下。启动之后访问http://localhost:8080或者http://localhost:8080/login就能看到页面。如果是前后端分离的结构前端代码可能在另一个文件夹里需要单独npm install和npm run serve然后改前端请求的后端地址。这一步的坑在于前端请求的端口和后端不一致浏览器控制台报CORS跨域错误。解决办法是在后端加一个全局跨域配置类或者用 Nginx 做代理。对于毕设场景我一般建议直接在后端加配置省得折腾。// 全局跨域配置放在 config 包下 Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true) .maxAge(3600); } }这个配置类的作用是允许所有来源的请求跨域访问后端接口。allowedOriginPatterns(*)在 SpringBoot 2.4 以上版本替代了allowedOrigins(*)因为后者和allowCredentials(true)一起用会报错。maxAge(3600)表示预检请求的结果缓存一小时减少重复的 OPTIONS 请求。加上这个之后前端如果还报跨域就要检查请求地址是不是写成了localhost而前端跑在127.0.0.1浏览器会认为是不同源。3. 核心业务链路拆解从购物车到订单状态流转的代码实现3.1 购物车的数据结构设计为什么不用 Session 存打开购物车相关的 Service 代码你会发现购物车数据大概率是存在数据库表里的而不是放在 Session 里。常见的设计是一张cart表字段包括用户 id、菜品 id、数量、加入时间。为什么不用 Session因为 Session 在服务重启后就没了而且如果以后要做多端同步或者分布式部署Session 方案直接翻车。用数据库存虽然多了一次读写但数据持久化、可查询、可统计对毕设来说也更方便展示“我做了完整的数据流”。购物车的核心操作就三个添加、修改数量、删除。添加的时候要先查一下这个用户是不是已经加过这个菜品加过就更新数量没加过就插入新记录。// CartService 中添加购物车的逻辑 public void addToCart(Long userId, Long dishId, Integer quantity) { Cart existing cartMapper.selectByUserAndDish(userId, dishId); if (existing ! null) { // 已经存在则累加数量 existing.setQuantity(existing.getQuantity() quantity); cartMapper.updateById(existing); } else { Cart cart new Cart(); cart.setUserId(userId); cart.setDishId(dishId); cart.setQuantity(quantity); cart.setCreateTime(new Date()); cartMapper.insert(cart); } }这段代码的关键在于selectByUserAndDish这个查询它需要根据用户 id 和菜品 id 联合查询。对应的 SQL 在 Mapper XML 里大概是select * from cart where user_id #{userId} and dish_id #{dishId}。参数说明userId从登录用户的 Session 或者 Token 里取dishId从前端传过来quantity默认是 1。注意这里没有做并发控制如果同一个用户快速点两次添加可能会插入两条记录。毕设场景下这个问题不明显但如果要较真可以在数据库加唯一索引unique key (user_id, dish_id)然后代码里用insert on duplicate key update来处理。3.2 订单创建与状态机下单那一刻发生了什么订单模块是整个系统里逻辑最密集的地方。用户点“去结算”之后后端要做的事情包括校验购物车是否为空、计算总价、生成订单主记录、把购物车里的每一项拆成订单详情记录、清空购物车、返回订单号。这一串操作必须在一个事务里完成否则会出现订单生成了但购物车没清空、或者订单详情缺了几条的情况。常见做法是在 Service 方法上加Transactional注解。订单状态一般用数字或者枚举表示待支付、已支付、配送中、已完成、已取消。状态流转的代码通常写在 Controller 或者 Service 里根据前端传过来的操作类型去更新order表的status字段。// OrderService 创建订单的核心逻辑 Transactional public Order createOrder(Long userId) { ListCart cartList cartMapper.selectByUserId(userId); if (cartList.isEmpty()) { throw new RuntimeException(购物车为空无法下单); } BigDecimal total BigDecimal.ZERO; for (Cart cart : cartList) { Dish dish dishMapper.selectById(cart.getDishId()); total total.add(dish.getPrice().multiply(new BigDecimal(cart.getQuantity()))); } Order order new Order(); order.setUserId(userId); order.setTotalAmount(total); order.setStatus(0); // 0 表示待支付 order.setCreateTime(new Date()); orderMapper.insert(order); for (Cart cart : cartList) { OrderDetail detail new OrderDetail(); detail.setOrderId(order.getId()); detail.setDishId(cart.getDishId()); detail.setQuantity(cart.getQuantity()); orderDetailMapper.insert(detail); } cartMapper.deleteByUserId(userId); return order; }这段代码里Transactional保证了要么全部成功要么全部回滚。total的计算用了BigDecimal而不是double因为金额计算用浮点数会出现精度问题比如 0.1 0.2 不等于 0.3。订单状态status设为 0 表示待支付后续支付成功后更新为 1。参数上需要注意的是order.getId()在插入之后才能拿到这要求 MyBatis 配置了useGeneratedKeystrue和keyPropertyid否则订单详情里的orderId会是 null。这个坑很常见现象是订单主表有记录但详情表查不到原因就是主键没回填。3.3 菜品分类与分页查询MyBatis 分页插件的用法菜品列表页通常需要按分类筛选并且支持分页。如果项目里用了 PageHelper 这个 MyBatis 分页插件代码会简洁很多。常见写法是在查询之前调用PageHelper.startPage(pageNum, pageSize)紧接着执行 Mapper 的查询方法返回的 List 会被自动包装成PageInfo对象。这里有个容易翻车的地方startPage之后必须紧跟查询语句中间不能插入其他数据库操作否则分页参数会作用到错误的查询上。另外如果项目没有引入 PageHelper而是手写limit语句那就要注意offset的计算是(pageNum - 1) * pageSize别写错了。// DishService 分页查询菜品 public PageInfoDish getDishByPage(int pageNum, int pageSize, Long categoryId) { PageHelper.startPage(pageNum, pageSize); ListDish list dishMapper.selectByCategory(categoryId); return new PageInfo(list); }这段代码里PageHelper.startPage会拦截紧接着的第一条 SQL自动加上limit子句。PageInfo封装了总记录数、总页数、当前页数据等信息前端可以直接用。参数说明pageNum从 1 开始pageSize一般设 10 或者 20。如果查询结果为空PageInfo的total会是 0前端要处理空列表的展示。注意 PageHelper 的版本要和 MyBatis 版本匹配版本不兼容时会报ClassNotFoundException或者分页失效现象是查出来的数据没有 limit 限制全量返回。4. 避坑与排查跑这套外卖系统时最容易翻车的五个地方4.1 启动报数据库连接失败但密码明明是对的现象是控制台抛Communications link failure或者Access denied for user rootlocalhost。原因通常有三个MySQL 服务没启动、端口不是默认的 3306、或者配置文件里的密码有空格。解决方法是先用命令行mysql -u root -p手动连一下确认能连上再去看配置文件。如果 MySQL 是 8.0 以上还要确认driver-class-name写的是com.mysql.cj.jdbc.Driver而不是旧的com.mysql.jdbc.Driver后者在新版本里已经废弃了。4.2 页面能打开但接口返回 404现象是浏览器访问http://localhost:8080/login正常但登录请求发出去之后返回 404。原因一般是 Controller 类上的RequestMapping路径和前端请求的路径对不上或者项目配置了server.servlet.context-path而前端没加这个前缀。解决方法是打开浏览器开发者工具的 Network 面板看请求的实际 URL 是什么然后去后端 Controller 里核对。如果是 context-path 的问题要么前端统一加前缀要么把 context-path 去掉。4.3 订单详情表没有数据但订单主表有记录现象是下单之后查数据库order表有数据order_detail表是空的。原因几乎可以确定是 MyBatis 插入主表之后没有把自增主键回填到实体对象里导致order.getId()拿到的是 null后续插入详情时orderId字段为 null 被数据库拒绝或者插入了脏数据。解决方法是在 Mapper XML 的 insert 语句上加useGeneratedKeystrue keyPropertyid或者在实体类的主键字段上加GeneratedValue注解。4.4 中文菜品名显示成问号现象是数据库里存的中文在页面上显示为???或者乱码。原因是数据库连接串没有指定字符集或者建库的时候字符集不是utf8mb4。解决方法是检查application.yml里的 url 是否带了characterEncodingutf-8以及建库语句是不是CREATE DATABASE waimai DEFAULT CHARACTER SET utf8mb4。如果数据已经乱码了改完配置之后需要重新导入 sql 文件因为已经存进去的乱码数据不会自动恢复。4.5 修改代码后重启不生效现象是改了 Java 代码或者页面文件重启项目之后发现还是旧的效果。原因可能是 IDEA 的编译输出目录没有更新或者浏览器缓存了旧的静态资源。解决方法是先执行mvn clean再重新编译浏览器那边按Ctrl F5强制刷新。如果用的是 Thymeleaf 模板还要确认spring.thymeleaf.cache是不是设成了false开发阶段关掉缓存能省很多时间。5. 二次开发与进阶技巧把这套系统改成你自己的毕设5.1 换掉业务外壳保留技术骨架这套系统的技术骨架是 SpringBoot MyBatis MySQL 前端模板这个组合本身就是一个合格的毕设技术栈。如果你想把它改成别的题目比如“校园食堂点餐系统”或者“奶茶店点单系统”最省力的做法不是重写代码而是改数据库表里的字段名和页面上的文案。比如把dish表改成drink表把“菜品分类”改成“饮品分类”把“购物车”改成“点单栏”。代码层面的 Service 和 Controller 几乎不用动因为业务逻辑是一样的。我一般会先把所有页面上的中文文案搜一遍统一替换然后再去改数据库表名和实体类名。这样改完之后查重的时候至少看起来是一个新项目。5.2 加一个简单的数据统计页面毕设答辩的时候老师很喜欢问“你这个系统有什么数据分析功能”。与其被问住不如提前加一个统计页面。最简单的做法是在后台管理里加一个接口统计今日订单数、总销售额、菜品销量排行。SQL 写起来不复杂比如今日订单数就是select count(*) from order where date(create_time) curdate()销售额就是select sum(total_amount) from order where status 1。前端用 ECharts 画个柱状图或者饼图看起来就很完整。这个功能不需要多精确但能体现你对业务数据的理解。-- 菜品销量排行取前 10 SELECT d.name, SUM(od.quantity) AS total_sold FROM order_detail od JOIN dish d ON od.dish_id d.id JOIN order o ON od.order_id o.id WHERE o.status 1 GROUP BY d.id, d.name ORDER BY total_sold DESC LIMIT 10;这条 SQL 关联了三张表order_detail拿到每个菜品的销售数量dish拿到菜品名称order用来过滤只统计已支付的订单。GROUP BY按菜品分组ORDER BY按销量降序LIMIT 10取前十。参数上注意order是 MySQL 的关键字所以要用反引号包起来否则会报语法错误。这个查询在数据量大的时候会慢但毕设演示的数据量完全够用。5.3 用 Postman 把接口过一遍比点页面靠谱页面操作有时候会掩盖接口的问题比如前端做了参数校验后端其实没校验。我习惯在项目跑起来之后用 Postman 把核心接口挨个调一遍登录、获取菜品列表、加购物车、下单、查订单。这样能发现一些页面上看不出来的问题比如接口返回的 JSON 字段名和前端预期不一致、或者某个接口没有做登录拦截不带 token 也能访问。如果发现接口没有鉴权可以在后端加一个拦截器检查请求头里有没有 token没有就返回 401。这个改动不大但能让系统看起来更正规。// 简单的登录拦截器 public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(token); if (token null || token.isEmpty()) { response.setStatus(401); return false; } return true; } }这个拦截器的作用是检查请求头里有没有token没有就直接返回 401 状态码不继续执行 Controller。注册拦截器的时候要排除登录接口和静态资源路径否则登录页面都打不开。参数上token的具体校验逻辑可以很简单比如只是判断非空毕设场景下不需要真的去解析 JWT。从那以后我每次拿到别人的项目都会先用 Postman 把接口过一遍再去看页面这样能少走很多弯路。希望帮到你。本文还有配套的精品资源点击获取
SpringBoot外卖点餐系统源码解析：从环境搭建到订单状态流转的完整实战
简介这是一套面向Java毕业设计、课程设计与期末大作业场景的完整外卖点餐系统源码包基于SpringBoot技术栈开发适合具备一定Java Web基础、需要独立完成项目实战的学生与开发者参考学习。资源共包含639个文件以121个java源码、79个vue组件、72个html页面、64个js脚本及84张jpg、75张gif等图片素材为主另含sql建库脚本、xml配置、docx开发说明与pptx答辩文档压缩包约27.9MB。系统采用前后端分离模式覆盖用户浏览菜单、购物车、订单提交、支付处理、库存管理等核心流程并涉及Spring Security安全框架与Spring Data JPA数据访问层的应用。配套文档系统阐述了环境搭建、依赖管理、项目配置与业务逻辑处理要点2万字参考论文则提供需求分析与行业背景支撑。已有28人学习源码注释完整便于运行调试与二次开发对同类项目设计具有参考价值。1. 从一份外卖点餐系统源码说起这套 SpringBoot 项目到底能跑通什么如果你正在为毕业设计或者期末大作业找一个能直接跑起来、结构完整、还能讲清楚技术点的项目那这套基于 SpringBoot 的外卖点餐系统值得花时间拆一遍。它不是那种只有增删改查的玩具 Demo而是把菜品管理、订单流转、购物车、用户下单、后台接单这条完整链路都串起来了。拿到手之后你面对的是一个标准的 SpringBoot 单体应用配合 MyBatis 做持久层前端大概率是 Thymeleaf 或者前后端分离的 Vue 页面数据库用 MySQL。适合谁适合那些不想从零搭架子、但又需要理解每一层在干什么的开发者。你不需要是 SpringBoot 老手但至少得知道 Controller、Service、Mapper 这三层大概是怎么回事否则跑起来也改不动。这套东西最大的价值在于它把外卖业务里最核心的状态流转——从浏览菜品到下单再到订单状态变更——用代码写清楚了你照着改改就能变成自己的东西。2. 环境搭建与数据库初始化把项目从压缩包变成能访问的页面2.1 先确认版本别让 JDK 和 SpringBoot 打架拿到压缩包解压之后第一件事不是急着点运行而是看pom.xml里的 SpringBoot 版本和 JDK 版本要求。常见的情况是项目用 SpringBoot 2.7.x 配 JDK 8 或者 JDK 11如果你本地装的是 JDK 17 甚至更高启动时大概率会报Unsupported class file major version或者NoSuchMethodError。我一般会先打开pom.xml看parent里的版本号再确认java.version属性。如果项目写的是 1.8而你只有 JDK 17最省事的做法是装一个 JDK 8 或者 JDK 11 并在 IDEA 里把项目 SDK 切过去而不是硬改 pom 去适配高版本——改依赖版本引发的连锁报错对新手来说就是黑匣子。!-- pom.xml 里重点看这几行 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version !-- 版本号决定 JDK 下限 -- /parent properties java.version1.8/java.version !-- 这里写 1.8 就别用 JDK 17 跑 -- /properties上面这段配置说明项目是基于 SpringBoot 2.7.18 构建的这个版本官方推荐 JDK 8 或 JDK 11。java.version设为 1.8 意味着编译目标也是 1.8用高版本 JDK 编译虽然能过但运行时容易出兼容问题。参数上你需要注意如果本地 Maven 的settings.xml配了阿里云镜像依赖下载会快很多如果没有第一次mvn clean install可能要等很久别以为是卡死了。2.2 建库、导数据、改连接串三步不能少数据库这块项目一般会附带一个.sql文件里面是建表语句和初始数据。常见做法是先用 Navicat 或者命令行创建一个空库字符集选utf8mb4排序规则选utf8mb4_general_ci然后把 sql 文件导进去。导完之后去application.yml或者application.properties里改数据库连接信息。这里有个血泪经验很多人只改了 url 里的库名忘了改用户名和密码启动时报Access denied for user然后开始怀疑人生。其实就看一眼配置文件的事。# application.yml 里数据库配置段 spring: datasource: url: jdbc:mysql://localhost:3306/waimai?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/Shanghai username: root password: your_password # 改成你本地 MySQL 的密码 driver-class-name: com.mysql.cj.jdbc.Driver这段配置里serverTimezoneAsia/Shanghai很关键不写的话 MySQL 8 以上版本会报时区错误。characterEncodingutf-8保证中文菜品名不会乱码。改完这些在 IDEA 里点启动类的绿色三角控制台看到Started Application in x.x seconds就算成功了。如果报Table waimai.xxx doesnt exist说明 sql 没导全或者导到了别的库里回去检查库名和表数量。2.3 前端页面放在哪静态资源怎么映射如果项目是 Thymeleaf 模板页面文件通常在src/main/resources/templates下静态的 css、js、图片在src/main/resources/static下。启动之后访问http://localhost:8080或者http://localhost:8080/login就能看到页面。如果是前后端分离的结构前端代码可能在另一个文件夹里需要单独npm install和npm run serve然后改前端请求的后端地址。这一步的坑在于前端请求的端口和后端不一致浏览器控制台报CORS跨域错误。解决办法是在后端加一个全局跨域配置类或者用 Nginx 做代理。对于毕设场景我一般建议直接在后端加配置省得折腾。// 全局跨域配置放在 config 包下 Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true) .maxAge(3600); } }这个配置类的作用是允许所有来源的请求跨域访问后端接口。allowedOriginPatterns(*)在 SpringBoot 2.4 以上版本替代了allowedOrigins(*)因为后者和allowCredentials(true)一起用会报错。maxAge(3600)表示预检请求的结果缓存一小时减少重复的 OPTIONS 请求。加上这个之后前端如果还报跨域就要检查请求地址是不是写成了localhost而前端跑在127.0.0.1浏览器会认为是不同源。3. 核心业务链路拆解从购物车到订单状态流转的代码实现3.1 购物车的数据结构设计为什么不用 Session 存打开购物车相关的 Service 代码你会发现购物车数据大概率是存在数据库表里的而不是放在 Session 里。常见的设计是一张cart表字段包括用户 id、菜品 id、数量、加入时间。为什么不用 Session因为 Session 在服务重启后就没了而且如果以后要做多端同步或者分布式部署Session 方案直接翻车。用数据库存虽然多了一次读写但数据持久化、可查询、可统计对毕设来说也更方便展示“我做了完整的数据流”。购物车的核心操作就三个添加、修改数量、删除。添加的时候要先查一下这个用户是不是已经加过这个菜品加过就更新数量没加过就插入新记录。// CartService 中添加购物车的逻辑 public void addToCart(Long userId, Long dishId, Integer quantity) { Cart existing cartMapper.selectByUserAndDish(userId, dishId); if (existing ! null) { // 已经存在则累加数量 existing.setQuantity(existing.getQuantity() quantity); cartMapper.updateById(existing); } else { Cart cart new Cart(); cart.setUserId(userId); cart.setDishId(dishId); cart.setQuantity(quantity); cart.setCreateTime(new Date()); cartMapper.insert(cart); } }这段代码的关键在于selectByUserAndDish这个查询它需要根据用户 id 和菜品 id 联合查询。对应的 SQL 在 Mapper XML 里大概是select * from cart where user_id #{userId} and dish_id #{dishId}。参数说明userId从登录用户的 Session 或者 Token 里取dishId从前端传过来quantity默认是 1。注意这里没有做并发控制如果同一个用户快速点两次添加可能会插入两条记录。毕设场景下这个问题不明显但如果要较真可以在数据库加唯一索引unique key (user_id, dish_id)然后代码里用insert on duplicate key update来处理。3.2 订单创建与状态机下单那一刻发生了什么订单模块是整个系统里逻辑最密集的地方。用户点“去结算”之后后端要做的事情包括校验购物车是否为空、计算总价、生成订单主记录、把购物车里的每一项拆成订单详情记录、清空购物车、返回订单号。这一串操作必须在一个事务里完成否则会出现订单生成了但购物车没清空、或者订单详情缺了几条的情况。常见做法是在 Service 方法上加Transactional注解。订单状态一般用数字或者枚举表示待支付、已支付、配送中、已完成、已取消。状态流转的代码通常写在 Controller 或者 Service 里根据前端传过来的操作类型去更新order表的status字段。// OrderService 创建订单的核心逻辑 Transactional public Order createOrder(Long userId) { ListCart cartList cartMapper.selectByUserId(userId); if (cartList.isEmpty()) { throw new RuntimeException(购物车为空无法下单); } BigDecimal total BigDecimal.ZERO; for (Cart cart : cartList) { Dish dish dishMapper.selectById(cart.getDishId()); total total.add(dish.getPrice().multiply(new BigDecimal(cart.getQuantity()))); } Order order new Order(); order.setUserId(userId); order.setTotalAmount(total); order.setStatus(0); // 0 表示待支付 order.setCreateTime(new Date()); orderMapper.insert(order); for (Cart cart : cartList) { OrderDetail detail new OrderDetail(); detail.setOrderId(order.getId()); detail.setDishId(cart.getDishId()); detail.setQuantity(cart.getQuantity()); orderDetailMapper.insert(detail); } cartMapper.deleteByUserId(userId); return order; }这段代码里Transactional保证了要么全部成功要么全部回滚。total的计算用了BigDecimal而不是double因为金额计算用浮点数会出现精度问题比如 0.1 0.2 不等于 0.3。订单状态status设为 0 表示待支付后续支付成功后更新为 1。参数上需要注意的是order.getId()在插入之后才能拿到这要求 MyBatis 配置了useGeneratedKeystrue和keyPropertyid否则订单详情里的orderId会是 null。这个坑很常见现象是订单主表有记录但详情表查不到原因就是主键没回填。3.3 菜品分类与分页查询MyBatis 分页插件的用法菜品列表页通常需要按分类筛选并且支持分页。如果项目里用了 PageHelper 这个 MyBatis 分页插件代码会简洁很多。常见写法是在查询之前调用PageHelper.startPage(pageNum, pageSize)紧接着执行 Mapper 的查询方法返回的 List 会被自动包装成PageInfo对象。这里有个容易翻车的地方startPage之后必须紧跟查询语句中间不能插入其他数据库操作否则分页参数会作用到错误的查询上。另外如果项目没有引入 PageHelper而是手写limit语句那就要注意offset的计算是(pageNum - 1) * pageSize别写错了。// DishService 分页查询菜品 public PageInfoDish getDishByPage(int pageNum, int pageSize, Long categoryId) { PageHelper.startPage(pageNum, pageSize); ListDish list dishMapper.selectByCategory(categoryId); return new PageInfo(list); }这段代码里PageHelper.startPage会拦截紧接着的第一条 SQL自动加上limit子句。PageInfo封装了总记录数、总页数、当前页数据等信息前端可以直接用。参数说明pageNum从 1 开始pageSize一般设 10 或者 20。如果查询结果为空PageInfo的total会是 0前端要处理空列表的展示。注意 PageHelper 的版本要和 MyBatis 版本匹配版本不兼容时会报ClassNotFoundException或者分页失效现象是查出来的数据没有 limit 限制全量返回。4. 避坑与排查跑这套外卖系统时最容易翻车的五个地方4.1 启动报数据库连接失败但密码明明是对的现象是控制台抛Communications link failure或者Access denied for user rootlocalhost。原因通常有三个MySQL 服务没启动、端口不是默认的 3306、或者配置文件里的密码有空格。解决方法是先用命令行mysql -u root -p手动连一下确认能连上再去看配置文件。如果 MySQL 是 8.0 以上还要确认driver-class-name写的是com.mysql.cj.jdbc.Driver而不是旧的com.mysql.jdbc.Driver后者在新版本里已经废弃了。4.2 页面能打开但接口返回 404现象是浏览器访问http://localhost:8080/login正常但登录请求发出去之后返回 404。原因一般是 Controller 类上的RequestMapping路径和前端请求的路径对不上或者项目配置了server.servlet.context-path而前端没加这个前缀。解决方法是打开浏览器开发者工具的 Network 面板看请求的实际 URL 是什么然后去后端 Controller 里核对。如果是 context-path 的问题要么前端统一加前缀要么把 context-path 去掉。4.3 订单详情表没有数据但订单主表有记录现象是下单之后查数据库order表有数据order_detail表是空的。原因几乎可以确定是 MyBatis 插入主表之后没有把自增主键回填到实体对象里导致order.getId()拿到的是 null后续插入详情时orderId字段为 null 被数据库拒绝或者插入了脏数据。解决方法是在 Mapper XML 的 insert 语句上加useGeneratedKeystrue keyPropertyid或者在实体类的主键字段上加GeneratedValue注解。4.4 中文菜品名显示成问号现象是数据库里存的中文在页面上显示为???或者乱码。原因是数据库连接串没有指定字符集或者建库的时候字符集不是utf8mb4。解决方法是检查application.yml里的 url 是否带了characterEncodingutf-8以及建库语句是不是CREATE DATABASE waimai DEFAULT CHARACTER SET utf8mb4。如果数据已经乱码了改完配置之后需要重新导入 sql 文件因为已经存进去的乱码数据不会自动恢复。4.5 修改代码后重启不生效现象是改了 Java 代码或者页面文件重启项目之后发现还是旧的效果。原因可能是 IDEA 的编译输出目录没有更新或者浏览器缓存了旧的静态资源。解决方法是先执行mvn clean再重新编译浏览器那边按Ctrl F5强制刷新。如果用的是 Thymeleaf 模板还要确认spring.thymeleaf.cache是不是设成了false开发阶段关掉缓存能省很多时间。5. 二次开发与进阶技巧把这套系统改成你自己的毕设5.1 换掉业务外壳保留技术骨架这套系统的技术骨架是 SpringBoot MyBatis MySQL 前端模板这个组合本身就是一个合格的毕设技术栈。如果你想把它改成别的题目比如“校园食堂点餐系统”或者“奶茶店点单系统”最省力的做法不是重写代码而是改数据库表里的字段名和页面上的文案。比如把dish表改成drink表把“菜品分类”改成“饮品分类”把“购物车”改成“点单栏”。代码层面的 Service 和 Controller 几乎不用动因为业务逻辑是一样的。我一般会先把所有页面上的中文文案搜一遍统一替换然后再去改数据库表名和实体类名。这样改完之后查重的时候至少看起来是一个新项目。5.2 加一个简单的数据统计页面毕设答辩的时候老师很喜欢问“你这个系统有什么数据分析功能”。与其被问住不如提前加一个统计页面。最简单的做法是在后台管理里加一个接口统计今日订单数、总销售额、菜品销量排行。SQL 写起来不复杂比如今日订单数就是select count(*) from order where date(create_time) curdate()销售额就是select sum(total_amount) from order where status 1。前端用 ECharts 画个柱状图或者饼图看起来就很完整。这个功能不需要多精确但能体现你对业务数据的理解。-- 菜品销量排行取前 10 SELECT d.name, SUM(od.quantity) AS total_sold FROM order_detail od JOIN dish d ON od.dish_id d.id JOIN order o ON od.order_id o.id WHERE o.status 1 GROUP BY d.id, d.name ORDER BY total_sold DESC LIMIT 10;这条 SQL 关联了三张表order_detail拿到每个菜品的销售数量dish拿到菜品名称order用来过滤只统计已支付的订单。GROUP BY按菜品分组ORDER BY按销量降序LIMIT 10取前十。参数上注意order是 MySQL 的关键字所以要用反引号包起来否则会报语法错误。这个查询在数据量大的时候会慢但毕设演示的数据量完全够用。5.3 用 Postman 把接口过一遍比点页面靠谱页面操作有时候会掩盖接口的问题比如前端做了参数校验后端其实没校验。我习惯在项目跑起来之后用 Postman 把核心接口挨个调一遍登录、获取菜品列表、加购物车、下单、查订单。这样能发现一些页面上看不出来的问题比如接口返回的 JSON 字段名和前端预期不一致、或者某个接口没有做登录拦截不带 token 也能访问。如果发现接口没有鉴权可以在后端加一个拦截器检查请求头里有没有 token没有就返回 401。这个改动不大但能让系统看起来更正规。// 简单的登录拦截器 public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(token); if (token null || token.isEmpty()) { response.setStatus(401); return false; } return true; } }这个拦截器的作用是检查请求头里有没有token没有就直接返回 401 状态码不继续执行 Controller。注册拦截器的时候要排除登录接口和静态资源路径否则登录页面都打不开。参数上token的具体校验逻辑可以很简单比如只是判断非空毕设场景下不需要真的去解析 JWT。从那以后我每次拿到别人的项目都会先用 Postman 把接口过一遍再去看页面这样能少走很多弯路。希望帮到你。本文还有配套的精品资源点击获取
