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

简介基于JSPServlet实现的外卖订餐系统实战项目完整涵盖会员、骑手、商家、管理员四类角色采用MVC模式与MySQL存储适合需要课程设计、毕业设计案例或系统学习Java Web开发的读者。压缩包共93.63MB内含可导入Eclipse运行的完整源代码、MySQL初始化脚本、账号配置说明、界面截图及wmv操作演示视频配置好数据库即可快速启动。系统业务覆盖浏览菜单、下单支付、订单分配、骑手配送、商家商品管理、后台监控等全流程代码分层清楚便于揣摩JSP与Servlet的协作方式、前后端数据流转以及多角色权限控制的落地细节。已有660人学习下载既可作为入门实践也可在此基础上二次开发对掌握MVC思想、MySQL操作和Java Web项目部署有明显助益。1. 这份 JSPServlet 外卖订餐系统源码四个角色的完整业务闭环值不值得花时间跑起来第一次在压缩包里看到这套基于 JSPServlet 开发的外卖订餐系统大多数人会下意识先找视频教程但我建议你先打开源码里的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 这些框架是纯粹的 JSPServletJDBC 组合。在 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/ 下的页面只允许 rolemember 的用户访问 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 为准但表之间的关联关系基本上逃不开下面的设计逻辑数据块核心表关键字段关联关系用户体系user / member / seller / riderid、username、password、role、phone、address按角色拆表或用 role 字段区分商品管理food / menuid、seller_id、name、price、image、statusseller_id 关联商家表购物车cartid、user_id、food_id、quantity下单前置数据订单主表ordersid、order_no、user_id、seller_id、rider_id、total_price、status、create_time同时关联会员、商家、骑手订单明细order_itemid、order_id、food_id、quantity、price与订单主表是一对多关系物流状态delivery / order_statusid、order_id、rider_id、status、update_time跟踪骑手配送轨迹理解这套结构的关键在于订单表是连接四个角色业务的中枢。会员下单时往 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.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/online_food?characterEncodingutf8 jdbc.usernameroot jdbc.password123456这段配置需要注意两个参数。第一个是driver如果你用的是 MySQL 8.0 以上的驱动版本驱动类名已经不是com.mysql.jdbc.Driver而是com.mysql.cj.jdbc.Driver第二个是 URL 里的characterEncodingutf8不加这个参数很容易出现中文乱码后面避坑章节会细说。MySQL 8 还要在 URL 里追加时区参数serverTimezoneAsia/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 版本。这套 JSPServlet 项目建议用 Tomcat 8.5 或 Tomcat 9注意 Tomcat 10 及以上换了包名会把javax.servlet改成jakarta.servlet旧源码在 Tomcat 10 上基本都会编译失败。配置好运行时后右键项目Run As - Run on ServerEclipse 就把项目部署到 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 contentTypetext/html;charsetUTF-8 %这行写全第二所有 ServletdoPost的最前面加一行request.setCharacterEncoding(UTF-8)第三MySQL 连接串里加characterEncodingutf8。三步做完乱码问题基本根治。我见过很多人只改数据库连接串结果请求解码还是 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.DriverURL 追加serverTimezoneAsia/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 的改动量不大却能让整个项目的订单逻辑清晰一个档次。希望帮到你。本文还有配套的精品资源点击获取