JSP+Servlet外卖订餐系统源码解析：架构设计、数据库与部署避坑指南

简介：基于JSP+Servlet实现的外卖订餐系统实战项目，完整涵盖会员、骑手、商家、管理员四类角色，采用MVC模式与MySQL存储，适合需要课程设计、毕业设计案例或系统学习Java Web开发的读者。压缩包共93.63MB，内含可导入Eclipse运行的完整源代码、MySQL初始化脚本、账号配置说明、界面截图及wmv操作演示视频，配置好数据库即可快速启动。系统业务覆盖浏览菜单、下单支付、订单分配、骑手配送、商家商品管理、后台监控等全流程，代码分层清楚，便于揣摩JSP与Servlet的协作方式、前后端数据流转以及多角色权限控制的落地细节。已有660人学习下载，既可作为入门实践，也可在此基础上二次开发，对掌握MVC思想、MySQL操作和Java Web项目部署有明显助益。

1. 这份 JSP+Servlet 外卖订餐系统源码：四个角色的完整业务闭环，值不值得花时间跑起来

第一次在压缩包里看到这套基于 JSP+Servlet 开发的外卖订餐系统，大多数人会下意识先找视频教程，但我建议你先打开源码里的online.sql和WebContent/WEB-INF/web.xml。这个项目最值钱的不是能跑起来的外卖 demo，而是一条完整的 Java Web 业务链路：会员下单、商家接单、骑手配送、管理员监控，四条线全部落在同一个 Servlet 容器里，MVC 分层与 Session 权限控制都是教科书级的典型写法。对刚从 Spring Boot 转回来看 JSP 的人，它是理解"Servlet 如何扛住整个应用入口"的绝佳样本；对正在找毕业设计或课设参考的初学者，它把数据库建模、后端逻辑、页面展示和部署运行全部串在了一起。本文直接拆源码、拆数据库、拆部署流程，把能直接抄作业的部分和最容易翻车的位置一次讲完。

2. 系统架构与角色权限：MVC 分层和 Session 控制是这个项目的骨架

2.1 JSP 与 Servlet 的职责边界：MVC 分层在这个项目里怎么落地

这套系统没有用 Spring、Spring Boot 这些框架，是纯粹的 JSP+Servlet+JDBC 组合。在 Eclipse 里导入源码后，你会看到包结构非常清晰：实体类放在 entity 包，数据库操作集中在 dao 或者 util 包，Servlet 单独一个包，JSP 页面按角色拆到不同目录。这正是 MVC 模式的落地方式。

Servlet 在这里承担 Controller 职责，接收来自浏览器的 HTTP 请求，解析表单参数，调用 DAO 层完成数据读写，最后通过request.getRequestDispatcher().forward()把请求转发到 JSP 页面。JSP 只负责 View 部分的展示，理论上不应该出现 JDBC 代码和业务逻辑。但很多初学项目最后都写成了"面条代码"——JSP 里直接连数据库、直接在页面里拼 HTML，这正是 MVC 分层没做好的典型症状。

我一般会先用一个登录场景把链路讲清楚。会员在login.jsp输入账号密码，表单提交到LoginServlet，它从HttpServletRequest里拿到参数，调用 UserDao 去查库，比对密码成功后把用户对象放进 Session，再根据角色重定向到不同主页。整个过程里 Servlet 负责调度，DAO 只干数据库查询，JSP 只渲染结果。代码逻辑大致是这样：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding("UTF-8"); String username = request.getParameter("username"); String password = request.getParameter("password"); UserDao dao = new UserDao(); User user = dao.findByUsernameAndPassword(username, password); if (user != null) { HttpSession session = request.getSession(); session.setAttribute("loginUser", user); // 按角色分派到不同页面 if ("member".equals(user.getRole())) { response.sendRedirect("member/index.jsp"); } else if ("seller".equals(user.getRole())) { response.sendRedirect("seller/manage.jsp"); } else if ("rider".equals(user.getRole())) { response.sendRedirect("rider/task.jsp"); } else { response.sendRedirect("admin/index.jsp"); } } else { request.setAttribute("msg", "用户名或密码错误"); request.getRequestDispatcher("login.jsp").forward(request, response); } }

这段代码有几点值得注意。第一是URL 可扩展性，四个角色用同一个登录入口，靠role字段区分，新增角色不需要改 Servlet 本身；第二是Session 传递方式，登录成功后的用户对象是整个会话的信息中枢，后面每个页面判断权限都从这里取；第三是转发与重定向的选择，登录失败用 forward 保留 request 里的错误提示，登录成功用 sendRedirect 防止表单重复提交。这套写法在 JSP 老项目里非常通用，学会了看其他 Servlet 项目基本无障碍。

这里的 UserDao 是典型的 JDBC 封装，内部通过DriverManager.getConnection(url, user, password)拿连接，执行PreparedStatement防止 SQL 注入。项目里常见的实现方式是把数据库连接参数单独放到一个 properties 文件里，不硬编码在类里，这样换数据库环境时不用重新编译。

2.2 四类角色的权限拦截：Session 里存什么、Filter 拦哪些路径

四角色系统最核心的一个设计问题：会员、骑手、商家、管理员各自能访问哪些页面？如果只做登录跳转而不做权限拦截，会员完全可以绕开页面直接访问管理员的 URL，这种情况在课设项目里非常常见，也是最容易被答辩老师问住的地方。

这个项目的处理方式是典型的Session + Filter 组合拦截。登录成功时把用户对象放进 Session，然后写一个权限过滤器，拦截所有需要登录才能访问的路径。常见的路径规划是：/member/*会员专区、/seller/*商家后台、/rider/*骑手端、/admin/*管理后台。Filter 做的事情就三行关键逻辑：取 Session 里的用户对象，为空就踢回登录页，不为空就校验角色是否匹配当前 URL 前缀。

public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; HttpServletResponse response = (HttpServletResponse) resp; HttpSession session = request.getSession(false); User user = session == null ? null : (User) session.getAttribute("loginUser"); String path = request.getServletPath(); if (user == null) { response.sendRedirect(request.getContextPath() + "/login.jsp"); return; } // /member/ 下的页面只允许 role=member 的用户访问 String role = user.getRole(); if (path.startsWith("/member/") && !"member".equals(role)) { response.sendError(HttpServletResponse.SC_FORBIDDEN); return; } // seller、rider、admin 同理 chain.doFilter(request, response); }

这段代码在 web.xml 里配置<filter-mapping>时，通常会把/member/*、/seller/*、/rider/*、/admin/*这几个路径都挂上过滤器。细节在于request.getSession(false)里的参数false——如果 Session 不存在，直接返回 null，省得为了拦截请求还白白创建一个 Session。很多新手在这里写成getSession(true)，等于每一次被拦截的请求都会产生一个 Session 对象，这纯属浪费内存。

权限拦截之外还有一个容易忽略的点：页面资源的物理隔离。JSP 页面直接放在对应的角色目录下，例如member目录只有会员相关页面，admin目录只有管理后台页面，这种目录约定加上 Filter 拦截，双保险避免越权访问。这个设计虽然简单，但对课设答辩和实际项目都有参考价值。你拿到源码后，可以先看看 web.xml 里的 filter-mapping 配了哪些路径，基本就能反推出项目的整个权限模型。

3. 数据库设计：online.sql 里的表结构和初始化数据怎么用

3.1 核心表拆解：从 online.sql 逆向读懂数据关系

online.sql是这个项目的数据库基础，里面既包含建表语句也包含初始化数据。导入之后你就拥有了一套可以直接跑通的外卖系统数据。很多初学者拿到 SQL 文件的第一反应是直接执行，然后开始运行项目，但我觉得花十分钟读一遍表结构，比直接跑起来收获大得多。

这套外卖系统在数据层面大概会拆成这么几块：用户相关表、商品表、订单表和配送相关表。虽然具体表名要以你解压的 SQL 为准，但表之间的关联关系基本上逃不开下面的设计逻辑：

理解这套结构的关键在于订单表是连接四个角色业务的中枢。会员下单时往 orders 里插入一条记录，并往 order_item 里插入多条商品明细；商家后台查询订单时按 seller_id 过滤出自己店铺的订单；骑手端按 rider_id 查自己名下的配送单；管理员统计所有订单的数据。一张订单表贯穿着四类用户的操作路径。

我在看 SQL 文件时习惯先搜CREATE TABLE关键字，把所有表名列出来，再理解外键关系。这个项目因为是课设级别，大概率没有用物理外键，而是靠 Java 代码维护关联逻辑，所以你在 SQL 里可能看不到FOREIGN KEY约束，但表字段的命名仍然遵循xxx_id的规范。这一点对新手反而不友好——数据库层没有约束，代码里一疏忽就会出现孤儿数据，所以阅读时要特别留意 DAO 层查询语句里的 JOIN 和 WHERE 条件。

3.2 导入 online.sql 的完整步骤与 JDBC 连接配置

拿到 SQL 文件后，导入数据库是最基础也最容易出差错的一步。常见的有三种方式：命令行导入、Navicat 可视化导入、Eclipse 里直接运行 SQL 脚本。考虑到很多人用 Navicat，这里两个方法都写。

命令行方式是通用的，进入 MySQL 的 bin 目录后执行：

mysql -u root -p < online.sql

这个命令会按顺序执行 SQL 里的建库、建表和插入语句。前提是 SQL 文件里已经包含CREATE DATABASE或者你已经手动创建了一个数据库。如果 SQL 文件里有USE xxx;语句，会自动切换到对应库。执行完可以进入 MySQL 检查：

mysql -u root -p show databases; use online_food; show tables;

如果show tables能看到多张表，说明导入成功。Navicat 的方式更直观：连接 MySQL 后右键点击连接，选择"运行 SQL 文件"，选中 online.sql 执行，执行日志里会显示每一步的状态。

SQL 导入成功之后，重点是改 JDBC 连接配置。旧式 JSP 项目一般会把数据库连接信息写在db.properties、jdbc.properties或者一个专门的 DBUtil 类里。找到类似这样的配置文件：

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/online_food?characterEncoding=utf8 jdbc.username=root jdbc.password=123456

这段配置需要注意两个参数。第一个是driver，如果你用的是 MySQL 8.0 以上的驱动版本，驱动类名已经不是com.mysql.jdbc.Driver而是com.mysql.cj.jdbc.Driver；第二个是 URL 里的characterEncoding=utf8，不加这个参数很容易出现中文乱码，后面避坑章节会细说。MySQL 8 还要在 URL 里追加时区参数serverTimezone=Asia/Shanghai，否则连接的时候会直接报时区异常。修改完配置文件后记得重新编译，Eclipse 默认会自动编译，但如果用的是外部 Tomcat 发布，需要确保 classes 目录下的配置文件被重新覆盖了。

4. 部署与运行：Eclipse + Tomcat + MySQL 从导入到启动

4.1 Eclipse 导入项目与包结构解读

部署这套项目，推荐使用 Eclipse IDE for Enterprise Java and Web Developers，普通 JavaSE 版本缺少 Web 工程能力，导入后很可能出现各种编译异常。拿到的源码是一个完整的 Eclipse 项目目录，里面包含.project和.classpath文件，导入时直接用老项目导入方式，不要用 Maven 或 Gradle 导入。

菜单路径是File -> Import -> Existing Projects into Workspace，然后选中源码所在的目录。导入后先别急着运行，检查一下项目是否有红叉。最常见的红叉原因是缺 Tomcat 运行环境依赖，因为项目核心依赖是 Servlet API，这个 API 并不在 JDK 里，而是由 Tomcat 运行时提供。右键项目Build Path -> Configure Build Path -> Libraries，点Add Library -> Server Runtime -> Apache Tomcat v8.5，没有报错后红叉就会消失。

接下来看一下 WebContent 目录的结构。这个目录是 Web 应用的根目录，WEB-INF下面有web.xml和lib文件夹，lib里应该已经有 MySQL 驱动包mysql-connector-java，没有的话要自己放一个。JSP 页面在 WebContent 下按角色拆成多个子目录，比如member、seller、rider、admin。这种组织方式有一个好处，你在配置权限拦截时直接按目录前缀写 URL 即可，浏览器访问路径和物理磁盘路径一一对应。

4.2 Tomcat 配置与启动流程

用 Eclipse 内嵌的 Server 运行项目，需要先配置一个 Tomcat 运行时。菜单Window -> Preferences -> Server -> Runtime Environments，点 Add，选择你本机安装的 Tomcat 版本。这套 JSP+Servlet 项目建议用 Tomcat 8.5 或 Tomcat 9（注意 Tomcat 10 及以上换了包名，会把javax.servlet改成jakarta.servlet，旧源码在 Tomcat 10 上基本都会编译失败）。

配置好运行时后，右键项目Run As -> Run on Server，Eclipse 就把项目部署到 Tomcat 的 webapps 目录并启动。这里有一个非常容易让人困惑的点：Eclipse 默认部署的路径并不是 Tomcat 安装目录下的 webapps，而是 Eclipse 工作空间里的.metadata/.plugins/org.eclipse.wst.server.core/tmp0/wtpwebapps。如果你发现改了代码但访问的还是旧页面，通常就是部署目录搞混了。

启动成功后，浏览器访问地址由两部分决定：Tomcat 端口和项目上下文路径。Tomcat 默认 8080，项目上下文名通常就是项目名，访问路径类似http://localhost:8080/OnlineFood/login.jsp。如果你改了项目名，上下文路径会跟着变，具体可以在WebContent/WEB-INF/web.xml或 Server 配置里查看。项目自带的视频教程里应该能看到启动后的完整演示过程。顺序点一次：数据库导入 -> 改 JDBC 连接 -> 配置 Tomcat -> Run on Server -> 浏览器访问。

4.3 用帐号.txt 和截图核对四类角色的入口

解压包里有一个帐号.txt，这个文件往往是整个项目最容易被人忽略、却最省时间的文件。里面写着系统初始化的测试账号，对应四个角色的登录凭证。如果你不想在每个数据库表里翻初始数据，登录测试阶段直接按这个文件里的账号输就行。视频教程里登录验证用的也是这批账号。

登录后要逐角色验证功能链路。会员入口应该能浏览商品、加入购物车、提交订单、查看历史订单；商家入口能看到自己店铺的订单列表，能修改商品上下架状态；骑手入口能看到待配送订单，点击接单或更新配送状态；管理员入口能查看所有用户、商品、订单的数据统计。截图文件夹里的图片就是这套流程的预期结果，对照截图能快速确认自己的环境是否跑对了。

我实际操作时有个习惯：跑通一个主流程后，立刻把整套项目的 jsp 登录入口、ConnectionUtil 配置、web.xml 的 servlet-mapping 都在浏览器里过一遍。这套源码里的 servlet-mapping 一般会占到 web.xml 大半篇幅，你可以留意那些没有在页面上暴露的路径，比如/AdminUserServlet、/UpdateOrderStatusServlet，它们对应管理后台的隐藏操作，理解了这些路径，整个项目的设计就通了。

5. 常见问题与避坑：部署 JSP 老项目最容易翻车的五个点

5.1 导入后项目红叉，编译不过

现象：源码导入 Eclipse 后，项目名旁边一个红叉，代码里提示The superclass javax.servlet.http.HttpServlet was not found on the Java Build Path。

原因：项目依赖的 Servlet API 来自 Tomcat 运行时，Eclipse 没配 Tomcat 服务器环境，或者项目 Build Path 里没把这个运行时加进去。

解决：右键项目 ->Build Path -> Configure Build Path -> Libraries，点Add Library -> Server Runtime，勾选你配置好的 Tomcat v8.5。没有的话先到Window -> Preferences -> Server -> Runtime Environments里加。加上后红叉基本能消掉，如果还有 Java 版本报错，Project -> Properties -> Java Compiler把编译级别切到 JDK 1.8，老项目很少用到高版本特性。

5.2 表单提交中文乱码

现象：会员注册或修改个人资料时，输入框里的中文传回后台变成??或者乱码，数据库里存的也是乱码。

原因：JSP 页面编码、Servlet 的请求编码、数据库连接 URL 编码三者不一致。老项目里 JSP 很可能是GBK而数据库连接串是UTF-8，或者反过来。浏览器发送请求时若没有指定字符集，Tomcat 默认按ISO-8859-1解码，中文不出乱码才奇怪。

解决：三步统一。第一，JSP 页面<%@ page contentType="text/html;charset=UTF-8" %>这行写全；第二，所有 ServletdoPost的最前面加一行request.setCharacterEncoding("UTF-8")；第三，MySQL 连接串里加characterEncoding=utf8。三步做完，乱码问题基本根治。我见过很多人只改数据库连接串，结果请求解码还是 ISO-8859-1，依然是乱码，因为问题出在 Tomcat 请求参数读取环节。

5.3 提示 ClassNotFoundException 或时区异常

现象：启动 Tomcat 后访问页面，页面报 500，后台日志里有ClassNotFoundException: com.mysql.jdbc.Driver，或者The server time zone value is unrecognized。

原因：项目 lib 目录下的 MySQL 驱动包是 5.x 版本，驱动类名是com.mysql.jdbc.Driver；如果你换了 MySQL 8.x 但没换驱动包，或者反过来，驱动类名和数据库版本不匹配。MySQL 8 的驱动要求 URL 后面带serverTimezone。

解决：根据你本机 MySQL 版本选择驱动包。MySQL 8 用mysql-connector-java-8.0.x.jar，配置写成com.mysql.cj.jdbc.Driver，URL 追加serverTimezone=Asia/Shanghai。MySQL 5.7 用 5.x 驱动包即可。换驱动包后记得刷新WebContent/WEB-INF/lib，并确认部署时已经同步到 Tomcat 的 lib 目录。

5.4 访问页面 404，项目没部署到正确目录

现象：Tomcat 正常启动，但访问http://localhost:8080/项目名/login.jsp返回 404，看 Eclipse 的 Servers 视图项目状态是"已启动"，但浏览器就是访问不到。

原因：Eclipse 默认把项目发布到wtpwebapps而不是 Tomcat 安装目录的webapps。如果你使用的是外部 Tomcat，在Servers视图里双击服务器，Server Locations选的是Use workspace metadata，部署路径就不是标准 webapps 目录。有强迫症的人去 Tomcat 安装目录找项目，当然找不到。

解决：双击 Servers 里的 Tomcat，打开配置页，把Server Locations改成Use Tomcat installation (takes control of Tomcat installation)，Deploy Path改成webapps。改的时候确保 Tomcat 停止运行，否则选项灰掉改不了。改完后重新启动，再去 Tomcat 安装目录的 webapps 就能看到项目了。

5.5 端口被占用，Tomcat 起不来

现象：启动 Tomcat 时控制台报错Port 8080 required by Tomcat v8.5 Server at localhost is already in use。有些新手电脑同时装了多个版本的 Tomcat 服务，或者之前杀死 javaw.exe 时没杀干净，8080 就被人占了。

解决：先找出谁占用了端口。Windows 下命令行执行：

netstat -ano | findstr 8080 taskkill /PID 你的进程号 /F

进程号就是 findstr 结果里最后一列的数字。如果是其他开发工具自带的进程，别强杀，直接改 Tomcat 端口省事。打开servers\Tomcat v8.5 Server at localhost-config\server.xml，把三个 Connector 端口改掉，比如 8080 改成 8088，然后重启。平时开发我习惯把端口改到 8088 或 9090，能避开一堆本地服务的冲突。

6. 给项目加订单状态流转：从下单到送达只需一个枚举

跑通这个项目后，如果你想让它看起来更像真实的外卖系统，最值得动手改的就是订单状态管理。原系统的订单状态大概率只是 orders 表里的一个字符串或数字字段，页面读取时固定做判断。状态多、逻辑乱，这是 JSP 老项目的通病。我的做法是加一个订单状态枚举，把所有合法的状态迁移集中在同一个文件里管理，再加一个更新状态用的通用 Servlet。

先定义状态枚举，把下单到送达的完整链路拆成五个阶段：

public enum OrderStatus { UNPAID(0, "待支付"), PAID(1, "已支付/备餐中"), DELIVERING(2, "配送中"), COMPLETED(3, "已送达"), CANCELLED(4, "已取消"); private int code; private String desc; OrderStatus(int code, String desc) { this.code = code; this.desc = desc; } public int getCode() { return code; } public String getDesc() { return desc; } }

然后在 Servlet 里接收两个参数：订单 id 和目标状态码，更新时校验一下当前状态能否迁移到目标状态，比如已取消的订单不能直接变成配送中。这套逻辑在真实系统里叫状态机，不校验的话，数据库里的订单状态就乱了。

从那以后我每次接手同学的 JSP 项目或课设源码，都会强制自己先做一件事：把订单相关的字段和状态流转画成一张表，写在纸上或者写在代码注释里，再开始动 Servlet。状态不明确的代码，看着能用，第二个人接手就是黑匣子，改一处分分钟牵连到前台展示。这个经验也建议你验证完这套项目后随手实践一下，状态枚举加通用更新 Servlet 的改动量不大，却能让整个项目的订单逻辑清晰一个档次。希望帮到你。

本文还有配套的精品资源，点击获取