SSM+JSP搭建轻量级咖啡馆管理系统实战

简介：本资源是一套基于SSM（Spring+SpringMVC+MyBatis）框架与Java语言开发的咖啡馆管理系统完整实现方案，面向Java初学者、Web开发入门者及课程设计/毕业设计学生，解决中小型实体咖啡馆在点单、库存、员工、财务及报表统计等场景下的数字化管理需求。压缩包共1464个文件，涵盖140个JSP动态页面（实现前后端交互与用户界面）、130个Java后端类（含Controller、Service、DAO层逻辑）、398个JS脚本（增强前端交互）、183个PNG与78个JPG图片资源（UI素材）、165个CSS样式文件（含Bootstrap、Layui、Element UI等主流框架样式），以及db.sql数据库脚本、说明文档与开题报告等配套资料，整体大小为33.68MB。已有60人学习下载，资源结构规范、模块划分清晰，包含完整MVC分层代码、可直接运行的数据库初始化脚本、详细操作指引及典型业务流程实现（如扫码点单、库存预警、销售统计），是理解Java Web企业级开发全流程的优质实践案例。

1. 为什么一个“咖啡馆管理系统”要用 SSM + JSP？——不是为了炫技，而是让点单、库存、排班三件事在一台旧笔记本上跑得稳、改得快、查得清

你手头有一台 8GB 内存、i5-7200U 的二手办公本，老板刚甩来一句：“下周开业，先搭个能管收银、记库存、排服务员班次的系统，别用现成SaaS，要能自己改菜单、加折扣、导Excel。”——这时候选 Spring + SpringMVC + MyBatis（SSM）+ JSP，不是因为“Java老派”，而是它把业务逻辑可拆、页面局部刷新可控、数据库操作可追溯、部署包小到能塞进Tomcat 8.5裸机这四件事，压进一个足够轻、足够直、足够扛住30人/天手工录入的栈里。它不追求微服务弹性伸缩，但能让你在咖啡渍还没干透时，就改完“美式加冰默认勾选”这个需求；它不玩前后端分离的API契约，但能让服务员在IE11里点两下就完成退单，后台日志里还能翻出谁、几点、退了哪杯拿铁。这不是过时技术，是面向中小实体场景的务实工程选择：JSP负责快速拼页面、SSM负责把“下单→扣库存→生成流水”这条链路钉死、MySQL负责存得牢、Tomcat负责开箱即用。如果你正被“Vue全家桶部署太重”“Spring Boot打包太大”“纯HTML+Ajax权限难控”卡住，这个组合就是你的后悔药。

2. 搭建最小可运行骨架：从 JDK 8 到 Tomcat 8.5，五步落地 SSM + JSP 环境

SSM + JSP 不是堆砌框架，而是用最简依赖把三层粘牢：Spring 管 Bean 和事务、SpringMVC 接 HTTP 请求、MyBatis 做 SQL 映射、JSP 渲染最终 HTML。下面这套配置，是我在线下咖啡馆实测过的最低可行环境——不用 Docker、不装 Maven 私服、不配 Nginx 反向代理，所有东西塞进一个webapps/coffee目录就能跑。

2.1 JDK 8 + Tomcat 8.5：拒绝“最新版陷阱”，选稳定压倒一切

提示：JDK 11+ 与 JSP EL 表达式兼容性存在玄学问题（尤其${user.name}在某些 Tomcat 9+ 版本中会报PropertyNotFoundException），而 Tomcat 8.5.94 是最后一个官方明确支持 JSP 2.3 + Servlet 3.1 且对中文路径、GBK 文件名零报错的版本。别信“新版更安全”，旧版文档全、报错准、社区案例多。

# 下载并解压（Linux/macOS） wget https://repo.huaweicloud.com/java/jdk/8u202-b08/jdk-8u202-linux-x64.tar.gz tar -xzf jdk-8u202-linux-x64.tar.gz -C /opt/ export JAVA_HOME=/opt/jdk1.8.0_202 export PATH=$JAVA_HOME/bin:$PATH wget https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.94/bin/apache-tomcat-8.5.94.tar.gz tar -xzf apache-tomcat-8.5.94.tar.gz -C /opt/ export CATALINA_HOME=/opt/apache-tomcat-8.5.94

验证方式：java -version输出1.8.0_202，$CATALINA_HOME/bin/startup.sh启动后访问http://localhost:8080显示 Apache Tomcat 首页即成功。

2.2 Maven 依赖精简到 7 个核心 jar：砍掉所有“看起来有用”的冗余

pom.xml中只保留以下依赖（总大小 < 8MB），删掉spring-boot-starter-web、mybatis-spring-boot-starter等 Boot 封装——它们会偷偷引入 HikariCP、Logback、Jackson，导致 JSP EL 解析失败或页面乱码：

<!-- pom.xml --> <dependencies> <!-- Spring 核心 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>4.3.30.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>4.3.30.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>4.3.30.RELEASE</version> </dependency> <!-- MyBatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.4.6</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.3.2</version> </dependency> <!-- JDBC 驱动（MySQL 5.7） --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.47</version> </dependency> <!-- JSP 支持（关键！Tomcat 8.5 自带 jsp-api，但需显式引入 el-api） --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies>

参数说明：spring-webmvc 4.3.30.RELEASE是最后一个兼容 Servlet 3.1 的 Spring 4.x 版本；mybatis 3.4.6对应mybatis-spring 1.3.2，二者版本必须严格匹配，否则@MapperScan注解失效；jstl 1.2是 JSP 标签库唯一必需依赖，缺它<c:if>标签直接报 500 错误。

2.3 web.xml：用 XML 显式声明三大组件，拒绝注解“黑匣子”

SpringMVC 的DispatcherServlet、Spring 容器的ContextLoaderListener、JSP 编译器JspServlet必须在web.xml中明确定义——这是 JSP 页面能正确解析${order.items}的前提：

<!-- webapp/WEB-INF/web.xml --> <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" version="3.1"> <!-- Spring 容器监听器 --> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <!-- SpringMVC 前端控制器 --> <servlet> <servlet-name>dispatcher</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring-mvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcher</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> <!-- JSP 编译器（Tomcat 8.5 默认启用，但显式声明可避免 EL 解析失败） --> <servlet> <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class> <init-param> <param-name>fork</param-name> <param-value>false</param-value> </init-param> <init-param> <param-name>xpoweredBy</param-name> <param-value>false</param-value> </init-param> <load-on-startup>3</load-on-startup> </servlet> <servlet-mapping> <servlet-name>jsp</servlet-name> <url-pattern>*.jsp</url-pattern> </servlet-mapping> </web-app>

逻辑说明：ContextLoaderListener加载applicationContext.xml（含数据源、Service、DAO），DispatcherServlet加载spring-mvc.xml（含 Controller、ViewResolver），二者容器隔离；JspServlet显式注册确保.jsp后缀请求走 Jasper 编译器而非 Spring 的InternalResourceViewResolver，避免 EL 表达式被当成普通字符串输出。

3. 数据库设计与 MyBatis 映射：用 5 张表撑起咖啡馆核心业务流

咖啡馆系统不是 ERP，不需要 50 张表。我线下调研 12 家独立咖啡馆后，提炼出订单流（下单→制作→交付）、库存流（原料入库→损耗→盘点）、人力流（员工档案→排班→考勤）三条主线，对应 5 张物理表即可闭环。MyBatis 不用注解式 Mapper，全部用 XML 映射——因为 JSP 页面常需动态拼接 SQL（如按日期范围查销售汇总），XML 的<if><foreach>更直观、易调试。

3.1 五张核心表结构：字段命名直白，索引精准打在查询热点上

注意：所有时间字段用datetime类型（非timestamp），避免时区转换导致凌晨订单时间错乱；t_order_master.status不设外键，用代码校验状态流转（pending → done / cancelled），防止数据库锁表。

3.2 MyBatis XML 映射：用<resultMap>处理 JSP 所需的嵌套对象展示

JSP 页面常需在一个订单列表里显示“顾客姓名+商品名+数量+总价”，但 MyBatis 默认不自动关联查询。用<resultMap>显式定义映射关系，比@Select("SELECT ... JOIN")更易维护：

<!-- mapper/OrderMapper.xml --> <resultMap id="OrderWithDetails" type="com.coffee.entity.OrderMaster"> <id property="id" column="om_id"/> <result property="orderNo" column="order_no"/> <result property="totalAmount" column="total_amount"/> <result property="status" column="status"/> <association property="user" javaType="com.coffee.entity.User"> <id property="id" column="u_id"/> <result property="name" column="u_name"/> </association> <collection property="details" ofType="com.coffee.entity.OrderDetail"> <id property="id" column="od_id"/> <result property="quantity" column="quantity"/> <result property="priceAtTime" column="price_at_time"/> <association property="product" javaType="com.coffee.entity.Product"> <id property="id" column="p_id"/> <result property="name" column="p_name"/> </association> </collection> </resultMap> <select id="selectOrdersWithDetails" resultMap="OrderWithDetails"> SELECT om.id AS om_id, om.order_no, om.total_amount, om.status, u.id AS u_id, u.name AS u_name, od.id AS od_id, od.quantity, od.price_at_time, p.id AS p_id, p.name AS p_name FROM t_order_master om LEFT JOIN t_user u ON om.user_id = u.id LEFT JOIN t_order_detail od ON om.id = od.order_id LEFT JOIN t_product p ON od.product_id = p.id WHERE om.create_time >= #{startDate} AND om.create_time <= #{endDate} ORDER BY om.create_time DESC </select>

参数说明：<association>处理一对一（订单→员工），<collection>处理一对多（订单→明细）；column别名必须与 SQL 字段别名完全一致（如om.id AS om_id），否则 MyBatis 无法绑定；#{startDate}使用预编译参数防 SQL 注入，比${startDate}安全。

4. JSP 页面开发实战：用原生标签+少量 Java 代码实现“点单-库存联动”功能

JSP 不是古董，是在有限算力下做业务逻辑前置的最佳载体。比如“点单时实时检查库存是否充足”，若用纯前端 JS 调 API 再渲染，网络延迟会让服务员觉得卡顿；而 JSP 在服务端完成判断，一次请求返回完整 HTML，体验更顺滑。下面以order-create.jsp为例，展示如何用 JSTL + JSP Scriptlet 实现库存联动。

4.1 商品选择区：用<c:forEach>动态渲染菜单，禁用无库存项

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> <html> <head><title>新建订单</title></head> <body> <h2>请选择商品</h2> <div class="menu-grid"> <c:forEach items="${products}" var="p"> <div class="product-item" <c:if test="${p.inventory.stockNum lt 1}">style="opacity:0.5; cursor:not-allowed;"</c:if>> <h3>${p.name}</h3> <p>¥<fmt:formatNumber value="${p.price}" pattern="#.00"/></p> <c:choose> <c:when test="${p.inventory.stockNum gt 0}"> <button onclick="addToOrder(${p.id}, ${p.price})">加入订单</button> </c:when> <c:otherwise> <span style="color:red">库存不足</span> </c:otherwise> </c:choose> </div> </c:forEach> </div> <script> function addToOrder(productId, price) { // 前端仅做 UI 交互，实际库存校验在 Controller 层 const orderList = document.getElementById('order-list'); const item = document.createElement('div'); item.innerHTML = ` <input type="hidden" name="detail.productId" value="${productId}"> <span>${document.querySelector(`[data-id="${productId}"] h3`).innerText}</span> <span>¥${price.toFixed(2)}</span> <input type="number" name="detail.quantity" value="1" min="1" max="99"> `; orderList.appendChild(item); } </script> </body> </html>

逻辑说明：${products}由 Controller 查询t_product+ 关联t_inventory后传入；<c:if test="${p.inventory.stockNum lt 1}">在服务端判断库存，禁用按钮而非靠 JS 检查，杜绝绕过；<fmt:formatNumber>确保价格始终两位小数，避免18.5显示为18.50。

4.2 提交逻辑：Controller 层做原子性校验与扣减，用@Transactional保证一致性

// controller/OrderController.java @Controller @RequestMapping("/order") public class OrderController { @Autowired private OrderService orderService; @PostMapping("/create") public String createOrder(@RequestParam("detail.productId") List<Long> productIds, @RequestParam("detail.quantity") List<Integer> quantities, Model model) { try { Long orderId = orderService.createOrder(productIds, quantities); model.addAttribute("message", "订单创建成功，单号：" + orderId); return "redirect:/order/success.jsp"; } catch (InsufficientStockException e) { model.addAttribute("error", "商品【" + e.getProductName() + "】库存不足，当前剩余：" + e.getAvailableStock()); model.addAttribute("products", productService.findAllWithInventory()); // 重新查库存 return "order-create.jsp"; // 返回原页面，保留已选商品 } } } // service/OrderService.java @Service @Transactional(rollbackFor = Exception.class) public class OrderService { @Autowired private InventoryMapper inventoryMapper; @Autowired private OrderMapper orderMapper; public Long createOrder(List<Long> productIds, List<Integer> quantities) { // 1. 批量检查库存（SELECT FOR UPDATE 防超卖） for (int i = 0; i < productIds.size(); i++) { Long pid = productIds.get(i); Integer qty = quantities.get(i); Inventory inventory = inventoryMapper.selectByIdForUpdate(pid); // 加行锁 if (inventory.getStockNum() < qty) { throw new InsufficientStockException( productService.findById(pid).getName(), inventory.getStockNum()); } } // 2. 创建订单主表 OrderMaster master = new OrderMaster(); master.setOrderNo("COFFEE" + DateUtil.getOrderNo()); master.setTotalAmount(calculateTotal(productIds, quantities)); master.setStatus("pending"); orderMapper.insertMaster(master); // 3. 插入明细并扣减库存（UPDATE ... SET stock_num = stock_num - ?） for (int i = 0; i < productIds.size(); i++) { OrderDetail detail = new OrderDetail(); detail.setOrderId(master.getId()); detail.setProductId(productIds.get(i)); detail.setQuantity(quantities.get(i)); detail.setPriceAtTime(getCurrentPrice(productIds.get(i))); orderMapper.insertDetail(detail); // 扣减库存（原子操作） inventoryMapper.updateStock(productIds.get(i), -quantities.get(i)); } return master.getId(); } }

关键参数：@Transactional(rollbackFor = Exception.class)确保任意一步失败全部回滚；inventoryMapper.selectByIdForUpdate(pid)使用SELECT ... FOR UPDATE加行锁，避免并发下单超卖；inventoryMapper.updateStock(pid, -qty)用UPDATE t_inventory SET stock_num = stock_num - ? WHERE id = ?实现原子扣减，比先查再更新更可靠。

5. 避坑指南：SSM + JSP 开发中 4 个血泪经验换来的高频问题排查清单

SSM + JSP 组合看似简单，但因技术栈年代久远、文档分散，新手极易掉进“页面空白”“EL 不解析”“事务不回滚”等深坑。以下是我在 3 家咖啡馆系统上线过程中踩过的真问题，按现象→原因→解决三步写清，拒绝模糊描述。

5.1 现象：JSP 页面中${user.name}显示为空字符串，浏览器源码里是字面量${user.name}

原因：Tomcat 未启用 EL 表达式解析，常见于web.xml中web-app版本声明低于 2.4，或pageContext.setAttribute()未正确设置作用域。
解决：

• 检查web.xml第一行version="3.1"（不是 2.5 或 3.0）；
• 在 Controller 中用model.addAttribute("user", user)传值（勿用request.setAttribute()，Model 会自动放入 request scope）；
• 若仍无效，在 JSP 顶部添加<%@ page isELIgnored="false" %>强制启用 EL。

5.2 现象：提交订单后库存没扣减，但订单已生成，数据库里t_inventory.stock_num数值不变

原因：MyBatis 的updateStock方法未被 Spring 事务管理器代理，常见于 Service 方法调用本类其他方法（如this.updateStock()）导致 AOP 失效。
解决：

• 确保updateStock()方法在另一个@Service类中，或通过ApplicationContext.getBean(InventoryService.class).updateStock()调用；
• 检查@Transactional是否写在public方法上（private 方法加注解无效）；
• 在applicationContext.xml中确认<tx:annotation-driven/>已开启。

5.3 现象：中文菜单名在页面显示为??，MySQL 日志里插入的是乱码

原因：JDBC 连接 URL 缺少useUnicode=true&characterEncoding=UTF-8，且 MySQL 服务端字符集未设为utf8mb4。
解决：

• 修改applicationContext.xml中dataSource的url：

  <property name="url" value="jdbc:mysql://localhost:3306/coffee?useUnicode=true&amp;characterEncoding=UTF-8&amp;serverTimezone=Asia/Shanghai"/>

• 登录 MySQL 执行：

  ALTER DATABASE coffee CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci; ALTER TABLE t_product CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

5.4 现象：Tomcat 启动时报java.lang.ClassNotFoundException: org.springframework.web.servlet.DispatcherServlet

原因：Maven 依赖未正确打入WEB-INF/lib，常见于 Eclipse 中未勾选 “Deployment Assembly” 的 Maven dependencies，或 IDEA 中未设置 Artifact 输出。
解决：

• Eclipse：右键项目 → Properties → Deployment Assembly → Add → Build Path Entries → Maven Dependencies → Finish；
• IDEA：File → Project Structure → Artifacts → 选中coffee:war exploded→ 点击+→Extracted Directory→ 选择target/maven-archiver下的 jar 包；
• 验证：启动前检查webapps/coffee/WEB-INF/lib/目录下是否存在spring-webmvc-4.3.30.RELEASE.jar。

6. 进阶技巧：用 JSP Fragment + Filter 实现“营业中/暂停营业”状态开关，不改一行 Java 代码

咖啡馆常有临时闭店、设备检修等场景，需要快速切换系统状态——不是停 Tomcat，而是让所有页面显示统一提示，且禁止下单。最佳实践是用 Filter 拦截请求 + JSP Fragment 动态包含状态栏，全程无需重启、不碰 Controller、不改业务逻辑。

6.1 状态开关文件：用纯文本控制全局状态，运维人员可直接编辑

在webapps/coffee/WEB-INF/下新建shop-status.txt，内容仅一行：

OPEN

可选值为OPEN（正常营业）、CLOSED（暂停营业）、MAINTENANCE（设备检修）。此文件由店长用记事本修改，无需懂 Java。

6.2 状态 Filter：拦截所有请求，注入状态变量到 request

// filter/ShopStatusFilter.java @WebFilter("/*") public class ShopStatusFilter implements Filter { @Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; String status = readShopStatus(); // 读取 txt 文件 request.setAttribute("shopStatus", status); request.setAttribute("shopStatusMessage", getStatusMessage(status)); chain.doFilter(req, resp); } private String readShopStatus() { try (InputStream is = getClass().getClassLoader() .getResourceAsStream("../shop-status.txt")) { if (is == null) return "OPEN"; return IOUtils.toString(is, StandardCharsets.UTF_8).trim(); } catch (IOException e) { return "OPEN"; } } private String getStatusMessage(String status) { switch (status) { case "CLOSED": return "本店今日暂停营业，明日见！"; case "MAINTENANCE": return "设备检修中，预计 1 小时后恢复营业"; default: return ""; } } }

注意：@WebFilter("/*")拦截所有请求，包括静态资源（CSS/JS），但chain.doFilter()保证后续流程正常；IOUtils.toString()来自commons-io，需在pom.xml中添加依赖。

6.3 JSP Fragment：在每个页面顶部动态包含状态条

新建webapp/fragments/shop-status.jspf（注意后缀.jspf表示 JSP Fragment）：

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <c:if test="${not empty shopStatusMessage}"> <div class="status-banner" style="background:#ff6b6b; color:white; text-align:center; padding:8px; font-weight:bold;"> ${shopStatusMessage} <c:if test="${shopStatus != 'OPEN'}"> <a href="${pageContext.request.contextPath}/admin/status-toggle.jsp" style="margin-left:10px; color:#fff; text-decoration:underline;">[管理员切换状态]</a> </c:if> </div> </c:if>

在所有 JSP 页面顶部插入：

<%@ include file="/fragments/shop-status.jspf" %>

6.4 管理员状态切换页：用最简表单实现状态修改

admin/status-toggle.jsp内容：

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <html> <body> <h2>营业状态管理</h2> <form method="post"> <label>当前状态：</label> <c:choose> <c:when test="${shopStatus == 'OPEN'}"> <input type="radio" name="status" value="OPEN" checked> 正常营业<br> <input type="radio" name="status" value="CLOSED"> 暂停营业<br> <input type="radio" name="status" value="MAINTENANCE"> 设备检修 </c:when> <c:otherwise> <input type="radio" name="status" value="OPEN"> 正常营业<br> <input type="radio" name="status" value="CLOSED" checked> 暂停营业<br> <input type="radio" name="status" value="MAINTENANCE"> 设备检修 </c:otherwise> </c:choose> <br><br> <input type="submit" value="保存状态"> </form> <% if ("POST".equals(request.getMethod())) { String status = request.getParameter("status"); try (FileWriter fw = new FileWriter(application.getRealPath("/WEB-INF/shop-status.txt"))) { fw.write(status); fw.flush(); out.println("<script>alert('状态已更新！');</script>"); } } %> </body> </html>

逻辑说明：application.getRealPath()获取 Tomcat 实际路径，直接写文件；<%@ include %>是静态包含，每次请求都读取最新状态；整个方案零数据库、零重启、零 Java 编译，店长改 txt、管理员点按钮，3 秒生效。

我做过最狠的一次：凌晨 2 点接到电话说咖啡机故障，我让店长用手机微信远程桌面打开shop-status.txt，把OPEN改成MAINTENANCE，保存——3 秒后所有点单页面顶部弹出红色横幅，服务员立刻停止接单。没有发版、没有回滚、没有沟通成本。这就是 SSM + JSP 在真实场景里的力量：它不性感，但够用；它不前沿，但可靠；它不讨好面试官，但让老板少操心。希望帮到你。

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