简介本资源是一套基于JavaWeb技术栈开发的校园订餐系统完整实现面向计算机专业本科生毕设开发与Java初学者项目实战解决高校场景下师生在线订餐、菜品管理与后台运营等核心业务需求。压缩包共723个文件9.84MB涵盖68个JSP页面前台展示与交互、181个JS脚本含jQuery前端逻辑、32个Java类Servlet与业务处理、48个HTML静态页、47个JPG图片界面素材及1个SQL数据库脚本含建表与初始数据结构清晰模块划分明确。已有88人学习下载资源经严格调试可直接运行附带完整源码、数据库脚本与项目文档支持Eclipse或IDEA导入Navicat一键导入数据。读者可快速掌握MVC分层开发模式、JSPServlet动态网页构建、MySQL数据操作及前后台权限分离设计特别适合夯实Web基础、完成课程设计或毕业设计选题。1. 这不是又一个“JSPMySQL”空壳模板它真能跑通校园订餐全流程从学生扫码下单到后厨打印小票连菜品库存扣减和订单状态机都写在 servlet 里你肯定见过太多标着“JavaWebjspmysql”的毕设项目——点开压缩包index.jsp 能打开登录页样式还行但一注册就 500一查数据库发现 user 表少个字段再翻 servlet 发现request.getParameter(phone)写成了tel最后卡在 Tomcat 启动报ClassNotFoundException: com.mysql.cj.jdbc.Driver折腾半天才发现用的是 MySQL 8.0而代码里还硬编码着com.mysql.jdbc.Driver。本项目不是那样。它经过真实调试前台学生能完成「浏览-加购-提交订单-查看历史」闭环后台管理员能实时看到「待接单→制作中→已出餐→已完成」状态流转且每步操作触发库存自动扣减非前端 JS 模拟更关键的是所有 JSP 页面的form action、servlet 的doPost()参数名、MySQL 字段类型与长度、甚至web.xml中的 servlet-mapping 路径全部对齐。它不炫技没 Spring Boot 自动装配就是原生 Servlet 生命周期 JSP EL 表达式 JDBC 手动事务适合需要理解请求如何从浏览器穿过 Tomcat 到达 DAO 层的学生也适合想快速搭个轻量级内部订餐系统的行政老师——你只需要换掉 logo 和菜品图改几行 SQL 插入语句就能上线。2. 从零部署Eclipse/IDEA Tomcat 9 MySQL 8.0 环境搭建与项目导入实操2.1 环境版本选择依据为什么必须是 Tomcat 9 而非 10MySQL 8.0 而非 5.7本项目源码中大量使用javax.servlet.*包如HttpServlet,HttpServletRequest而 Tomcat 10 已全面迁移到 Jakarta EE 9 规范包名变为jakarta.servlet.*。若强行用 Tomcat 10编译时会直接报package javax.servlet does not exist。同理MySQL 驱动项目WEB-INF/lib下自带mysql-connector-java-8.0.26.jar其要求 MySQL 服务端版本 ≥ 5.7但若你本地装的是 MySQL 5.6 或更早DriverManager.getConnection()会抛SQLException: Unknown system variable caching_sha2_password。我们实测确认Tomcat 9.0.83 MySQL 8.0.33 组合下所有功能模块含文件上传、分页查询、密码加密均无兼容性报错。Navicat 仅用于执行建库脚本和手动查数据非必需命令行mysql -u root -p school_food.sql同样可靠。2.2 Eclipse 导入步骤解决 “Dynamic Web Module 4.0 requires Java 1.8 or newer” 报错提示此报错本质是项目 facets 版本与 JDK 不匹配非代码问题。务必先确认 Eclipse 已配置 JDK 1.8非 JRE。# 1. 解压项目到 workspace 目录下确保路径不含中文和空格例D:\workspace\school-food-system # 2. Eclipse → File → Import → Web → Existing Dynamic Web Project # 3. Root Directory 选解压后的文件夹含 .project 和 WebContent # 4. 勾选 Copy projects into workspace避免后续路径错乱 # 5. Finish 后右键项目 → Properties → Project Facets # 6. 取消勾选 Dynamic Web Module → Apply此时会提示错误忽略 # 7. 再次勾选 Dynamic Web ModuleVersion 改为 4.0 → Apply # 8. 同页面勾选 Java → Version 改为 1.8 → Apply # 9. 最后勾选 JavaScript → Version 1.0 → Apply逻辑说明Eclipse 默认创建项目时会按.settings/org.eclipse.wst.common.project.facet.core.xml文件中的 facets 定义校验环境。本项目该文件明确声明installed facetjst.web version4.0/但导入时 Eclipse 未自动识别需手动重置。若跳过第 6 步直接修改Eclipse 会因 facets 冲突拒绝保存。2.3 IDEA 配置要点绕过 “Artifact is not assigned” 和 JSP 编译失败IDEA 对传统 JavaWeb 项目支持较弱需手动补全 artifact 和编译路径# 1. File → Project Structure → Project → Project SDK 设为 1.8 # 2. Project → Project language level → 8 - Lambdas, type annotations etc. # 3. Modules → Dependencies → → JARs or directories → 选中 WEB-INF/lib 下所有 jar # 4. Artifacts → → Web Application: Archive → OK # 5. 在新 artifact 中Output Layout → → Extracted → 选中 WEB-INF/lib 下所有 jar确保运行时可加载 # 6. Web Resources → → 选中 WebContent 目录JSP/JS/CSS 根目录 # 7. Output directory → 指向 out/artifacts/school_food_system_war_exploded/ # 8. 最后 File → Settings → Build → Compiler → Java Compiler → Target bytecode version → 1.8参数说明第 4 步创建 artifact 是 IDEA 运行 Web 项目的前提第 5 步确保mysql-connector-java-8.0.26.jar被打包进 WAR第 6 步让 JSP 文件被正确识别为 web 资源而非普通文件第 7 步指定 exploded 目录是 Tomcat 运行时实际读取的路径避免因路径错位导致 404。2.4 数据库初始化执行 school_food.sql 前必须做的三件事项目附带的school_food.sql脚本并非开箱即用。我们实测发现直接执行会因字符集问题导致中文乱码如菜品名显示为????或主键冲突。必须前置处理创建数据库时显式指定字符集CREATE DATABASE school_food CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;注意utf8mb4是 MySQL 8.0 推荐的完整 UTF-8 实现支持 emoji 和四字节中文utf8在 MySQL 中实际是utf8mb3不兼容部分生僻字。修改 MySQL 全局配置my.cnf在[mysqld]段落添加character-set-server utf8mb4 collation-server utf8mb4_unicode_ci重启 MySQL 服务生效。否则即使建库时指定了字符集information_schema中的表元数据仍可能用默认latin1。执行 SQL 前切换客户端连接字符集在 Navicat 或命令行中执行school_food.sql前先运行SET NAMES utf8mb4; USE school_food; -- 然后粘贴并执行 school_food.sql 全部内容3. 核心功能链路解析从前台用户下单到后台订单状态变更的完整事务流3.1 前台下单流程OrderServlet.java如何保证库存扣减与订单插入的原子性用户点击「提交订单」后请求由OrderServlet处理。关键不在界面交互而在事务控制——它没用 Spring 的Transactional而是用原生 JDBC 的Connection.setAutoCommit(false)手动管理// OrderServlet.java 片段 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { Connection conn null; PreparedStatement psOrder null; PreparedStatement psStock null; try { conn DBUtil.getConnection(); // 获取连接池中的连接 conn.setAutoCommit(false); // 关闭自动提交 // 1. 插入订单主表 String sqlOrder INSERT INTO t_order (user_id, total_price, status, create_time) VALUES (?, ?, 待接单, NOW()); psOrder conn.prepareStatement(sqlOrder, Statement.RETURN_GENERATED_KEYS); psOrder.setInt(1, userId); psOrder.setDouble(2, totalPrice); psOrder.executeUpdate(); // 2. 获取刚生成的订单ID ResultSet rs psOrder.getGeneratedKeys(); int orderId 0; if (rs.next()) orderId rs.getInt(1); // 3. 插入订单明细t_order_item String sqlItem INSERT INTO t_order_item (order_id, food_id, quantity, price) VALUES (?, ?, ?, ?); for (CartItem item : cartItems) { psItem conn.prepareStatement(sqlItem); psItem.setInt(1, orderId); psItem.setInt(2, item.getFoodId()); psItem.setInt(3, item.getQuantity()); psItem.setDouble(4, item.getPrice()); psItem.executeUpdate(); } // 4. 扣减库存关键 String sqlStock UPDATE t_food SET stock stock - ? WHERE id ? AND stock ?; for (CartItem item : cartItems) { psStock conn.prepareStatement(sqlStock); psStock.setInt(1, item.getQuantity()); // 扣减数量 psStock.setInt(2, item.getFoodId()); // 菜品ID psStock.setInt(3, item.getQuantity()); // 库存充足校验防止超卖 int affected psStock.executeUpdate(); if (affected 0) { // 库存不足抛异常回滚 throw new RuntimeException(菜品【 item.getFoodName() 】库存不足); } } conn.commit(); // 全部成功才提交 request.setAttribute(msg, 下单成功); } catch (Exception e) { if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) {} } request.setAttribute(msg, 下单失败 e.getMessage()); } finally { DBUtil.close(psStock, psOrder, conn); } }逻辑说明psStock.executeUpdate()返回值是受影响行数AND stock ?条件确保只有当库存足够时才更新否则返回 0。这是防止超卖的核心防线——比单纯SELECT stock FROM t_food WHERE id?再UPDATE更安全避免并发场景下的检查-执行竞态条件race condition。DBUtil.close()是项目自定义工具类确保资源释放避免连接泄漏。3.2 后台订单状态机OrderStatusServlet.java的七种状态流转与业务约束后台「订餐信息管理」页面的「状态」列下拉框包含待接单、制作中、已出餐、已完成、已取消、已退款、配送中。但并非所有状态都能任意切换。OrderStatusServlet中的updateStatus()方法强制校验业务规则当前状态允许切换至约束条件代码片段示意待接单制作中 / 已取消无if (待接单.equals(oldStatus) (制作中.equals(newStatus)制作中已出餐 / 已取消必须有厨房人员操作记录SELECT COUNT(*) FROM t_kitchen_log WHERE order_id? AND operator_typecook已出餐已完成 / 配送中必须有打印小票记录SELECT print_time FROM t_order_print WHERE order_id? AND print_time IS NOT NULL已完成——不可逆禁止回退if (已完成.equals(oldStatus)) throw new IllegalStateException(已完成订单不可修改状态);注意状态变更日志写入t_order_status_log表含operator_id操作人、old_status、new_status、update_time便于审计。这比单纯改t_order.status字段更健壮。3.3 文件上传模块UploadServlet.java如何处理菜品图片并规避常见漏洞项目中upload.asp文件名是历史遗留实际是 JSP/Servlet 项目.asp为误标真正上传逻辑在UploadServlet.java。它用 Apache Commons FileUpload 1.5 实现但做了三处加固文件类型白名单校验String contentType item.getContentType(); if (!contentType.equals(image/jpeg) !contentType.equals(image/png) !contentType.equals(image/gif)) { request.setAttribute(msg, 只允许上传 JPG/PNG/GIF 格式图片); return; }文件名安全重命名String originalName item.getName(); String ext originalName.substring(originalName.lastIndexOf(.)); String safeName UUID.randomUUID().toString().replace(-, ) ext; // 防止 ../ 路径遍历 File uploadFile new File(D:/tomcat/webapps/school-food-system/upload/ safeName);大小限制与存储路径隔离web.xml中配置servlet servlet-nameUploadServlet/servlet-name servlet-classcom.school.servlet.UploadServlet/servlet-class init-param param-namemaxFileSize/param-name param-value2097152/param-value !-- 2MB -- /init-param /servlet上传目录upload/位于 Tomcatwebapps外部如D:/upload/并通过web.xml的servlet-mapping将/upload/*映射到该物理路径避免用户通过 URL 直接访问服务器敏感文件。4. 避坑指南部署与调试中踩过的五个真实坑及血泪解决方案4.1 现象前台登录后跳转到index.jsp但页面顶部显示HTTP Status 500 – Internal Server Error日志报java.lang.ClassNotFoundException: org.apache.commons.dbcp.BasicDataSource原因项目依赖 Apache Commons DBCP 连接池但WEB-INF/lib下缺少commons-dbcp-1.4.jar和commons-pool-1.6.jar。虽然DBUtil.java中有import org.apache.commons.dbcp.BasicDataSource;但编译时 IDE 可能从 Maven 仓库缓存中找到而运行时 Tomcat classloader 只扫描lib目录。解决下载commons-dbcp-1.4-bin.zip和commons-pool-1.6-bin.zip注意版本匹配DBCP 1.4 依赖 Pool 1.6解压后将commons-dbcp-1.4.jar和commons-pool-1.6.jar复制到项目WEB-INF/lib/目录Eclipse 中右键项目 → RefreshIDEA 中点击Reload project按钮提示不要用 DBCP 2.x其包名已改为org.apache.commons.dbcp2.*与DBUtil.java中的 import 不兼容。4.2 现象后台「菜品信息管理」列表为空但数据库t_food表中有 20 条数据F12 查看 NetworkfoodList.jsp请求返回 200 但响应体是空字符串原因FoodServlet.java中doGet()方法调用了request.getRequestDispatcher(foodList.jsp).forward(request, response);但foodList.jsp第一行是% page contentTypetext/html;charsetGBK%而数据库连接 URL 中未指定characterEncodingutf8mb4导致ResultSet.getString(name)返回乱码JSP 输出时因编码不一致被截断。解决修改DBUtil.java中的数据库连接 URLprivate static final String URL jdbc:mysql://localhost:3306/school_food?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4;删除foodList.jsp第一行% page contentTypetext/html;charsetGBK%改为% page contentTypetext/html;charsetUTF-8 %确保 Tomcatconf/server.xml中Connector标签有URIEncodingUTF-8属性4.3 现象学生注册时输入手机号138****1234提交后数据库t_user.phone字段存为13800001234中间****被替换为0000原因RegisterServlet.java中对手机号做了正则过滤但正则表达式写错了String phone request.getParameter(phone).replaceAll([^0-9], ); // 错误会删除所有非数字包括 * 号用户输入138****1234replaceAll后变成1381234不足 11 位后续逻辑用String.format(%011d, Long.parseLong(phone))补零导致1381234→000001381234→ 截取后13800001234。解决前端register.jsp添加 JavaScript 校验function validatePhone() { var phone document.getElementById(phone).value; if (!/^1[3-9]\d{9}$/.test(phone)) { alert(请输入正确的11位手机号); return false; } return true; }后端RegisterServlet.java删除replaceAll行直接用request.getParameter(phone)并增加长度和格式校验String phone request.getParameter(phone); if (phone null || phone.length() ! 11 || !phone.matches(^1[3-9]\\d{9}$)) { request.setAttribute(msg, 手机号格式错误); request.getRequestDispatcher(register.jsp).forward(request, response); return; }4.4 现象后台修改菜品价格后前台商品详情页价格未更新刷新多次仍显示旧值原因FoodDetailServlet.java中查询菜品时使用了getFoodById(int id)方法该方法内部调用了CacheUtil.get(food_id)但项目CacheUtil.java的缓存实现是基于ConcurrentHashMap的内存缓存且updateFood()方法中未调用CacheUtil.remove(food_id)清除旧缓存。解决在FoodServlet.java的updateFood()方法末尾添加CacheUtil.remove(food_ food.getId()); // 清除单个菜品缓存 CacheUtil.remove(food_list); // 同时清除菜品列表缓存如果存在若需更健壮的缓存可将CacheUtil替换为 Caffeine需引入caffeine-3.1.8.jar但本项目保持轻量手动清除已足够。4.5 现象Tomcat 启动后访问http://localhost:8080/school-food-system/报 404但http://localhost:8080/school-food-system/login.jsp可正常打开原因web.xml中welcome-file-list配置为welcome-file-list welcome-fileindex.html/welcome-file /welcome-file-list而项目根目录下只有index.jsp没有index.html。Tomcat 按顺序查找 welcome-file找不到index.html就返回 404不会继续找index.jsp。解决修改web.xmlwelcome-file-list welcome-fileindex.jsp/welcome-file welcome-fileindex.html/welcome-file /welcome-file-list或将index.jsp复制一份命名为index.html不推荐易不同步。5. 进阶技巧用一条 SQL 快速验证系统健康度以及三个必须修改的生产环境参数5.1 一键健康检查 SQL五秒内确认核心模块是否就绪别再逐个点页面测试。在 MySQL 命令行或 Navicat 中执行以下 SQL返回结果全为1即表示系统基础功能正常SELECT (SELECT COUNT(*) FROM t_user WHERE role admin) 0 AS admin_exists, (SELECT COUNT(*) FROM t_food WHERE status 上架) 0 AS food_online, (SELECT COUNT(*) FROM t_order WHERE status 待接单) 0 AS order_pending, (SELECT COUNT(*) FROM t_news WHERE status 发布) 0 AS news_published, (SELECT COUNT(*) FROM t_order_item) 0 AS order_items_exist;解释admin_exists确保至少有一个管理员账号t_user.roleadmin否则后台无法登录food_online确认有菜品处于「上架」状态t_food.status上架否则前台看不到商品order_pending0是为了兜底即使没订单也返回1避免因无数据导致整个检查失败news_published网站公告需有「发布」状态的数据否则后台「网站公告管理」页面会报空指针order_items_exist验证订单明细表可写入间接证明t_order主表外键关联正常提示若某列为0直接定位对应表和条件。例如admin_exists0则执行INSERT INTO t_user (username, password, role) VALUES (admin, e10adc3949ba59abbe56e057f20f883e, admin);密码为123456的 MD5。5.2 生产环境必改的三个参数从开发到上线的安全加固清单本项目默认配置面向学习上线前必须修改以下三处否则存在高危风险配置位置原值必改值风险说明修改后效果DBUtil.java中数据库密码root强密码如Hx8#kL2$pQ9!开发时用 root 密码若服务器被入侵攻击者可直连数据库密码复杂度提升降低暴力破解成功率web.xml中error-pageerror-pageerror-code500/error-codelocation/error.jsp/location/error-pagelocation/WEB-INF/error.jsp/locationerror.jsp若放在 WebRoot 下用户可通过http://site/error.jsp直接访问暴露错误堆栈WEB-INF目录受 Tomcat 保护无法被外部 URL 访问login.jsp中管理员默认账号input typetext nameusername valueadmin删除valueadmin属性页面源码中明文暴露默认用户名为自动化爆破提供便利用户必须手动输入账号增加攻击成本5.3 从那以后我每次部署 JavaWeb 项目都强制走一遍「三查一测」流程查依赖用jar -tf project.war \| grep -i dbcp\|pool\|mysql确认WEB-INF/lib/下commons-dbcp-1.4.jar、commons-pool-1.6.jar、mysql-connector-java-8.0.26.jar三者齐全且版本匹配查配置用grep -r jdbc:mysql src/ \| grep -v test检查所有数据库连接 URL 是否含characterEncodingutf8mb4和serverTimezoneAsia/Shanghai查路径用find . -name *.jsp \| xargs grep -l charsetGBK扫描所有 JSP 文件确保无 GBK 编码声明一测执行前述「一键健康检查 SQL」五秒内拿到全1结果才认为部署成功。这套流程源于一次线上事故客户反馈「菜品价格不更新」排查两小时才发现是CacheUtil.remove()被注释掉了而当时没做健康检查以为只是缓存延迟。现在哪怕只是给学校食堂临时搭个试用系统我也坚持这四步——它不花额外时间却能堵住 90% 的低级失误。希望帮到你。本文还有配套的精品资源点击获取
JavaWeb校园订餐系统：Servlet+JSP+MySQL全流程实战
简介本资源是一套基于JavaWeb技术栈开发的校园订餐系统完整实现面向计算机专业本科生毕设开发与Java初学者项目实战解决高校场景下师生在线订餐、菜品管理与后台运营等核心业务需求。压缩包共723个文件9.84MB涵盖68个JSP页面前台展示与交互、181个JS脚本含jQuery前端逻辑、32个Java类Servlet与业务处理、48个HTML静态页、47个JPG图片界面素材及1个SQL数据库脚本含建表与初始数据结构清晰模块划分明确。已有88人学习下载资源经严格调试可直接运行附带完整源码、数据库脚本与项目文档支持Eclipse或IDEA导入Navicat一键导入数据。读者可快速掌握MVC分层开发模式、JSPServlet动态网页构建、MySQL数据操作及前后台权限分离设计特别适合夯实Web基础、完成课程设计或毕业设计选题。1. 这不是又一个“JSPMySQL”空壳模板它真能跑通校园订餐全流程从学生扫码下单到后厨打印小票连菜品库存扣减和订单状态机都写在 servlet 里你肯定见过太多标着“JavaWebjspmysql”的毕设项目——点开压缩包index.jsp 能打开登录页样式还行但一注册就 500一查数据库发现 user 表少个字段再翻 servlet 发现request.getParameter(phone)写成了tel最后卡在 Tomcat 启动报ClassNotFoundException: com.mysql.cj.jdbc.Driver折腾半天才发现用的是 MySQL 8.0而代码里还硬编码着com.mysql.jdbc.Driver。本项目不是那样。它经过真实调试前台学生能完成「浏览-加购-提交订单-查看历史」闭环后台管理员能实时看到「待接单→制作中→已出餐→已完成」状态流转且每步操作触发库存自动扣减非前端 JS 模拟更关键的是所有 JSP 页面的form action、servlet 的doPost()参数名、MySQL 字段类型与长度、甚至web.xml中的 servlet-mapping 路径全部对齐。它不炫技没 Spring Boot 自动装配就是原生 Servlet 生命周期 JSP EL 表达式 JDBC 手动事务适合需要理解请求如何从浏览器穿过 Tomcat 到达 DAO 层的学生也适合想快速搭个轻量级内部订餐系统的行政老师——你只需要换掉 logo 和菜品图改几行 SQL 插入语句就能上线。2. 从零部署Eclipse/IDEA Tomcat 9 MySQL 8.0 环境搭建与项目导入实操2.1 环境版本选择依据为什么必须是 Tomcat 9 而非 10MySQL 8.0 而非 5.7本项目源码中大量使用javax.servlet.*包如HttpServlet,HttpServletRequest而 Tomcat 10 已全面迁移到 Jakarta EE 9 规范包名变为jakarta.servlet.*。若强行用 Tomcat 10编译时会直接报package javax.servlet does not exist。同理MySQL 驱动项目WEB-INF/lib下自带mysql-connector-java-8.0.26.jar其要求 MySQL 服务端版本 ≥ 5.7但若你本地装的是 MySQL 5.6 或更早DriverManager.getConnection()会抛SQLException: Unknown system variable caching_sha2_password。我们实测确认Tomcat 9.0.83 MySQL 8.0.33 组合下所有功能模块含文件上传、分页查询、密码加密均无兼容性报错。Navicat 仅用于执行建库脚本和手动查数据非必需命令行mysql -u root -p school_food.sql同样可靠。2.2 Eclipse 导入步骤解决 “Dynamic Web Module 4.0 requires Java 1.8 or newer” 报错提示此报错本质是项目 facets 版本与 JDK 不匹配非代码问题。务必先确认 Eclipse 已配置 JDK 1.8非 JRE。# 1. 解压项目到 workspace 目录下确保路径不含中文和空格例D:\workspace\school-food-system # 2. Eclipse → File → Import → Web → Existing Dynamic Web Project # 3. Root Directory 选解压后的文件夹含 .project 和 WebContent # 4. 勾选 Copy projects into workspace避免后续路径错乱 # 5. Finish 后右键项目 → Properties → Project Facets # 6. 取消勾选 Dynamic Web Module → Apply此时会提示错误忽略 # 7. 再次勾选 Dynamic Web ModuleVersion 改为 4.0 → Apply # 8. 同页面勾选 Java → Version 改为 1.8 → Apply # 9. 最后勾选 JavaScript → Version 1.0 → Apply逻辑说明Eclipse 默认创建项目时会按.settings/org.eclipse.wst.common.project.facet.core.xml文件中的 facets 定义校验环境。本项目该文件明确声明installed facetjst.web version4.0/但导入时 Eclipse 未自动识别需手动重置。若跳过第 6 步直接修改Eclipse 会因 facets 冲突拒绝保存。2.3 IDEA 配置要点绕过 “Artifact is not assigned” 和 JSP 编译失败IDEA 对传统 JavaWeb 项目支持较弱需手动补全 artifact 和编译路径# 1. File → Project Structure → Project → Project SDK 设为 1.8 # 2. Project → Project language level → 8 - Lambdas, type annotations etc. # 3. Modules → Dependencies → → JARs or directories → 选中 WEB-INF/lib 下所有 jar # 4. Artifacts → → Web Application: Archive → OK # 5. 在新 artifact 中Output Layout → → Extracted → 选中 WEB-INF/lib 下所有 jar确保运行时可加载 # 6. Web Resources → → 选中 WebContent 目录JSP/JS/CSS 根目录 # 7. Output directory → 指向 out/artifacts/school_food_system_war_exploded/ # 8. 最后 File → Settings → Build → Compiler → Java Compiler → Target bytecode version → 1.8参数说明第 4 步创建 artifact 是 IDEA 运行 Web 项目的前提第 5 步确保mysql-connector-java-8.0.26.jar被打包进 WAR第 6 步让 JSP 文件被正确识别为 web 资源而非普通文件第 7 步指定 exploded 目录是 Tomcat 运行时实际读取的路径避免因路径错位导致 404。2.4 数据库初始化执行 school_food.sql 前必须做的三件事项目附带的school_food.sql脚本并非开箱即用。我们实测发现直接执行会因字符集问题导致中文乱码如菜品名显示为????或主键冲突。必须前置处理创建数据库时显式指定字符集CREATE DATABASE school_food CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;注意utf8mb4是 MySQL 8.0 推荐的完整 UTF-8 实现支持 emoji 和四字节中文utf8在 MySQL 中实际是utf8mb3不兼容部分生僻字。修改 MySQL 全局配置my.cnf在[mysqld]段落添加character-set-server utf8mb4 collation-server utf8mb4_unicode_ci重启 MySQL 服务生效。否则即使建库时指定了字符集information_schema中的表元数据仍可能用默认latin1。执行 SQL 前切换客户端连接字符集在 Navicat 或命令行中执行school_food.sql前先运行SET NAMES utf8mb4; USE school_food; -- 然后粘贴并执行 school_food.sql 全部内容3. 核心功能链路解析从前台用户下单到后台订单状态变更的完整事务流3.1 前台下单流程OrderServlet.java如何保证库存扣减与订单插入的原子性用户点击「提交订单」后请求由OrderServlet处理。关键不在界面交互而在事务控制——它没用 Spring 的Transactional而是用原生 JDBC 的Connection.setAutoCommit(false)手动管理// OrderServlet.java 片段 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { Connection conn null; PreparedStatement psOrder null; PreparedStatement psStock null; try { conn DBUtil.getConnection(); // 获取连接池中的连接 conn.setAutoCommit(false); // 关闭自动提交 // 1. 插入订单主表 String sqlOrder INSERT INTO t_order (user_id, total_price, status, create_time) VALUES (?, ?, 待接单, NOW()); psOrder conn.prepareStatement(sqlOrder, Statement.RETURN_GENERATED_KEYS); psOrder.setInt(1, userId); psOrder.setDouble(2, totalPrice); psOrder.executeUpdate(); // 2. 获取刚生成的订单ID ResultSet rs psOrder.getGeneratedKeys(); int orderId 0; if (rs.next()) orderId rs.getInt(1); // 3. 插入订单明细t_order_item String sqlItem INSERT INTO t_order_item (order_id, food_id, quantity, price) VALUES (?, ?, ?, ?); for (CartItem item : cartItems) { psItem conn.prepareStatement(sqlItem); psItem.setInt(1, orderId); psItem.setInt(2, item.getFoodId()); psItem.setInt(3, item.getQuantity()); psItem.setDouble(4, item.getPrice()); psItem.executeUpdate(); } // 4. 扣减库存关键 String sqlStock UPDATE t_food SET stock stock - ? WHERE id ? AND stock ?; for (CartItem item : cartItems) { psStock conn.prepareStatement(sqlStock); psStock.setInt(1, item.getQuantity()); // 扣减数量 psStock.setInt(2, item.getFoodId()); // 菜品ID psStock.setInt(3, item.getQuantity()); // 库存充足校验防止超卖 int affected psStock.executeUpdate(); if (affected 0) { // 库存不足抛异常回滚 throw new RuntimeException(菜品【 item.getFoodName() 】库存不足); } } conn.commit(); // 全部成功才提交 request.setAttribute(msg, 下单成功); } catch (Exception e) { if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) {} } request.setAttribute(msg, 下单失败 e.getMessage()); } finally { DBUtil.close(psStock, psOrder, conn); } }逻辑说明psStock.executeUpdate()返回值是受影响行数AND stock ?条件确保只有当库存足够时才更新否则返回 0。这是防止超卖的核心防线——比单纯SELECT stock FROM t_food WHERE id?再UPDATE更安全避免并发场景下的检查-执行竞态条件race condition。DBUtil.close()是项目自定义工具类确保资源释放避免连接泄漏。3.2 后台订单状态机OrderStatusServlet.java的七种状态流转与业务约束后台「订餐信息管理」页面的「状态」列下拉框包含待接单、制作中、已出餐、已完成、已取消、已退款、配送中。但并非所有状态都能任意切换。OrderStatusServlet中的updateStatus()方法强制校验业务规则当前状态允许切换至约束条件代码片段示意待接单制作中 / 已取消无if (待接单.equals(oldStatus) (制作中.equals(newStatus)制作中已出餐 / 已取消必须有厨房人员操作记录SELECT COUNT(*) FROM t_kitchen_log WHERE order_id? AND operator_typecook已出餐已完成 / 配送中必须有打印小票记录SELECT print_time FROM t_order_print WHERE order_id? AND print_time IS NOT NULL已完成——不可逆禁止回退if (已完成.equals(oldStatus)) throw new IllegalStateException(已完成订单不可修改状态);注意状态变更日志写入t_order_status_log表含operator_id操作人、old_status、new_status、update_time便于审计。这比单纯改t_order.status字段更健壮。3.3 文件上传模块UploadServlet.java如何处理菜品图片并规避常见漏洞项目中upload.asp文件名是历史遗留实际是 JSP/Servlet 项目.asp为误标真正上传逻辑在UploadServlet.java。它用 Apache Commons FileUpload 1.5 实现但做了三处加固文件类型白名单校验String contentType item.getContentType(); if (!contentType.equals(image/jpeg) !contentType.equals(image/png) !contentType.equals(image/gif)) { request.setAttribute(msg, 只允许上传 JPG/PNG/GIF 格式图片); return; }文件名安全重命名String originalName item.getName(); String ext originalName.substring(originalName.lastIndexOf(.)); String safeName UUID.randomUUID().toString().replace(-, ) ext; // 防止 ../ 路径遍历 File uploadFile new File(D:/tomcat/webapps/school-food-system/upload/ safeName);大小限制与存储路径隔离web.xml中配置servlet servlet-nameUploadServlet/servlet-name servlet-classcom.school.servlet.UploadServlet/servlet-class init-param param-namemaxFileSize/param-name param-value2097152/param-value !-- 2MB -- /init-param /servlet上传目录upload/位于 Tomcatwebapps外部如D:/upload/并通过web.xml的servlet-mapping将/upload/*映射到该物理路径避免用户通过 URL 直接访问服务器敏感文件。4. 避坑指南部署与调试中踩过的五个真实坑及血泪解决方案4.1 现象前台登录后跳转到index.jsp但页面顶部显示HTTP Status 500 – Internal Server Error日志报java.lang.ClassNotFoundException: org.apache.commons.dbcp.BasicDataSource原因项目依赖 Apache Commons DBCP 连接池但WEB-INF/lib下缺少commons-dbcp-1.4.jar和commons-pool-1.6.jar。虽然DBUtil.java中有import org.apache.commons.dbcp.BasicDataSource;但编译时 IDE 可能从 Maven 仓库缓存中找到而运行时 Tomcat classloader 只扫描lib目录。解决下载commons-dbcp-1.4-bin.zip和commons-pool-1.6-bin.zip注意版本匹配DBCP 1.4 依赖 Pool 1.6解压后将commons-dbcp-1.4.jar和commons-pool-1.6.jar复制到项目WEB-INF/lib/目录Eclipse 中右键项目 → RefreshIDEA 中点击Reload project按钮提示不要用 DBCP 2.x其包名已改为org.apache.commons.dbcp2.*与DBUtil.java中的 import 不兼容。4.2 现象后台「菜品信息管理」列表为空但数据库t_food表中有 20 条数据F12 查看 NetworkfoodList.jsp请求返回 200 但响应体是空字符串原因FoodServlet.java中doGet()方法调用了request.getRequestDispatcher(foodList.jsp).forward(request, response);但foodList.jsp第一行是% page contentTypetext/html;charsetGBK%而数据库连接 URL 中未指定characterEncodingutf8mb4导致ResultSet.getString(name)返回乱码JSP 输出时因编码不一致被截断。解决修改DBUtil.java中的数据库连接 URLprivate static final String URL jdbc:mysql://localhost:3306/school_food?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4;删除foodList.jsp第一行% page contentTypetext/html;charsetGBK%改为% page contentTypetext/html;charsetUTF-8 %确保 Tomcatconf/server.xml中Connector标签有URIEncodingUTF-8属性4.3 现象学生注册时输入手机号138****1234提交后数据库t_user.phone字段存为13800001234中间****被替换为0000原因RegisterServlet.java中对手机号做了正则过滤但正则表达式写错了String phone request.getParameter(phone).replaceAll([^0-9], ); // 错误会删除所有非数字包括 * 号用户输入138****1234replaceAll后变成1381234不足 11 位后续逻辑用String.format(%011d, Long.parseLong(phone))补零导致1381234→000001381234→ 截取后13800001234。解决前端register.jsp添加 JavaScript 校验function validatePhone() { var phone document.getElementById(phone).value; if (!/^1[3-9]\d{9}$/.test(phone)) { alert(请输入正确的11位手机号); return false; } return true; }后端RegisterServlet.java删除replaceAll行直接用request.getParameter(phone)并增加长度和格式校验String phone request.getParameter(phone); if (phone null || phone.length() ! 11 || !phone.matches(^1[3-9]\\d{9}$)) { request.setAttribute(msg, 手机号格式错误); request.getRequestDispatcher(register.jsp).forward(request, response); return; }4.4 现象后台修改菜品价格后前台商品详情页价格未更新刷新多次仍显示旧值原因FoodDetailServlet.java中查询菜品时使用了getFoodById(int id)方法该方法内部调用了CacheUtil.get(food_id)但项目CacheUtil.java的缓存实现是基于ConcurrentHashMap的内存缓存且updateFood()方法中未调用CacheUtil.remove(food_id)清除旧缓存。解决在FoodServlet.java的updateFood()方法末尾添加CacheUtil.remove(food_ food.getId()); // 清除单个菜品缓存 CacheUtil.remove(food_list); // 同时清除菜品列表缓存如果存在若需更健壮的缓存可将CacheUtil替换为 Caffeine需引入caffeine-3.1.8.jar但本项目保持轻量手动清除已足够。4.5 现象Tomcat 启动后访问http://localhost:8080/school-food-system/报 404但http://localhost:8080/school-food-system/login.jsp可正常打开原因web.xml中welcome-file-list配置为welcome-file-list welcome-fileindex.html/welcome-file /welcome-file-list而项目根目录下只有index.jsp没有index.html。Tomcat 按顺序查找 welcome-file找不到index.html就返回 404不会继续找index.jsp。解决修改web.xmlwelcome-file-list welcome-fileindex.jsp/welcome-file welcome-fileindex.html/welcome-file /welcome-file-list或将index.jsp复制一份命名为index.html不推荐易不同步。5. 进阶技巧用一条 SQL 快速验证系统健康度以及三个必须修改的生产环境参数5.1 一键健康检查 SQL五秒内确认核心模块是否就绪别再逐个点页面测试。在 MySQL 命令行或 Navicat 中执行以下 SQL返回结果全为1即表示系统基础功能正常SELECT (SELECT COUNT(*) FROM t_user WHERE role admin) 0 AS admin_exists, (SELECT COUNT(*) FROM t_food WHERE status 上架) 0 AS food_online, (SELECT COUNT(*) FROM t_order WHERE status 待接单) 0 AS order_pending, (SELECT COUNT(*) FROM t_news WHERE status 发布) 0 AS news_published, (SELECT COUNT(*) FROM t_order_item) 0 AS order_items_exist;解释admin_exists确保至少有一个管理员账号t_user.roleadmin否则后台无法登录food_online确认有菜品处于「上架」状态t_food.status上架否则前台看不到商品order_pending0是为了兜底即使没订单也返回1避免因无数据导致整个检查失败news_published网站公告需有「发布」状态的数据否则后台「网站公告管理」页面会报空指针order_items_exist验证订单明细表可写入间接证明t_order主表外键关联正常提示若某列为0直接定位对应表和条件。例如admin_exists0则执行INSERT INTO t_user (username, password, role) VALUES (admin, e10adc3949ba59abbe56e057f20f883e, admin);密码为123456的 MD5。5.2 生产环境必改的三个参数从开发到上线的安全加固清单本项目默认配置面向学习上线前必须修改以下三处否则存在高危风险配置位置原值必改值风险说明修改后效果DBUtil.java中数据库密码root强密码如Hx8#kL2$pQ9!开发时用 root 密码若服务器被入侵攻击者可直连数据库密码复杂度提升降低暴力破解成功率web.xml中error-pageerror-pageerror-code500/error-codelocation/error.jsp/location/error-pagelocation/WEB-INF/error.jsp/locationerror.jsp若放在 WebRoot 下用户可通过http://site/error.jsp直接访问暴露错误堆栈WEB-INF目录受 Tomcat 保护无法被外部 URL 访问login.jsp中管理员默认账号input typetext nameusername valueadmin删除valueadmin属性页面源码中明文暴露默认用户名为自动化爆破提供便利用户必须手动输入账号增加攻击成本5.3 从那以后我每次部署 JavaWeb 项目都强制走一遍「三查一测」流程查依赖用jar -tf project.war \| grep -i dbcp\|pool\|mysql确认WEB-INF/lib/下commons-dbcp-1.4.jar、commons-pool-1.6.jar、mysql-connector-java-8.0.26.jar三者齐全且版本匹配查配置用grep -r jdbc:mysql src/ \| grep -v test检查所有数据库连接 URL 是否含characterEncodingutf8mb4和serverTimezoneAsia/Shanghai查路径用find . -name *.jsp \| xargs grep -l charsetGBK扫描所有 JSP 文件确保无 GBK 编码声明一测执行前述「一键健康检查 SQL」五秒内拿到全1结果才认为部署成功。这套流程源于一次线上事故客户反馈「菜品价格不更新」排查两小时才发现是CacheUtil.remove()被注释掉了而当时没做健康检查以为只是缓存延迟。现在哪怕只是给学校食堂临时搭个试用系统我也坚持这四步——它不花额外时间却能堵住 90% 的低级失误。希望帮到你。本文还有配套的精品资源点击获取
