JSP+Servlet外卖系统四角色协同实战指南

简介这是一套基于Java Web技术栈开发的完整外卖订餐系统实战项目面向Java初学者与Web开发入门者解决多角色协同业务场景下的MVC架构实践问题。资源采用JSP实现视图展示、Servlet处理请求逻辑、MySQL存储用户、订单、商家等核心数据依托Eclipse开发环境覆盖会员下单、骑手接单配送、商家管理商品与订单、管理员全局监控四大功能模块。压缩包为ZIP格式大小93.63MB包含源代码、数据库脚本online.sql、系统截图及账号初始化说明等关键文件其中SQL文件用于快速构建数据库环境源码结构清晰体现Model-View-Controller分层设计。已有659人学习下载读者可直接导入Eclipse运行调试掌握JSP动态页面开发、Servlet请求响应机制、MySQL表关系设计及多角色权限控制等核心技能是理解传统Java Web企业级应用落地的典型范例。1. 这不是“又一个JSP毕设”它真能跑通四角色协同的外卖闭环且所有Servlet跳转链路可调试、MySQL表关系可追溯你手头这份基于JSPServlet开发外卖订餐点餐系统会员 骑手 商家 管理员.zip不是那种只在首页放个登录框、点进去就404的“教学演示包”。我拆开后第一件事是启动Tomcat——没改任何配置直接导入Eclipse连上MySQL 5.7五分钟后四个角色账号全登进去了会员下单、商家接单、骑手抢单、管理员看实时订单热力图。关键在于它的Servlet层没有用response.sendRedirect()硬跳转堆砌逻辑而是用RequestDispatcher.forward()做MVC内流转每个请求路径都对应明确的Controller类比如OrderServlet.java处理全部订单动作你能打断点、看request域里塞了什么、查session里存了哪个用户ID。它解决的不是“怎么写Hello World”而是“如何让四个角色在同一个数据库事务里不抢同一张订单”——比如当骑手点击“已取餐”时系统会先锁住该订单记录再更新状态扣减骑手积分触发短信模板三步原子性执行。适合刚学完Servlet生命周期、正卡在“为什么我的转发总丢参数”的JavaWeb新手也适合想快速搭一个可演示、可讲清楚权限隔离逻辑的毕设答辩者。别被标题里的“JSP”劝退——它恰恰是理解传统Java Web请求流最干净的入口没有Spring Boot自动装配黑匣子没有Thymeleaf语法糖干扰每一个% request.getAttribute(list) %背后都是你亲手写的DAO查出来的List 。2. 从零部署Eclipse Tomcat 9 MySQL 5.7 三件套实操指南2.1 环境版本对齐为什么必须用Tomcat 9而不是10这个项目源码里大量使用javax.servlet.*包如HttpServlet,HttpServletRequest而Tomcat 10默认启用Jakarta EE 9规范包名已改为jakarta.servlet.*。如果你强行用Tomcat 10编译时会报错The import javax.servlet cannot be resolved。血泪经验不要升级Tomcat也不要改源码包名——直接下载Tomcat 9.0.83官方归档页最新稳定版解压后在Eclipse中Window → Preferences → Server → Runtime Environments里添加它。验证方法右键项目 →Properties → Targeted Runtimes勾选你刚配的Tomcat 9此时项目图标左下角应出现小服务器图标且Problems视图无红叉。2.2 数据库初始化online.sql不是“一键导入就能用”online.sql文件看似简单但实际包含三类关键内容建库语句CREATE DATABASE IF NOT EXISTS online DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;建表外键约束比如orders表的user_id字段关联users表shop_id关联shops表rider_id关联riders表——这些外键保证了数据一致性但导入时若MySQL未开启FOREIGN_KEY_CHECKS1可能静默失败。初始账号数据INSERT INTO users (username, password, role) VALUES (admin, 123456, ADMIN);等语句注意密码是明文教学用途勿用于生产。提示导入前务必在MySQL命令行执行SET FOREIGN_KEY_CHECKS 1;否则外键约束不生效后续会出现“骑手接单后订单状态不更新”的玄学问题。执行步骤推荐用命令行避免Navicat等GUI工具编码错乱# 登录MySQL mysql -u root -p # 创建数据库utf8mb4确保emoji和中文不乱码 CREATE DATABASE online CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; # 退出后导入SQL mysql -u root -p online /path/to/online.sql2.3 Eclipse项目配置web.xml是Servlet路由的唯一真相项目根目录下的WebContent/WEB-INF/web.xml是整个请求分发的中枢。它定义了所有Servlet映射例如servlet servlet-nameLoginServlet/servlet-name servlet-classcom.servlet.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mapping这意味着当你访问http://localhost:8080/online/login时Tomcat会实例化com.servlet.LoginServlet并调用其doPost()方法。新手常犯错误是把JSP路径当成Servlet路径——比如以为/login.jsp会自动触发LoginServlet其实不会。所有业务逻辑必须走ServletJSP只是纯展示层。检查你的web.xml是否完整包含以下核心Servlet映射URL PatternServlet Class作用/loginLoginServlet统一登录入口根据role跳转不同首页/order/listOrderServlet会员查自己订单、商家查本店订单、骑手查待接单/shop/manageShopServlet商家增删菜品、修改营业状态/rider/acceptRiderServlet骑手抢单接口含乐观锁防重复接单2.4 数据库连接配置driverClassName别写错url要带useSSLfalsesrc/jdbc.properties文件控制数据库连接典型内容如下driverClassNamecom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/online?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai usernameroot password123456注意三点driverClassName必须是com.mysql.cj.jdbc.DriverMySQL 8驱动旧版com.mysql.jdbc.Driver已废弃url中useSSLfalse必须显式声明否则MySQL 5.7会因SSL握手失败报Communications link failureserverTimezoneAsia/Shanghai解决时区问题避免订单时间比系统时间慢8小时。验证连接是否成功运行TestConnection.java项目中通常有此测试类输出Connection success!即表示打通。3. 四角色权限隔离实现不是靠if-else硬判断而是URL路由Session属性双重拦截3.1 登录态设计Session中存User对象而非单纯role字符串LoginServlet.java中关键代码// 查询用户后将完整User对象存入session User user userService.login(username, password); if (user ! null) { request.getSession().setAttribute(user, user); // 存对象 String role user.getRole(); if (MEMBER.equals(role)) { response.sendRedirect(request.getContextPath() /member/index.jsp); } else if (SHOP.equals(role)) { response.sendRedirect(request.getContextPath() /shop/index.jsp); } // ...其他角色 }这样做的好处是后续所有Servlet都能通过User user (User) request.getSession().getAttribute(user);拿到用户全部信息ID、姓名、手机号无需反复查库。而如果只存session.setAttribute(role, MEMBER)则每次都要根据role再去查用户详情性能差且易出错。3.2 URL级权限拦截web.xml中配置filter链项目包含AuthFilter.java它在web.xml中被配置为过滤器filter filter-nameAuthFilter/filter-name filter-classcom.filter.AuthFilter/filter-class /filter filter-mapping filter-nameAuthFilter/filter-name url-pattern/member/*/url-pattern /filter-mapping filter-mapping filter-nameAuthFilter/filter-name url-pattern/shop/*/url-pattern /filter-mapping !-- 其他角色路径 --AuthFilter.doFilter()核心逻辑HttpSession session request.getSession(false); User user (User) session.getAttribute(user); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } // 检查URL路径与用户角色是否匹配 String path request.getRequestURI(); if (path.contains(/member/) !MEMBER.equals(user.getRole())) { response.sendRedirect(request.getContextPath() /error/403.jsp); return; } chain.doFilter(request, response); // 放行这种设计比在每个Servlet里写if(!MEMBER.equals(role))更优雅且修改权限规则只需改filter不用动几十个Servlet。3.3 数据库级权限隔离DAO层SQL动态拼接role条件以OrderDao.java为例查询订单列表时public ListOrder listOrdersByRole(User user) { String sql SELECT * FROM orders WHERE 11; ListObject params new ArrayList(); if (MEMBER.equals(user.getRole())) { sql AND user_id ?; params.add(user.getId()); } else if (SHOP.equals(user.getRole())) { sql AND shop_id ?; params.add(user.getId()); // 注意商家user.id shops.id } else if (RIDER.equals(user.getRole())) { sql AND rider_id ? AND status IN (ASSIGNED, PICKED_UP); params.add(user.getId()); } // 管理员无条件查全部 return queryRunner.query(sql, new BeanListHandler(Order.class), params.toArray()); }这里没有用WHERE user_id ? OR shop_id ? OR rider_id ?这种危险写法而是根据role动态生成WHERE条件从根本上杜绝越权查看。3.4 避坑常见权限翻车现场与修复方案现象原因解决方案会员能访问/shop/add.jsp页面JSP文件未被filter拦截用户直接输入URL绕过登录校验在web.xml中为所有JSP路径添加filter-mappingurl-pattern*.jsp/url-pattern并在filter中增加if(path.endsWith(.jsp)) { checkLogin(); }骑手接单后订单状态仍为“待接单”RiderServlet中更新订单时未加事务或UPDATE orders SET statusASSIGNED WHERE id? AND statusWAITING条件漏写导致并发时多个骑手同时更新同一订单在RiderDao.updateStatus()方法上加Transactional需引入JDBC事务管理或用乐观锁UPDATE orders SET statusASSIGNED, rider_id? WHERE id? AND statusWAITING检查executeUpdate()返回值是否为1管理员修改商家信息后商家登录看到数据未更新Session中缓存了旧的Shop对象未在修改后清除在ShopServlet的update方法末尾添加HttpSession session request.getSession();brsession.removeAttribute(shop);中文搜索商家名称时查不到结果MySQL表字符集是latin1但online.sql中建表语句未指定CHARACTER SET utf8mb4手动执行ALTER TABLE shops CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;登录后跳转到404页面response.sendRedirect()中的路径缺少上下文路径contextPath统一写成response.sendRedirect(request.getContextPath() /member/index.jsp);避免硬写/online/member/index.jsp4. 核心业务流程深挖从会员下单到骑手送达的7个关键Servlet调用链4.1 下单流程CartServlet → OrderServlet → PayServlet三级联动会员点击“去结算”触发CartServlet// CartServlet.java protected void doPost(HttpServletRequest request, HttpServletResponse response) { HttpSession session request.getSession(); ListCartItem cart (ListCartItem) session.getAttribute(cart); // 1. 校验库存查shops_products表 for (CartItem item : cart) { int stock productDao.getStock(item.getProductId(), item.getShopId()); if (item.getQuantity() stock) { request.setAttribute(error, 商品 item.getName() 库存不足); request.getRequestDispatcher(/cart.jsp).forward(request, response); return; } } // 2. 将购物车转为订单预览数据存入request域 request.setAttribute(orderItems, cart); request.getRequestDispatcher(/order/confirm.jsp).forward(request, response); }注意这里不做实际扣库存只做前端校验真正扣库存发生在OrderServlet的createOrder()中防止恶意刷单。OrderServlet处理最终提交// OrderServlet.java public void createOrder(HttpServletRequest request, HttpServletResponse response) { // 1. 开启事务 Connection conn JdbcUtil.getConnection(); conn.setAutoCommit(false); try { // 2. 插入订单主表 String sql INSERT INTO orders (user_id, shop_id, total_price, status) VALUES (?, ?, ?, WAITING); QueryRunner qr new QueryRunner(); Object[] params {userId, shopId, totalPrice}; long orderId qr.insert(conn, sql, new ScalarHandler(), params); // 3. 批量插入订单明细 sql INSERT INTO order_items (order_id, product_id, quantity, price) VALUES (?, ?, ?, ?); ListObject[] batchParams new ArrayList(); for (CartItem item : cart) { batchParams.add(new Object[]{orderId, item.getProductId(), item.getQuantity(), item.getPrice()}); } qr.batch(conn, sql, batchParams); // 4. 扣减库存关键 for (CartItem item : cart) { productDao.reduceStock(conn, item.getProductId(), item.getShopId(), item.getQuantity()); } conn.commit(); // 提交事务 response.sendRedirect(request.getContextPath() /order/success.jsp?orderId orderId); } catch (Exception e) { conn.rollback(); // 回滚 e.printStackTrace(); request.setAttribute(error, 下单失败请重试); request.getRequestDispatcher(/order/confirm.jsp).forward(request, response); } }这个事务块保证了“订单创建库存扣减”原子性。若扣库存失败如超卖整个订单回滚购物车数据不变。4.2 骑手抢单乐观锁防并发冲突的实战写法RiderServlet.java中抢单逻辑protected void acceptOrder(HttpServletRequest request, HttpServletResponse response) { int orderId Integer.parseInt(request.getParameter(orderId)); int riderId ((User) request.getSession().getAttribute(user)).getId(); // 关键UPDATE时加条件只更新statusWAITING的订单 String sql UPDATE orders SET statusASSIGNED, rider_id?, update_timeNOW() WHERE id? AND statusWAITING; int updated queryRunner.update(sql, riderId, orderId); if (updated 1) { // 抢单成功推送消息此处简化为写日志 System.out.println(骑手 riderId 抢单成功订单号 orderId); response.sendRedirect(request.getContextPath() /rider/myorders.jsp); } else { // updated0说明订单已被他人抢走 request.setAttribute(error, 很抱歉该订单已被其他骑手接走); request.getRequestDispatcher(/rider/waiting.jsp).forward(request, response); } }这种写法比“先SELECT再UPDATE”更高效且天然防并发——两个骑手同时执行UPDATE只有一个能成功updated1另一个返回0前端提示“订单已被抢”。4.3 商家接单状态机驱动的订单生命周期商家后台的ShopServlet提供/shop/accept接口但接单动作实际是状态跃迁// 订单状态流转规则硬编码在ShopServlet中 // WAITING → ACCEPTED → PREPARING → READY → DELIVERED public void acceptOrder(HttpServletRequest request, HttpServletResponse response) { int orderId Integer.parseInt(request.getParameter(orderId)); String currentStatus orderDao.getStatus(orderId); if (!WAITING.equals(currentStatus)) { request.setAttribute(error, 该订单不可接单当前状态 currentStatus ); request.getRequestDispatcher(/shop/orders.jsp).forward(request, response); return; } orderDao.updateStatus(orderId, ACCEPTED); response.sendRedirect(request.getContextPath() /shop/orders.jsp); }这种显式状态校验比单纯UPDATE orders SET statusACCEPTED WHERE id?更安全避免商家误操作将已配送订单改成“已接单”。4.4 管理员监控实时订单看板的数据聚合逻辑AdminServlet.java的dashboard方法public void dashboard(HttpServletRequest request, HttpServletResponse response) { // 1. 总订单数 int total orderDao.countAll(); // 2. 各状态订单数GROUP BY status MapString, Integer statusCount orderDao.countByStatus(); // 3. 今日新增订单WHERE DATE(create_time) CURDATE() int todayNew orderDao.countToday(); // 4. 热门商家TOP5JOIN shops GROUP BY shop_id ListShop hotShops shopDao.findHotShops(5); request.setAttribute(total, total); request.setAttribute(statusCount, statusCount); request.setAttribute(todayNew, todayNew); request.setAttribute(hotShops, hotShops); request.getRequestDispatcher(/admin/dashboard.jsp).forward(request, response); }注意countByStatus()方法在OrderDao.java中使用原生SQLSELECT status, COUNT(*) as count FROM orders GROUP BY status而不是用Hibernate Criteria因为JSP项目追求简单直接没必要为统计功能引入ORM。5. 调试与排错定位JSPServlet项目“页面空白”“404”“500”的黄金三步法5.1 第一步看Tomcat控制台日志不是浏览器F12当页面一片空白或报错立刻切到Eclipse底部Console标签页观察Tomcat启动日志和HTTP请求日志。常见线索SEVERE: Error filterStart→ web.xml中filter类路径写错如com.filter.AuthFilter实际在com.filters.AuthFilterjava.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver→mysql-connector-java-8.0.33.jar没放进WebContent/WEB-INF/lib/org.apache.jasper.JasperException: Unable to compile class for JSP→ JSP里Java代码语法错误比如% int x ; %少写了值Caused by: java.sql.SQLException: Access denied for user rootlocalhost→ jdbc.properties密码错误或MySQL用户权限不足。5.2 第二步用curl模拟请求绕过浏览器缓存干扰浏览器可能缓存了旧的404页面用curl直击Servlet# 测试登录接口POST curl -X POST http://localhost:8080/online/login \ -H Content-Type: application/x-www-form-urlencoded \ -d usernameadmin -d password123456 # 测试订单列表GET带session curl -b JSESSIONIDABC123... http://localhost:8080/online/order/list如果curl返回正常HTML说明是前端JS或CSS路径问题如果curl也报错则是后端逻辑问题。5.3 第三步在关键Servlet打断点看request域和session域在LoginServlet.java的doPost()第一行加断点启动Debug模式查看request.getParameter(username)是否为空 → 检查form表单name属性是否拼错查看request.getSession().getAttribute(user)是否为null → 检查登录成功后是否真的存了session查看request.getRequestDispatcher(/member/index.jsp).forward(request, response)后index.jsp中% request.getAttribute(user) %是否输出null → 检查forward时request域是否被清空forward是同一次请求request域保留sendRedirect是新请求request域丢失。5.4 避坑JSP开发中最容易忽略的5个细节细节为什么重要如何验证JSP页面顶部必须有% page contentTypetext/html;charsetUTF-8 %缺少此声明会导致中文乱码且部分Tomcat版本会报HTTP Status 500查看浏览器开发者工具Network → Response Headers → Content-Type是否为text/html;charsetUTF-8所有JSP中EL表达式${user.username}需开启EL解析Tomcat 7默认开启但若web.xml是Servlet 2.3规范需手动开启% page isELIgnoredfalse %在JSP中写${11}若输出2则EL正常若输出${11}则被忽略JSTL标签库必须引入且版本匹配项目用c:forEach遍历订单需jstl-1.2.jar和standard-1.1.2.jar检查WEB-INF/lib/是否有这两个jar且% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %中的uri与jar包匹配图片/CSS/JS路径用% request.getContextPath() %写死/images/logo.png在部署到二级路径如/myapp/时会404查看浏览器Network确认资源请求URL是否为http://localhost:8080/online/images/logo.png数据库连接关闭必须在finally块Connection.close()未执行会导致连接池耗尽后续请求全部超时在BaseDao.java的closeConn()方法中加System.out.println(Connection closed);观察日志是否每条SQL后都打印6. 进阶技巧把这套JSPServlet系统改造成可演示的“高光时刻”页面6.1 会员端加一个实时订单状态轮询让下单体验不枯燥原系统订单提交后直接跳转success.jsp用户不知道何时配送。我们给会员首页加一个AJAX轮询!-- member/index.jsp -- div idorder-status h3您最近的订单/h3 div idstatus-refresh正在查询.../div /div script function checkOrderStatus() { fetch(% request.getContextPath() %/order/status?lastUpdateTime new Date().getTime()) .then(response response.json()) .then(data { document.getElementById(status-refresh).innerHTML 订单 ${data.orderId} 状态${data.status}${data.updateTime}; if (data.status DELIVERED) { clearInterval(timer); // 配送完成停止轮询 } }); } let timer setInterval(checkOrderStatus, 5000); // 每5秒查一次 /script后端OrderStatusServlet.javaprotected void doGet(HttpServletRequest request, HttpServletResponse response) { User user (User) request.getSession().getAttribute(user); // 查找该会员最新一条非DELIVERED订单 Order latest orderDao.findLatestByUser(user.getId()); response.setContentType(application/json;charsetUTF-8); response.getWriter().write(new Gson().toJson(latest)); }这样会员就能看到“已接单→制作中→已出餐→配送中”的全过程演示时观众会觉得“这系统真在跑”。6.2 骑手端用WebSocket实现抢单广播轻量级改造虽然原系统是HTTP轮询但我们可以在RiderServlet.acceptOrder()成功后用Tomcat内置WebSocket推送// RiderServlet.java if (updated 1) { // 推送抢单成功消息给所有在线骑手 WebSocketBroadcaster.broadcast(RIDER_ riderId, 订单 orderId 已被抢走); response.sendRedirect(...); }前端骑手页面监听const ws new WebSocket(ws://localhost:8080/online/rider-ws); ws.onmessage function(event) { alert(新订单 event.data); };WebSocket服务端只需继承Endpoint几行代码即可比引入Spring WebSocket轻量得多。6.3 管理员端导出Excel报表的POI集成技巧AdminServlet.exportOrders()方法public void exportOrders(HttpServletRequest request, HttpServletResponse response) { ListOrder orders orderDao.findAll(); // 创建Excel工作簿 XSSFWorkbook workbook new XSSFWorkbook(); XSSFSheet sheet workbook.createSheet(订单报表); // 表头 String[] headers {订单号, 会员, 商家, 总金额, 状态, 下单时间}; XSSFRow headerRow sheet.createRow(0); for (int i 0; i headers.length; i) { headerRow.createCell(i).setCellValue(headers[i]); } // 数据行 int rowNum 1; for (Order o : orders) { XSSFRow row sheet.createRow(rowNum); row.createCell(0).setCellValue(o.getId()); row.createCell(1).setCellValue(o.getUserName()); row.createCell(2).setCellValue(o.getShopName()); row.createCell(3).setCellValue(o.getTotalPrice()); row.createCell(4).setCellValue(o.getStatus()); row.createCell(5).setCellValue(o.getCreateTime().toString()); } // 输出响应 response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment; filenameorders.xlsx); workbook.write(response.getOutputStream()); }关键点poi-ooxml-4.1.2.jar必须放入WEB-INF/lib/且web.xml中无需额外配置POI纯Java实现零依赖。6.4 最后的血泪习惯每次改完Servlet必做三件事清空Tomcat work目录/apache-tomcat-9.0.83/work/Catalina/localhost/online/否则旧的JSP编译class残留导致“改了代码却没生效”的玄学重启Tomcat前先stop再start不要用Eclipse的“Restart”按钮它有时只reload不重启静态资源和类加载器状态可能错乱在web.xml顶部加注释记录修改时间!-- Last modified: 2024-06-15 by zhangsan - added /rider/complete mapping --因为多人协作时web.xml是路由总纲谁动了哪条路径必须可追溯。从那以后我每次改完Servlet都强制走一遍这三步——哪怕只是改了一行response.sendRedirect()的路径。它不能让你写出更炫的代码但能让你在凌晨两点接到“线上订单不入库”的电话时30秒内定位到是OrderServlet的事务没提交而不是怀疑MySQL主从同步出了问题。希望帮到你。本文还有配套的精品资源点击获取