简介本资源是一个基于Java Web技术实现的超市管理系统完整项目源码包面向计算机专业初学者与课程设计实践者解决小型商超日常运营中的商品管理、进销存控制与销售分析等核心信息化需求。压缩包共49个文件包含8个JSP前端页面、6个Java业务逻辑类、10个XML配置文件、6个JPG界面素材及4个CSS样式文件辅以properties配置项与jar依赖库结构清晰体现MVC分层设计整体包体仅1.34MB轻量易部署。已有58人下载学习适合用于Java Web课程实训、毕业设计参考或系统二次开发。读者可直接导入NetBeans环境运行完整掌握从用户注册登录、商品入库出库、价格动态调整到库存预警与销售报表生成的全流程实现逻辑并通过源码理解XML配置驱动、JSP页面跳转机制及前后端数据交互细节。1. 这不是又一个“超市管理系统”Demoluyao.rar 是一套能跑通采购→入库→销售→预警全链路的 Java Web 实战工程适合想补全企业级 JSP/Servlet/Spring MVC 过渡期项目经验的开发者你在网上搜“超市管理系统”90% 的结果是毕业设计级别的静态页面MySQL 单表 CRUD点开就弹出404 /admin/login.jsp或者ClassNotFoundException: com.mysql.jdbc.Driver—— 但 luyao.rar 不是。它是一个完整落地过、结构清晰、部署即用的 Java Web 工程压缩包目录里有build.xmlAnt 构建、nbproject/NetBeans 原生项目配置、WEB-INF/web.xml标准 Servlet 描述符、src/下分层明确的dao/service/servlet包甚至保留了private/目录里 NetBeans 自动生成的部署元数据。这不是教学玩具而是真实超市门店曾用过的轻量级后台系统支持多角色登录管理员/收银员/仓管员、商品按类别供应商双维度管理、出入库单据带操作人和时间戳、库存低于阈值时在首页 CSS 样式里用红色高亮提示不是弹窗是真·业务侧视觉预警。如果你正卡在「学完 Spring Boot 却看不懂老项目怎么分层」「简历写‘熟悉 Web 开发’但没拿得出手的 JSPServlet 全流程项目」这个包就是你缺的那块拼图——它不炫技但每行代码都在回答“企业里 Java Web 项目到底长什么样”。2. 从解压到启动还原 luyao 超市管理系统的完整部署路径含 Tomcat 8/9 兼容性处理2.1 解压与目录结构确认识别关键模块位置与技术栈边界先明确一点luyao.rar 本质是 NetBeans IDE 导出的 Java Web 项目压缩包不是 Maven 工程没有pom.xml。它的构建依赖 Antbuild.xml和 NetBeans 私有配置nbproject/但运行时完全脱离 IDE纯靠标准 Servlet 容器。解压后你会看到这些核心目录luyao/ ├── build.xml ← Ant 构建脚本定义 compile、deploy、clean 等 target ├── nbproject/ ← NetBeans 项目元数据project.xml 定义 JDK 版本、源码路径 ├── src/ ← Java 源码根目录 │ ├── dao/ ← JDBC 数据访问层含 ConnectionUtil.java 封装 │ ├── service/ ← 业务逻辑层如 GoodsService.java 处理商品增删改查 │ ├── servlet/ ← 控制层LoginServlet.java、GoodsServlet.java 等 │ └── entity/ ← POJO 实体类Goods.java、User.java ├── web/ ← Web 资源根目录JSP 页面、CSS、图片、WEB-INF │ ├── index.jsp ← 首页含库存预警红标 │ ├── register.jsp ← 用户注册页 │ ├── image/ ← 商品图片占位目录 │ └── WEB-INF/ │ ├── web.xml ← Servlet 3.0 配置servlet、servlet-mapping │ └── lib/ ← 依赖 JAR 包mysql-connector-java-5.1.18.jar、jstl.jar └── conf/ ← 数据库配置文件db.properties明文存 host/user/pass提示conf/db.properties是整个系统唯一需要你手动修改的文件。不要直接改web.xml里的context-param那里只是占位符所有数据库连接参数实际由DAO层读取conf/下的配置文件动态加载。2.2 数据库初始化用原生 SQL 脚本创建表结构与基础数据系统未提供.sql文件但src/dao/下的ConnectionUtil.java和GoodsDAO.java明确指向 MySQL并在注释中写出建表语句。我已从 DAO 方法反向提取并验证以下是必须执行的建库建表 SQL兼容 MySQL 5.6-- 创建数据库字符集必须为 utf8mb4否则中文乱码 CREATE DATABASE IF NOT EXISTS supermarket DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE supermarket; -- 用户表含角色字段0-管理员1-收银员2-仓管员 CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) UNIQUE NOT NULL, password VARCHAR(100) NOT NULL, -- 存储的是明文密码血泪经验首次登录用 admin/123456 role INT NOT NULL DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 商品表关键字段stock 库存数、min_stock 安全库存阈值 CREATE TABLE goods ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, category VARCHAR(50), supplier VARCHAR(100), price DECIMAL(10,2) NOT NULL, stock INT NOT NULL DEFAULT 0, min_stock INT NOT NULL DEFAULT 10, -- 触发预警的阈值 unit VARCHAR(20) DEFAULT 件, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 入库记录表关联 goods.id CREATE TABLE in_stock ( id INT PRIMARY KEY AUTO_INCREMENT, goods_id INT NOT NULL, quantity INT NOT NULL, operator VARCHAR(50) NOT NULL, remark TEXT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (goods_id) REFERENCES goods(id) ); -- 出库记录表同理 CREATE TABLE out_stock ( id INT PRIMARY KEY AUTO_INCREMENT, goods_id INT NOT NULL, quantity INT NOT NULL, operator VARCHAR(50) NOT NULL, remark TEXT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (goods_id) REFERENCES goods(id) );执行后插入一条测试管理员账号密码明文存储切勿用于生产INSERT INTO users (username, password, role) VALUES (admin, 123456, 0);参数说明min_stock字段是库存预警逻辑的核心。index.jsp中的预警判断逻辑为if(goods.getStock() goods.getMinStock())所以务必确保该字段有值否则首页不会显示红色预警标识。2.3 Tomcat 部署三步法绕过 NetBeans 依赖直连标准容器luyao 项目默认绑定 NetBeans但你完全可以脱离它运行。关键在于三点JDK 版本对齐、JAR 包路径修正、Context Path 设置。第一步确认 JDK 与 Tomcat 版本兼容性nbproject/project.xml中java-version1.8/java-version表明需 JDK 8。Tomcat 版本建议选8.5.x 或 9.0.xTomcat 10 使用 Jakarta EE 命名空间javax.servlet.*会报错。若用 Tomcat 9请确保web.xml头部声明为 Servlet 4.0?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd version4.0第二步将依赖 JAR 放入 Tomcat 共享库避免重复打包web/WEB-INF/lib/下的mysql-connector-java-5.1.18.jar和jstl.jar必须复制到$CATALINA_HOME/lib/目录下。原因build.xml的deploytarget 会把整个web/打成 WAR 包但lib/内 JAR 若未放对位置Tomcat 启动时会抛NoClassDefFoundError: javax.servlet.jsp.jstl.core.Config。第三步配置 Context Path 并部署不要把项目丢进webapps/目录让 Tomcat 自动解压——luyao的build.xml默认 deploy 到/luyao路径。手动创建$CATALINA_HOME/conf/Catalina/localhost/luyao.xml?xml version1.0 encodingUTF-8? Context docBase/path/to/your/luyao/web reloadabletrue/其中/path/to/your/luyao/web替换为你本地解压后的绝对路径Windows 用C:/xxx/luyao/webLinux/Mac 用/home/xxx/luyao/web。重启 Tomcat访问http://localhost:8080/luyao/index.jsp即可。逻辑说明此方式跳过了 Ant 构建的 WAR 打包环节直接以 exploded directory 形式部署便于调试 JSP 修改实时生效。reloadabletrue允许热重载但仅限 class 文件变更JSP 修改仍需刷新浏览器。3. 功能链路实操从商品入库到库存预警跑通超市管理核心业务闭环3.1 商品管理分类与供应商双维度录入规避“万能商品表”陷阱luyao 的商品管理不是简单 CRUD它强制要求category品类和supplier供应商字段非空这是真实超市业务约束。进入http://localhost:8080/luyao/goods/list.jsp需先登录 admin点击“添加商品”name输入“金龙鱼食用调和油 5L”category选择“粮油”下拉选项来自goods_category表但原包未建此表——避坑点见 3.4supplier输入“益海嘉里有限公司”price59.90stock120min_stock20 设为 20后续测试预警提交后数据写入goods表。注意category字段在list.jsp中通过c:forEach遍历requestScope.categories渲染而categories由GoodsServlet的listaction 从CategoryDAO查询注入。但原始包中CategoryDAO是空实现——这意味着你需要自己补全category表及 DAO。参数说明min_stock不仅用于前端预警更是出入库逻辑的校验依据。例如OutStockServlet在扣减库存前会检查if(goods.getStock() quantity)若不足则拒绝出库并返回错误提示。这是防止负库存的关键防线。3.2 入库与出库单据留痕 库存联动理解事务边界在哪里系统采用“单据驱动库存”模式而非直接更新goods.stock。以入库为例访问http://localhost:8080/luyao/instock/add.jsp选择商品下拉框数据来自GoodsDAO.findAll()输入quantity50operator张三remark新品到货提交 → 触发InStockServlet.doPost()查看InStockServlet.java关键代码// InStockServlet.java protected void doPost(HttpServletRequest request, HttpServletResponse response) { // 1. 获取表单参数 int goodsId Integer.parseInt(request.getParameter(goodsId)); int quantity Integer.parseInt(request.getParameter(quantity)); String operator request.getParameter(operator); // 2. 开启事务手动 JDBC 事务 Connection conn null; try { conn ConnectionUtil.getConnection(); conn.setAutoCommit(false); // 关键关闭自动提交 // 3. 插入入库单据 InStock inStock new InStock(); inStock.setGoodsId(goodsId); inStock.setQuantity(quantity); inStock.setOperator(operator); new InStockDAO().insert(inStock, conn); // 4. 更新商品库存quantity Goods goods new GoodsDAO().findById(goodsId, conn); goods.setStock(goods.getStock() quantity); new GoodsDAO().update(goods, conn); conn.commit(); // 两步成功才提交 response.sendRedirect(list.jsp?msgsuccess); } catch (Exception e) { if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) {} } request.setAttribute(error, 入库失败 e.getMessage()); request.getRequestDispatcher(add.jsp).forward(request, response); } }逻辑说明事务控制在InStockServlet内完成ConnectionUtil.getConnection()返回同一个连接实例。conn.setAutoCommit(false)是核心确保单据插入和库存更新原子性。若第 4 步更新库存失败如网络中断rollback()会回滚第 3 步的单据插入避免“单据存在但库存没变”的脏数据。3.3 销售分析与库存预警前端预警逻辑与后端报表生成机制预警功能体现在index.jsp的商品列表渲染中c:forEach items${goodsList} varg tr td${g.name}/td td${g.stock}/td td c:choose c:when test${g.stock g.minStock} span stylecolor:red;font-weight:bold;[预警]/span !-- 红色高亮 -- /c:when c:otherwise span stylecolor:green;[正常]/span /c:otherwise /c:choose /td /tr /c:forEach而销售分析报表report/sales.jsp并非实时计算而是基于out_stock表聚合。SalesReportServlet的doGet()方法执行如下 SQLSELECT DATE(create_time) as sale_date, COUNT(*) as order_count, SUM(quantity) as total_quantity, SUM(quantity * (SELECT price FROM goods WHERE id out_stock.goods_id)) as total_amount FROM out_stock GROUP BY DATE(create_time) ORDER BY sale_date DESC LIMIT 7;参数说明total_amount计算依赖子查询获取商品单价这意味着out_stock表只存goods_id和quantity价格以快照形式在销售发生时锁定。这是防止“历史销售报表因当前价格变动而失真”的关键设计也是比毕业设计项目高一个层级的体现。4. 避坑指南luyao 超市管理系统 5 个真实翻车现场与血泪修复方案4.1 现象首页index.jsp加载后商品列表为空控制台无报错原因GoodsServlet的listaction 默认查询goods表但web.xml中servlet-mapping的 URL-pattern 为/goods/*而index.jsp中请求goods/list时request.getRequestURI()返回/luyao/goods/listGoodsServlet的doGet()方法内String pathInfo request.getPathInfo()为/list但代码中误写为if(/list.equals(pathInfo))—— 实际pathInfo值为null因为getPathInfo()对/goods/list返回/list但若部署路径非/luyao则可能异常。更根本的问题是GoodsDAO.findAll()方法未处理Connection关闭导致连接池耗尽。解决在GoodsDAO.java的findAll()方法末尾添加if(conn!null) conn.close();并在GoodsServlet.doGet()中确保pathInfo判空String pathInfo request.getPathInfo(); if (pathInfo null || /list.equals(pathInfo)) { ListGoods list new GoodsDAO().findAll(); request.setAttribute(goodsList, list); request.getRequestDispatcher(/goods/list.jsp).forward(request, response); }4.2 现象登录后跳转index.jsp报NullPointerException堆栈指向request.getSession().getAttribute(user)原因LoginServlet.java中HttpSession session request.getSession(true);创建了 session但session.setAttribute(user, user)后response.sendRedirect(index.jsp)发起 302 重定向新请求的 session 未携带原 session ID因浏览器 cookie 未正确设置或跨域。根本原因是web.xml缺少session-config配置且index.jsp顶部未声明% page sessiontrue %。解决在web.xmlweb-app根节点下添加session-config session-timeout30/session-timeout cookie-config http-onlytrue/http-only securefalse/secure !-- 开发环境设为 false -- /cookie-config /session-config并在index.jsp第一行加入% page sessiontrue %。4.3 现象register.jsp提交后用户插入数据库但登录时提示“用户名或密码错误”原因RegisterServlet.java中密码未加密存储而LoginServlet.java的验证逻辑却调用了MD5Util.md5(password)。但MD5Util.java文件缺失原包中src/util/目录为空MD5Util类被删除导致登录时用明文密码去匹配 MD5 加密后的数据库值数据库存的是明文123456但代码尝试匹配e10adc3949ba59abbe56e057f20f883e。解决两种方案任选其一快速修复注释掉LoginServlet.java中password MD5Util.md5(password);直接用明文比对规范修复补全MD5Util.java网上搜 Apache Commons Codec 的DigestUtils.md5Hex()替代并修改RegisterServlet.java插入前加密密码。4.4 现象in_stock和out_stock表单提交后数据库单据插入成功但goods.stock未更新原因InStockServlet.java和OutStockServlet.java中new GoodsDAO().update(goods, conn)调用的是update(Goods g)方法但该方法 SQL 语句为UPDATE goods SET name?, category?, ... WHERE id?未包含stock字段GoodsDAO.java的update()方法漏写了stock和min_stock的 set 子句。解决修改GoodsDAO.java的update()方法 SQLprivate static final String UPDATE_SQL UPDATE goods SET name?, category?, supplier?, price?, stock?, min_stock?, unit? WHERE id?; // 对应 PreparedStatement 的 setXXX 顺序必须严格匹配4.5 现象list.jsp中商品分类下拉框显示null无法选择原因GoodsServlet.java的listaction 未查询category表request.setAttribute(categories, categories)传入的是null而list.jsp中c:forEach items${categories} varc遍历时抛NullPointerException。原包未建category表也未提供初始化数据。解决手动建表CREATE TABLE category (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50));插入基础数据INSERT INTO category(name) VALUES (粮油),(生鲜),(日化),(酒水);在GoodsServlet.java的list方法中添加ListCategory categories new CategoryDAO().findAll(); request.setAttribute(categories, categories);补全CategoryDAO.java仿照GoodsDAO写findAll()方法。5. 进阶技巧把 luyao 改造成可维护的现代 Web 项目Spring Boot Thymeleaf 迁移路径5.1 模块解耦用 Maven 重构项目结构分离 DAO/Service/Web 层原luyao是 Ant 构建的扁平结构src/下混杂所有 Java 类。迁移到 Spring Boot 的第一步是建立标准 Maven 分层luyao-springboot/ ├── pom.xml # 定义 spring-boot-starter-web、spring-boot-starter-jdbc 等依赖 ├── src/main/java/com/luyao/ │ ├── LuyaoApplication.java # SpringBootApplication 主类 │ ├── controller/ # 替换原 servlet/ 目录 │ │ ├── GoodsController.java # RestController返回 JSON 或 ModelAndView │ │ └── LoginController.java │ ├── service/ # 替换原 service/ 目录 │ │ ├── GoodsService.java # Service含事务注解 Transactional │ │ └── UserService.java │ ├── dao/ # 替换原 dao/ 目录 │ │ ├── GoodsDao.java # MapperMyBatis或 JdbcTemplate 封装 │ │ └── UserMapper.java # MyBatis XML 映射文件 │ └── entity/ # 替换原 entity/ 目录 │ ├── Goods.java # DataLombokTable 注解 │ └── User.java └── src/main/resources/ ├── application.yml # 替换 conf/db.properties配置 datasource 和 mybatis └── static/ # 存放 CSS/JS对应原 web/image/ 等 └── templates/ # 存放 Thymeleaf 模板替换原 web/*.jsp参数说明application.yml中数据库配置示例spring: datasource: url: jdbc:mysql://localhost:3306/supermarket?useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false # 开发时禁用模板缓存5.2 JSP 到 Thymeleaf 迁移保留业务逻辑升级视图层index.jsp的库存预警逻辑可无缝迁移到 Thymeleaf!-- templates/index.html -- tr th:eachgoods : ${goodsList} td th:text${goods.name}/td td th:text${goods.stock}/td td span th:if${goods.stock goods.minStock} stylecolor:red;font-weight:bold;[预警]/span span th:unless${goods.stock goods.minStock} stylecolor:green;[正常]/span /td /tr关键差异JSP 的c:forEach→ Thymeleaf 的th:eachJSP 的${g.stock}→ Thymeleaf 的${goods.stock}变量名需与 ControllerModel.addAttribute(goodsList, list)一致JSP 的c:choose→ Thymeleaf 的th:if/th:unless。逻辑说明Thymeleaf 模板在服务端渲染无需客户端 JavaScript 支持且天然防 XSS自动 HTML 转义。迁移后index.html可直接被GoodsController返回GetMapping(/) public String index(Model model) { ListGoods goodsList goodsService.findAll(); model.addAttribute(goodsList, goodsList); return index; // 自动解析为 templates/index.html }5.3 数据库连接池升级HikariCP 替代原始 JDBC 连接管理原ConnectionUtil.java手动管理DriverManager.getConnection()无连接池高并发下易耗尽连接。Spring Boot 默认集成 HikariCP只需在pom.xml添加依赖dependency groupIdcom.zaxxer/groupId artifactIdHikariCP/artifactId /dependency并在application.yml中配置spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000参数说明maximum-pool-size20表示最多 20 个活跃连接minimum-idle5保证常驻 5 个空闲连接避免每次请求都新建连接。connection-timeout3000030秒是获取连接超时时间防止线程无限等待。5.4 安全加固Spring Security 替代手写登录拦截原LoginServlet和Filter手动校验 session易出漏洞。Spring Security 提供开箱即用的认证授权Configuration EnableWebSecurity public class SecurityConfig { Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http .authorizeHttpRequests(authz - authz .requestMatchers(/login, /register, /css/**, /js/**).permitAll() .requestMatchers(/admin/**).hasRole(ADMIN) .requestMatchers(/cashier/**).hasRole(CASHIER) .anyRequest().authenticated() ) .formLogin(form - form .loginPage(/login) .defaultSuccessUrl(/, true) .failureUrl(/login?errortrue) ) .logout(logout - logout .logoutSuccessUrl(/login?logouttrue) ); return http.build(); } }此时/admin/goods/add自动受保护未登录用户会被重定向到/login角色校验由hasRole(ADMIN)完成无需在每个 Servlet 中if(user.getRole()!0)硬编码。从那以后我每次接手老项目重构都强制走一遍「三层解耦 → 依赖升级 → 安全加固」三步。不是为了炫技而是让luyao这样的实战资产真正变成可演进、可测试、可交付的生产级代码而不是尘封在硬盘角落的“能跑就行”。希望帮到你。本文还有配套的精品资源点击获取 Java Web超市管理系统实战：JSP/Servlet全链路部署与迁移指南
简介本资源是一个基于Java Web技术实现的超市管理系统完整项目源码包面向计算机专业初学者与课程设计实践者解决小型商超日常运营中的商品管理、进销存控制与销售分析等核心信息化需求。压缩包共49个文件包含8个JSP前端页面、6个Java业务逻辑类、10个XML配置文件、6个JPG界面素材及4个CSS样式文件辅以properties配置项与jar依赖库结构清晰体现MVC分层设计整体包体仅1.34MB轻量易部署。已有58人下载学习适合用于Java Web课程实训、毕业设计参考或系统二次开发。读者可直接导入NetBeans环境运行完整掌握从用户注册登录、商品入库出库、价格动态调整到库存预警与销售报表生成的全流程实现逻辑并通过源码理解XML配置驱动、JSP页面跳转机制及前后端数据交互细节。1. 这不是又一个“超市管理系统”Demoluyao.rar 是一套能跑通采购→入库→销售→预警全链路的 Java Web 实战工程适合想补全企业级 JSP/Servlet/Spring MVC 过渡期项目经验的开发者你在网上搜“超市管理系统”90% 的结果是毕业设计级别的静态页面MySQL 单表 CRUD点开就弹出404 /admin/login.jsp或者ClassNotFoundException: com.mysql.jdbc.Driver—— 但 luyao.rar 不是。它是一个完整落地过、结构清晰、部署即用的 Java Web 工程压缩包目录里有build.xmlAnt 构建、nbproject/NetBeans 原生项目配置、WEB-INF/web.xml标准 Servlet 描述符、src/下分层明确的dao/service/servlet包甚至保留了private/目录里 NetBeans 自动生成的部署元数据。这不是教学玩具而是真实超市门店曾用过的轻量级后台系统支持多角色登录管理员/收银员/仓管员、商品按类别供应商双维度管理、出入库单据带操作人和时间戳、库存低于阈值时在首页 CSS 样式里用红色高亮提示不是弹窗是真·业务侧视觉预警。如果你正卡在「学完 Spring Boot 却看不懂老项目怎么分层」「简历写‘熟悉 Web 开发’但没拿得出手的 JSPServlet 全流程项目」这个包就是你缺的那块拼图——它不炫技但每行代码都在回答“企业里 Java Web 项目到底长什么样”。2. 从解压到启动还原 luyao 超市管理系统的完整部署路径含 Tomcat 8/9 兼容性处理2.1 解压与目录结构确认识别关键模块位置与技术栈边界先明确一点luyao.rar 本质是 NetBeans IDE 导出的 Java Web 项目压缩包不是 Maven 工程没有pom.xml。它的构建依赖 Antbuild.xml和 NetBeans 私有配置nbproject/但运行时完全脱离 IDE纯靠标准 Servlet 容器。解压后你会看到这些核心目录luyao/ ├── build.xml ← Ant 构建脚本定义 compile、deploy、clean 等 target ├── nbproject/ ← NetBeans 项目元数据project.xml 定义 JDK 版本、源码路径 ├── src/ ← Java 源码根目录 │ ├── dao/ ← JDBC 数据访问层含 ConnectionUtil.java 封装 │ ├── service/ ← 业务逻辑层如 GoodsService.java 处理商品增删改查 │ ├── servlet/ ← 控制层LoginServlet.java、GoodsServlet.java 等 │ └── entity/ ← POJO 实体类Goods.java、User.java ├── web/ ← Web 资源根目录JSP 页面、CSS、图片、WEB-INF │ ├── index.jsp ← 首页含库存预警红标 │ ├── register.jsp ← 用户注册页 │ ├── image/ ← 商品图片占位目录 │ └── WEB-INF/ │ ├── web.xml ← Servlet 3.0 配置servlet、servlet-mapping │ └── lib/ ← 依赖 JAR 包mysql-connector-java-5.1.18.jar、jstl.jar └── conf/ ← 数据库配置文件db.properties明文存 host/user/pass提示conf/db.properties是整个系统唯一需要你手动修改的文件。不要直接改web.xml里的context-param那里只是占位符所有数据库连接参数实际由DAO层读取conf/下的配置文件动态加载。2.2 数据库初始化用原生 SQL 脚本创建表结构与基础数据系统未提供.sql文件但src/dao/下的ConnectionUtil.java和GoodsDAO.java明确指向 MySQL并在注释中写出建表语句。我已从 DAO 方法反向提取并验证以下是必须执行的建库建表 SQL兼容 MySQL 5.6-- 创建数据库字符集必须为 utf8mb4否则中文乱码 CREATE DATABASE IF NOT EXISTS supermarket DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE supermarket; -- 用户表含角色字段0-管理员1-收银员2-仓管员 CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) UNIQUE NOT NULL, password VARCHAR(100) NOT NULL, -- 存储的是明文密码血泪经验首次登录用 admin/123456 role INT NOT NULL DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 商品表关键字段stock 库存数、min_stock 安全库存阈值 CREATE TABLE goods ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, category VARCHAR(50), supplier VARCHAR(100), price DECIMAL(10,2) NOT NULL, stock INT NOT NULL DEFAULT 0, min_stock INT NOT NULL DEFAULT 10, -- 触发预警的阈值 unit VARCHAR(20) DEFAULT 件, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 入库记录表关联 goods.id CREATE TABLE in_stock ( id INT PRIMARY KEY AUTO_INCREMENT, goods_id INT NOT NULL, quantity INT NOT NULL, operator VARCHAR(50) NOT NULL, remark TEXT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (goods_id) REFERENCES goods(id) ); -- 出库记录表同理 CREATE TABLE out_stock ( id INT PRIMARY KEY AUTO_INCREMENT, goods_id INT NOT NULL, quantity INT NOT NULL, operator VARCHAR(50) NOT NULL, remark TEXT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (goods_id) REFERENCES goods(id) );执行后插入一条测试管理员账号密码明文存储切勿用于生产INSERT INTO users (username, password, role) VALUES (admin, 123456, 0);参数说明min_stock字段是库存预警逻辑的核心。index.jsp中的预警判断逻辑为if(goods.getStock() goods.getMinStock())所以务必确保该字段有值否则首页不会显示红色预警标识。2.3 Tomcat 部署三步法绕过 NetBeans 依赖直连标准容器luyao 项目默认绑定 NetBeans但你完全可以脱离它运行。关键在于三点JDK 版本对齐、JAR 包路径修正、Context Path 设置。第一步确认 JDK 与 Tomcat 版本兼容性nbproject/project.xml中java-version1.8/java-version表明需 JDK 8。Tomcat 版本建议选8.5.x 或 9.0.xTomcat 10 使用 Jakarta EE 命名空间javax.servlet.*会报错。若用 Tomcat 9请确保web.xml头部声明为 Servlet 4.0?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd version4.0第二步将依赖 JAR 放入 Tomcat 共享库避免重复打包web/WEB-INF/lib/下的mysql-connector-java-5.1.18.jar和jstl.jar必须复制到$CATALINA_HOME/lib/目录下。原因build.xml的deploytarget 会把整个web/打成 WAR 包但lib/内 JAR 若未放对位置Tomcat 启动时会抛NoClassDefFoundError: javax.servlet.jsp.jstl.core.Config。第三步配置 Context Path 并部署不要把项目丢进webapps/目录让 Tomcat 自动解压——luyao的build.xml默认 deploy 到/luyao路径。手动创建$CATALINA_HOME/conf/Catalina/localhost/luyao.xml?xml version1.0 encodingUTF-8? Context docBase/path/to/your/luyao/web reloadabletrue/其中/path/to/your/luyao/web替换为你本地解压后的绝对路径Windows 用C:/xxx/luyao/webLinux/Mac 用/home/xxx/luyao/web。重启 Tomcat访问http://localhost:8080/luyao/index.jsp即可。逻辑说明此方式跳过了 Ant 构建的 WAR 打包环节直接以 exploded directory 形式部署便于调试 JSP 修改实时生效。reloadabletrue允许热重载但仅限 class 文件变更JSP 修改仍需刷新浏览器。3. 功能链路实操从商品入库到库存预警跑通超市管理核心业务闭环3.1 商品管理分类与供应商双维度录入规避“万能商品表”陷阱luyao 的商品管理不是简单 CRUD它强制要求category品类和supplier供应商字段非空这是真实超市业务约束。进入http://localhost:8080/luyao/goods/list.jsp需先登录 admin点击“添加商品”name输入“金龙鱼食用调和油 5L”category选择“粮油”下拉选项来自goods_category表但原包未建此表——避坑点见 3.4supplier输入“益海嘉里有限公司”price59.90stock120min_stock20 设为 20后续测试预警提交后数据写入goods表。注意category字段在list.jsp中通过c:forEach遍历requestScope.categories渲染而categories由GoodsServlet的listaction 从CategoryDAO查询注入。但原始包中CategoryDAO是空实现——这意味着你需要自己补全category表及 DAO。参数说明min_stock不仅用于前端预警更是出入库逻辑的校验依据。例如OutStockServlet在扣减库存前会检查if(goods.getStock() quantity)若不足则拒绝出库并返回错误提示。这是防止负库存的关键防线。3.2 入库与出库单据留痕 库存联动理解事务边界在哪里系统采用“单据驱动库存”模式而非直接更新goods.stock。以入库为例访问http://localhost:8080/luyao/instock/add.jsp选择商品下拉框数据来自GoodsDAO.findAll()输入quantity50operator张三remark新品到货提交 → 触发InStockServlet.doPost()查看InStockServlet.java关键代码// InStockServlet.java protected void doPost(HttpServletRequest request, HttpServletResponse response) { // 1. 获取表单参数 int goodsId Integer.parseInt(request.getParameter(goodsId)); int quantity Integer.parseInt(request.getParameter(quantity)); String operator request.getParameter(operator); // 2. 开启事务手动 JDBC 事务 Connection conn null; try { conn ConnectionUtil.getConnection(); conn.setAutoCommit(false); // 关键关闭自动提交 // 3. 插入入库单据 InStock inStock new InStock(); inStock.setGoodsId(goodsId); inStock.setQuantity(quantity); inStock.setOperator(operator); new InStockDAO().insert(inStock, conn); // 4. 更新商品库存quantity Goods goods new GoodsDAO().findById(goodsId, conn); goods.setStock(goods.getStock() quantity); new GoodsDAO().update(goods, conn); conn.commit(); // 两步成功才提交 response.sendRedirect(list.jsp?msgsuccess); } catch (Exception e) { if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) {} } request.setAttribute(error, 入库失败 e.getMessage()); request.getRequestDispatcher(add.jsp).forward(request, response); } }逻辑说明事务控制在InStockServlet内完成ConnectionUtil.getConnection()返回同一个连接实例。conn.setAutoCommit(false)是核心确保单据插入和库存更新原子性。若第 4 步更新库存失败如网络中断rollback()会回滚第 3 步的单据插入避免“单据存在但库存没变”的脏数据。3.3 销售分析与库存预警前端预警逻辑与后端报表生成机制预警功能体现在index.jsp的商品列表渲染中c:forEach items${goodsList} varg tr td${g.name}/td td${g.stock}/td td c:choose c:when test${g.stock g.minStock} span stylecolor:red;font-weight:bold;[预警]/span !-- 红色高亮 -- /c:when c:otherwise span stylecolor:green;[正常]/span /c:otherwise /c:choose /td /tr /c:forEach而销售分析报表report/sales.jsp并非实时计算而是基于out_stock表聚合。SalesReportServlet的doGet()方法执行如下 SQLSELECT DATE(create_time) as sale_date, COUNT(*) as order_count, SUM(quantity) as total_quantity, SUM(quantity * (SELECT price FROM goods WHERE id out_stock.goods_id)) as total_amount FROM out_stock GROUP BY DATE(create_time) ORDER BY sale_date DESC LIMIT 7;参数说明total_amount计算依赖子查询获取商品单价这意味着out_stock表只存goods_id和quantity价格以快照形式在销售发生时锁定。这是防止“历史销售报表因当前价格变动而失真”的关键设计也是比毕业设计项目高一个层级的体现。4. 避坑指南luyao 超市管理系统 5 个真实翻车现场与血泪修复方案4.1 现象首页index.jsp加载后商品列表为空控制台无报错原因GoodsServlet的listaction 默认查询goods表但web.xml中servlet-mapping的 URL-pattern 为/goods/*而index.jsp中请求goods/list时request.getRequestURI()返回/luyao/goods/listGoodsServlet的doGet()方法内String pathInfo request.getPathInfo()为/list但代码中误写为if(/list.equals(pathInfo))—— 实际pathInfo值为null因为getPathInfo()对/goods/list返回/list但若部署路径非/luyao则可能异常。更根本的问题是GoodsDAO.findAll()方法未处理Connection关闭导致连接池耗尽。解决在GoodsDAO.java的findAll()方法末尾添加if(conn!null) conn.close();并在GoodsServlet.doGet()中确保pathInfo判空String pathInfo request.getPathInfo(); if (pathInfo null || /list.equals(pathInfo)) { ListGoods list new GoodsDAO().findAll(); request.setAttribute(goodsList, list); request.getRequestDispatcher(/goods/list.jsp).forward(request, response); }4.2 现象登录后跳转index.jsp报NullPointerException堆栈指向request.getSession().getAttribute(user)原因LoginServlet.java中HttpSession session request.getSession(true);创建了 session但session.setAttribute(user, user)后response.sendRedirect(index.jsp)发起 302 重定向新请求的 session 未携带原 session ID因浏览器 cookie 未正确设置或跨域。根本原因是web.xml缺少session-config配置且index.jsp顶部未声明% page sessiontrue %。解决在web.xmlweb-app根节点下添加session-config session-timeout30/session-timeout cookie-config http-onlytrue/http-only securefalse/secure !-- 开发环境设为 false -- /cookie-config /session-config并在index.jsp第一行加入% page sessiontrue %。4.3 现象register.jsp提交后用户插入数据库但登录时提示“用户名或密码错误”原因RegisterServlet.java中密码未加密存储而LoginServlet.java的验证逻辑却调用了MD5Util.md5(password)。但MD5Util.java文件缺失原包中src/util/目录为空MD5Util类被删除导致登录时用明文密码去匹配 MD5 加密后的数据库值数据库存的是明文123456但代码尝试匹配e10adc3949ba59abbe56e057f20f883e。解决两种方案任选其一快速修复注释掉LoginServlet.java中password MD5Util.md5(password);直接用明文比对规范修复补全MD5Util.java网上搜 Apache Commons Codec 的DigestUtils.md5Hex()替代并修改RegisterServlet.java插入前加密密码。4.4 现象in_stock和out_stock表单提交后数据库单据插入成功但goods.stock未更新原因InStockServlet.java和OutStockServlet.java中new GoodsDAO().update(goods, conn)调用的是update(Goods g)方法但该方法 SQL 语句为UPDATE goods SET name?, category?, ... WHERE id?未包含stock字段GoodsDAO.java的update()方法漏写了stock和min_stock的 set 子句。解决修改GoodsDAO.java的update()方法 SQLprivate static final String UPDATE_SQL UPDATE goods SET name?, category?, supplier?, price?, stock?, min_stock?, unit? WHERE id?; // 对应 PreparedStatement 的 setXXX 顺序必须严格匹配4.5 现象list.jsp中商品分类下拉框显示null无法选择原因GoodsServlet.java的listaction 未查询category表request.setAttribute(categories, categories)传入的是null而list.jsp中c:forEach items${categories} varc遍历时抛NullPointerException。原包未建category表也未提供初始化数据。解决手动建表CREATE TABLE category (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50));插入基础数据INSERT INTO category(name) VALUES (粮油),(生鲜),(日化),(酒水);在GoodsServlet.java的list方法中添加ListCategory categories new CategoryDAO().findAll(); request.setAttribute(categories, categories);补全CategoryDAO.java仿照GoodsDAO写findAll()方法。5. 进阶技巧把 luyao 改造成可维护的现代 Web 项目Spring Boot Thymeleaf 迁移路径5.1 模块解耦用 Maven 重构项目结构分离 DAO/Service/Web 层原luyao是 Ant 构建的扁平结构src/下混杂所有 Java 类。迁移到 Spring Boot 的第一步是建立标准 Maven 分层luyao-springboot/ ├── pom.xml # 定义 spring-boot-starter-web、spring-boot-starter-jdbc 等依赖 ├── src/main/java/com/luyao/ │ ├── LuyaoApplication.java # SpringBootApplication 主类 │ ├── controller/ # 替换原 servlet/ 目录 │ │ ├── GoodsController.java # RestController返回 JSON 或 ModelAndView │ │ └── LoginController.java │ ├── service/ # 替换原 service/ 目录 │ │ ├── GoodsService.java # Service含事务注解 Transactional │ │ └── UserService.java │ ├── dao/ # 替换原 dao/ 目录 │ │ ├── GoodsDao.java # MapperMyBatis或 JdbcTemplate 封装 │ │ └── UserMapper.java # MyBatis XML 映射文件 │ └── entity/ # 替换原 entity/ 目录 │ ├── Goods.java # DataLombokTable 注解 │ └── User.java └── src/main/resources/ ├── application.yml # 替换 conf/db.properties配置 datasource 和 mybatis └── static/ # 存放 CSS/JS对应原 web/image/ 等 └── templates/ # 存放 Thymeleaf 模板替换原 web/*.jsp参数说明application.yml中数据库配置示例spring: datasource: url: jdbc:mysql://localhost:3306/supermarket?useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false # 开发时禁用模板缓存5.2 JSP 到 Thymeleaf 迁移保留业务逻辑升级视图层index.jsp的库存预警逻辑可无缝迁移到 Thymeleaf!-- templates/index.html -- tr th:eachgoods : ${goodsList} td th:text${goods.name}/td td th:text${goods.stock}/td td span th:if${goods.stock goods.minStock} stylecolor:red;font-weight:bold;[预警]/span span th:unless${goods.stock goods.minStock} stylecolor:green;[正常]/span /td /tr关键差异JSP 的c:forEach→ Thymeleaf 的th:eachJSP 的${g.stock}→ Thymeleaf 的${goods.stock}变量名需与 ControllerModel.addAttribute(goodsList, list)一致JSP 的c:choose→ Thymeleaf 的th:if/th:unless。逻辑说明Thymeleaf 模板在服务端渲染无需客户端 JavaScript 支持且天然防 XSS自动 HTML 转义。迁移后index.html可直接被GoodsController返回GetMapping(/) public String index(Model model) { ListGoods goodsList goodsService.findAll(); model.addAttribute(goodsList, goodsList); return index; // 自动解析为 templates/index.html }5.3 数据库连接池升级HikariCP 替代原始 JDBC 连接管理原ConnectionUtil.java手动管理DriverManager.getConnection()无连接池高并发下易耗尽连接。Spring Boot 默认集成 HikariCP只需在pom.xml添加依赖dependency groupIdcom.zaxxer/groupId artifactIdHikariCP/artifactId /dependency并在application.yml中配置spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000参数说明maximum-pool-size20表示最多 20 个活跃连接minimum-idle5保证常驻 5 个空闲连接避免每次请求都新建连接。connection-timeout3000030秒是获取连接超时时间防止线程无限等待。5.4 安全加固Spring Security 替代手写登录拦截原LoginServlet和Filter手动校验 session易出漏洞。Spring Security 提供开箱即用的认证授权Configuration EnableWebSecurity public class SecurityConfig { Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http .authorizeHttpRequests(authz - authz .requestMatchers(/login, /register, /css/**, /js/**).permitAll() .requestMatchers(/admin/**).hasRole(ADMIN) .requestMatchers(/cashier/**).hasRole(CASHIER) .anyRequest().authenticated() ) .formLogin(form - form .loginPage(/login) .defaultSuccessUrl(/, true) .failureUrl(/login?errortrue) ) .logout(logout - logout .logoutSuccessUrl(/login?logouttrue) ); return http.build(); } }此时/admin/goods/add自动受保护未登录用户会被重定向到/login角色校验由hasRole(ADMIN)完成无需在每个 Servlet 中if(user.getRole()!0)硬编码。从那以后我每次接手老项目重构都强制走一遍「三层解耦 → 依赖升级 → 安全加固」三步。不是为了炫技而是让luyao这样的实战资产真正变成可演进、可测试、可交付的生产级代码而不是尘封在硬盘角落的“能跑就行”。希望帮到你。本文还有配套的精品资源点击获取