简介这是一套基于JavaWeb技术实现的外卖点餐系统完整项目源码面向具备Java基础、希望深入理解Web全栈开发的学生与开发者可用于课程设计、毕业设计或自学练手。系统采用MVC架构涵盖Servlet与JSP、JDBC、JSTL/EL等技术并涉及用户管理、菜品管理、订单处理、支付接口与地图API等核心模块帮助读者掌握前后端交互与数据库设计的完整流程。压缩包共252个文件约22.35MB包含16个java源文件、10个jsp页面、31个js脚本、9个css样式及39个jar依赖另有大量gif、jpg、png等图片资源与字体文件结构完整、开箱即用。目前已有583人学习下载适合作为JavaWeb入门到进阶的实战参考通过阅读源码可快速理解企业级订餐系统的实现思路与项目组织方式。1. 拿到「基于javaweb的外卖点餐系统.zip」先别急着解压这套东西到底能帮你解决什么很多人第一次拿到「基于javaweb的外卖点餐系统.zip」这种压缩包第一反应是双击解压、丢进 IDEA、点运行然后被一堆 404、ClassNotFound、数据库连不上劝退。我当年也是这样一个下午耗在环境上最后连登录页都没打开。其实这套系统的价值不在于「跑起来看个界面」而在于它是一份完整的、能拆开看的 JavaWeb 全栈练习样本Servlet 怎么接请求、JSP 怎么渲染、JDBC 怎么连 MySQL、购物车和订单状态怎么流转全都在里面。它适合三类人正在学 JavaWeb 想找一个完整案例练手的在校生需要快速搭一个点餐类 Demo 做课程设计或接私活的开发者以及想回头补一补「不用 Spring 全家桶、纯原生 Servlet 怎么写业务」的老手。这篇笔记不讲空话就按「环境怎么配 → 数据库怎么建 → 代码怎么跑通 → 坑在哪」这条线把一套外卖点餐系统从压缩包跑到能下单的全过程讲清楚参数和命令都给到能直接抄的程度。2. 跑通前的环境准备IDEA 配置、Tomcat 版本与 MySQL 连接三件事2.1 为什么这类项目在 IDEA 里最容易卡在「找不到 Web 模块」原生 JavaWeb 项目和现在的 Spring Boot 项目最大的区别是它没有内嵌服务器依赖一个外部的 Servlet 容器通常是 Tomcat而且目录结构是src/main/webapp这种老式布局。IDEA 打开压缩包解压后的目录时如果没识别成 Web 项目你会看到webapp文件夹是灰色的右键也没有「Run on Tomcat」的选项。这不是代码问题是 IDEA 的模块识别问题。常见做法是先确认项目根目录下有没有pom.xml。有的话按 Maven 项目导入IDEA 会自动识别webapp没有的话就是纯 Eclipse 结构的动态 Web 项目需要手动在Project Structure → Modules里给它加一个 Web Facet把webapp目录指定为 Web 资源目录WEB-INF/web.xml指定为部署描述符。这一步不做后面所有运行配置都是空中楼阁。Tomcat 版本是第二个大坑。JavaWeb 项目里如果用了javax.servlet.*包那对应的是 Tomcat 9 及以下如果代码里是jakarta.servlet.*那必须用 Tomcat 10 及以上。这两个包名不兼容选错了启动就报ClassNotFoundException: javax.servlet.http.HttpServlet。我一般先打开一个 Servlet 文件看 import 的是哪个包再决定下哪个版本的 Tomcat别凭感觉。2.2 用 IDEA 配置 Tomcat 运行环境的最小步骤假设你已经确认是javax.servlet包、准备用 Tomcat 9。下面是从零到能启动的配置流程每一步都对应 IDEA 里的一个具体位置。# 第一步确认 JDK 版本JavaWeb 老项目一般用 JDK 8 java -version # 输出里看到 1.8.x 就对了如果是 17、21 可能编译报错 # 第二步确认 MySQL 服务在跑端口默认 3306 mysql -u root -p -e SELECT VERSION(); # 能返回版本号说明数据库没问题IDEA 内操作无代码按位置走 1. File → Project Structure → ProjectSDK 选 1.8Language level 选 8 2. Project Structure → Modules → 选中模块 → Sources确认 src 是 Sources 根 3. 同一面板 → Facets → 加一个 Web → Deployment Descriptor 指向 web.xmlWeb Resource Directory 指向 webapp 4. Run → Edit Configurations → → Tomcat Server → Local 5. Server 标签页Application server 选本地 Tomcat 9 目录HTTP port 保持 8080 6. Deployment 标签页 → Artifact → 选 xxx:war explodedApplication context 设成 /waimai配置逻辑说明第 3 步的 Facet 是让 IDEA 知道「这是个 Web 项目」第 6 步的war exploded是热部署模式改 JSP 不用重启。Application context设成/waimai之后访问地址就是http://localhost:8080/waimai/这个前缀要和后面 JSP 里写的路径对得上否则会出现页面能打开但静态资源全 404 的情况。参数上唯一需要留意的是端口。8080 被占用是高频事件改HTTP port为 8081 即可但改完记得同步改代码里可能硬编码的localhost:8080。JDK 版本如果项目里用了 Java 8 的 lambda 或 Stream就必须锁 8用高版本 JDK 编译有时能过但运行期反射相关的代码容易出玄学问题。2.3 数据库连接配置从 db.properties 到 JDBC 驱动版本外卖点餐系统的数据层基本都是 JDBC 直连配置文件通常叫db.properties或jdbc.properties放在src目录下。打开它你会看到 url、username、password、driver 四个键。这里最容易翻车的是驱动类名和 URL 参数。# db.properties 典型内容 jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/waimai?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码逻辑说明com.mysql.cj.jdbc.Driver是 MySQL 8 的驱动类MySQL 5 用的是com.mysql.jdbc.Driver。URL 里serverTimezone不写MySQL 8 会报时区错误useSSLfalse不写控制台会刷一堆警告。characterEncodingutf8保证中文菜名不乱码。这几个参数少一个都可能让你在「登录成功但菜单全是问号」这种问题上卡半天。驱动 jar 包要放进webapp/WEB-INF/lib目录并且确认它被加进了 Artifact 的依赖里。IDEA 里如果只把 jar 拖进项目但没在Project Structure → Artifacts里勾选运行时照样ClassNotFoundException。我一般直接看WEB-INF/lib下有没有mysql-connector-java-8.x.x.jar有就稳一半。3. 数据库建表与初始化数据外卖点餐系统的表结构怎么读3.1 从 sql 文件还原表结构用户、菜品、订单三张核心表压缩包里通常会带一个.sql文件这是整个系统的数据骨架。外卖点餐系统的表设计万变不离其宗核心就三块用户表管登录和权限菜品表管菜单展示订单表管下单和状态流转。先把库建出来再谈代码。-- 建库字符集必须 utf8mb4否则 emoji 和部分中文会挂 CREATE DATABASE waimai DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE waimai; -- 用户表区分普通用户和管理员 CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role TINYINT DEFAULT 0 COMMENT 0普通用户 1管理员, phone VARCHAR(20), address VARCHAR(255) ); -- 菜品表分类 价格 图片 CREATE TABLE dish ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, price DECIMAL(10,2) NOT NULL, category VARCHAR(50), image VARCHAR(255), stock INT DEFAULT 100 ); -- 订单表状态字段是业务核心 CREATE TABLE orders ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT, total DECIMAL(10,2), status TINYINT DEFAULT 0 COMMENT 0待支付 1已支付 2配送中 3已完成, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES user(id) );逻辑说明role字段决定了登录后跳转到用户端还是管理端这是很多点餐系统的权限分水岭。orders.status用数字表示订单状态前端根据这个值渲染不同的按钮和文案改状态就是改这一个字段。dish.stock是库存下单时要做扣减这里如果不加事务并发下会超卖后面避坑章节会细说。参数上DECIMAL(10,2)用于金额别用FLOAT浮点误差会让 19.9 变成 19.899999。utf8mb4而不是utf8是因为 MySQL 的utf8其实是三字节的存不下某些字符。外键约束建议保留它能帮你早发现「订单里的 user_id 对不上」这类脏数据。3.2 初始化数据怎么导避免中文乱码和自增 ID 冲突建完表要导初始数据通常是管理员账号和一批菜品。导入方式有两种命令行source和图形工具执行。命令行更快但要注意编码。# 方式一命令行导入先指定编码 mysql -u root -p --default-character-setutf8mb4 waimai init_data.sql # 方式二进入 mysql 后 source mysql -u root -p USE waimai; SET NAMES utf8mb4; SOURCE /path/to/init_data.sql;逻辑说明--default-character-setutf8mb4是命令行导入不乱码的关键不加的话 Windows 下经常导进去一堆问号。SET NAMES utf8mb4是会话级设置影响当前连接。如果导入后SELECT * FROM dish看到菜名是乱码先别改代码先确认这两处编码。自增 ID 冲突是另一个常见问题如果你反复导入带INSERT INTO user (id, ...) VALUES (1, ...)的脚本第二次就会报主键重复。解决办法是脚本里不写死 id让数据库自增或者导入前先TRUNCATE TABLE。我一般建议初始化脚本里显式写 id方便和代码里的测试数据对应但导入前清库。4. 核心业务代码怎么读Servlet 请求流转与购物车逻辑4.1 一个下单请求从浏览器到数据库经历了什么外卖点餐系统的业务主线是「浏览菜品 → 加入购物车 → 提交订单 → 生成订单记录」。这条线在原生 JavaWeb 里是靠 Servlet Session JDBC 串起来的。理解这条链路比死记某个类的写法有用得多。用户在菜单页点「加入购物车」前端发一个请求到CartServlet?actionadddishId3。Servlet 的doGet或doPost里根据action参数分发到不同方法从 Session 里取出购物车对象没有就新建把菜品加进去然后重定向回菜单页。提交订单时OrderServlet从 Session 拿到购物车遍历生成订单明细写orders表和order_item表清空购物车跳转到订单列表。// CartServlet 里加入购物车的核心逻辑简化 protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { String action req.getParameter(action); HttpSession session req.getSession(); // 购物车用 Map 存key 是菜品 idvalue 是数量 MapInteger, Integer cart (MapInteger, Integer) session.getAttribute(cart); if (cart null) { cart new HashMap(); session.setAttribute(cart, cart); } if (add.equals(action)) { int dishId Integer.parseInt(req.getParameter(dishId)); cart.put(dishId, cart.getOrDefault(dishId, 0) 1); } else if (remove.equals(action)) { int dishId Integer.parseInt(req.getParameter(dishId)); cart.remove(dishId); } resp.sendRedirect(menu.jsp); }逻辑说明session.getAttribute(cart)是购物车的存储位置用 Session 意味着购物车和登录用户绑定关浏览器会话结束就没了这是原生 JavaWeb 的典型做法。getOrDefault(dishId, 0) 1是数量累加第一次加返回 1再加返回 2。sendRedirect而不是forward是为了避免用户刷新页面重复提交。参数上action是分发开关值要和前端 URL 里写的一致。dishId要做空值和数字校验否则用户手动改 URL 传个字母进来parseInt直接抛异常页面 500。生产级代码这里要 try-catch 并给友好提示练习项目里至少要知道这个风险点在哪。4.2 订单状态流转与库存扣减的事务边界下单不只是插一条订单记录它涉及三件事写订单主表、写订单明细、扣菜品库存。这三步必须在一个事务里否则会出现「订单生成了但库存没扣」或者「库存扣了订单没生成」的脏数据。// 下单核心手动管理 JDBC 事务 Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 关闭自动提交开启事务 // 1. 插入订单主表拿到自增 id PreparedStatement ps1 conn.prepareStatement( INSERT INTO orders(user_id, total, status) VALUES (?, ?, 0), Statement.RETURN_GENERATED_KEYS); ps1.setInt(1, userId); ps1.setBigDecimal(2, total); ps1.executeUpdate(); ResultSet rs ps1.getGeneratedKeys(); rs.next(); int orderId rs.getInt(1); // 2. 遍历购物车插明细 扣库存 for (Map.EntryInteger, Integer e : cart.entrySet()) { PreparedStatement ps2 conn.prepareStatement( INSERT INTO order_item(order_id, dish_id, num) VALUES (?, ?, ?)); ps2.setInt(1, orderId); ps2.setInt(2, e.getKey()); ps2.setInt(3, e.getValue()); ps2.executeUpdate(); PreparedStatement ps3 conn.prepareStatement( UPDATE dish SET stock stock - ? WHERE id ? AND stock ?); ps3.setInt(1, e.getValue()); ps3.setInt(2, e.getKey()); ps3.setInt(3, e.getValue()); if (ps3.executeUpdate() 0) { throw new RuntimeException(库存不足: e.getKey()); } } conn.commit(); // 全部成功才提交 } catch (Exception ex) { if (conn ! null) conn.rollback(); // 任何一步失败全回滚 throw new RuntimeException(ex); } finally { DBUtil.close(conn); }逻辑说明setAutoCommit(false)是事务的起点之后所有 SQL 都在同一个事务里。RETURN_GENERATED_KEYS让插入订单后能拿到自增主键用于关联明细。扣库存的 SQL 里AND stock ?是关键它保证库存不足时executeUpdate返回 0我们主动抛异常触发回滚避免超卖。commit只在全部成功后调用rollback在 catch 里兜底。参数上total用BigDecimal而不是double和数据库的DECIMAL对应。库存扣减的WHERE条件里带上数量比较是防超卖的核心比先查再改的写法安全。这套逻辑在单机下够用高并发下还需要乐观锁或队列但作为练习项目理解事务边界比追求极致性能更重要。5. 避坑与排查跑这套外卖点餐系统最常见的 5 个翻车现场5.1 现象启动报 404浏览器显示「源服务器未能找到目标资源的表示」原因Application context配错了或者访问路径没带上下文。比如 IDEA 里设的是/waimai你却访问http://localhost:8080/。另一种情况是web.xml里welcome-file指向的页面不存在Tomcat 找不到默认首页。解决先确认 IDEA Deployment 里的 Application context再确认访问 URL 带了这个前缀。然后检查webapp下有没有index.jsp或login.jspweb.xml里的welcome-file-list是否和实际文件名一致。三者对齐404 基本消失。5.2 现象登录页能打开点登录报ClassNotFoundException: com.mysql.cj.jdbc.Driver原因MySQL 驱动 jar 没放进WEB-INF/lib或者放了但没被 Artifact 打包。IDEA 里项目依赖和运行时依赖是两回事只在Libraries里加了不算数。解决把mysql-connector-java-8.x.x.jar复制到webapp/WEB-INF/lib然后Project Structure → Artifacts → 选中 war exploded → 右侧 Available Elements 里确认这个 jar 在 WEB-INF/lib 下。重启 Tomcat问题解决。5.3 现象菜单页中文全是问号数据库里查却是正常的原因JSP 页面没声明编码或者请求/响应编码没设。Tomcat 默认用 ISO-8859-1 解析参数中文就乱了。解决每个 JSP 顶部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %。Servlet 里在doGet/doPost开头加req.setCharacterEncoding(UTF-8)和resp.setContentType(text/html;charsetUTF-8)。数据库连接 URL 里已经有characterEncodingutf8三处一致就不会乱码。5.4 现象下单后订单列表为空但数据库里明明有记录原因查询订单的 SQL 用了WHERE user_id ?但 Session 里的用户对象取出来是 null或者取的是id字段但存进去的是username。字段对不上查出来自然是空。解决在 Servlet 里打印session.getAttribute(user)看是不是 null再确认登录时存进 Session 的是完整 User 对象还是只存了用户名。订单查询的user_id要和登录用户的id对应别用用户名去查 int 字段。5.5 现象改了 JSP 或 Java 代码刷新页面没变化原因war exploded模式下 JSP 改动一般能热生效但 Java 代码改动需要重新编译并重启。如果 IDEA 没开自动编译改了等于没改。解决Settings → Build → Compiler → 勾选 Build project automatically。Java 代码改完按CtrlF9重新构建再重启 Tomcat。JSP 改完直接刷新即可。如果还是不行检查是不是浏览器缓存CtrlShiftR强制刷新。6. 把这套系统改造成你自己的三个能立刻上手的进阶技巧跑通只是起点真正让这套外卖点餐系统产生价值的是改造它。第一个技巧是给菜品列表加分页。原生 JavaWeb 里分页靠LIMIT加两个参数页码和每页条数。在DishServlet里接收page参数默认 1SQL 写成SELECT * FROM dish LIMIT ?, ?偏移量是(page-1)*size。再查一次SELECT COUNT(*) FROM dish算总页数传给 JSP 渲染上一页/下一页。这个改动不大但能让你的项目从「Demo」变成「能装数据的产品」。第二个技巧是把购物车从 Session 迁到数据库。Session 购物车关浏览器就丢用户体验差。建一张cart表字段user_id、dish_id、num加购时INSERT ... ON DUPLICATE KEY UPDATE num num 1这样换设备登录购物车还在。迁移时注意加唯一索引(user_id, dish_id)否则同一个菜会插多条。第三个技巧是给订单状态加一个定时任务。待支付订单超过 30 分钟自动取消并回滚库存这是外卖系统的标配。原生 JavaWeb 里可以用ServletContextListener启动一个ScheduledExecutorService每 5 分钟扫一次orders表里status0 AND create_time NOW() - INTERVAL 30 MINUTE的记录逐条回滚库存并改状态。代码不复杂但涉及并发和事务建议先在测试库跑通再上。改造点涉及文件难度收益菜品分页DishServlet、menu.jsp低支持大数据量展示购物车入库CartServlet、新建 cart 表中跨设备同步订单超时取消新建监听器、OrderService中高业务闭环完整最后说个我自己的习惯每次改完一个功能先在数据库里手动造几条边界数据——库存为 0 的菜、金额为 0 的订单、用户名为空的账号——看系统会不会崩。这套外卖点餐系统里很多 bug 不是正常流程能测出来的都是边界值逼出来的。我踩过最狠的一次是库存扣成负数订单还能提交后来加了stock ?才堵住。希望你少走这段弯路把这套系统真正跑成自己的东西。本文还有配套的精品资源点击获取