简介：这是一套基于JSP+Servlet+MySQL实现的轻量级库存商品管理系统，面向Java Web初学者与课程设计实践者，解决小型仓储场景下的商品信息录入、动态增删改查及库存预警等核心管理需求。资源包共38个文件，涵盖9个Java源码、9个编译后class文件、6个JSP页面（含登录、列表、新增/修改表单页）、2个SQL建表与初始化脚本、1个CSS样式文件及项目配置类文件（如web.xml、.classpath），结构完整，可直接导入MyEclipse运行。压缩包仅148KB，体积精简但功能闭环：支持管理员登录、库存实时刷新、重复商品自动累加、低库存红色警示、必填与数字字段前端校验等实用细节。目前已有1489人学习下载，配套包含数据库脚本、项目说明文档（.doc）及清晰目录结构，便于快速理解MVC分层逻辑、掌握Servlet请求流转与JDBC基础操作，是入门Web开发与数据库交互的典型教学案例。
1. 为什么一个“简易”库存系统，反而最容易在毕设答辩里被问住？
很多同学拿到“简易库存商品管理系统”这个题目时第一反应是松口气：不就是增删改查嘛，JSP写个页面，Servlet转个请求，MySQL建三张表，三天就能跑起来。但去年带某高校课程设计时，A同学的系统在答辩现场被连续追问了12分钟——不是因为功能没做出来，而是当导师点开“商品入库”按钮后输入负数数量，系统直接抛出500错误页；再试一次空字符串入库，页面卡死三秒后跳转到空白页；最后导出Excel时，中文全变成乱码。问题不在“简”，而在于“易”字背后藏着大量被忽略的工程细节：事务边界在哪？并发修改怎么防？数据校验是扔给前端还是后端兜底？这份资源不是教你怎么“跑通”，而是提供一套经真实调试验证、覆盖典型翻车场景、能直接用于答辩演示的最小可行方案。它适合两类人：一是需要交课设/毕设但不想在基础功能上反复返工的学生；二是想快速搭建内部轻量管理工具、又不愿踩Java Web老坑的初级开发者。整套结构清晰、模块解耦、关键路径有日志埋点，连数据库初始化脚本都按开发/测试环境做了分离。
2. 总体架构设计：MVC三层结构与五个核心模块的职责划分
这套系统严格遵循经典Java Web MVC分层模型，但做了针对性精简：去掉Spring等重量级框架，用原生Servlet+JSP实现可控性更强的控制流。整个系统划分为五个物理模块，每个模块对应明确的职责边界和交付物，避免学生常犯的“所有逻辑堆在Servlet里”或“JSP里写Java代码”的反模式。
2.1 模块划分与文件组织逻辑
项目采用标准Eclipse Dynamic Web Project结构，WebContent为根目录，src存放Java类，WEB-INF下配置核心文件。模块划分不是按技术层（如controller/service/dao），而是按业务能力切分，更贴合答辩时“讲清楚每个功能怎么来的”需求：
com.inventory.controller：仅包含7个Servlet类，每个对应一个原子操作（如AddProductServlet、UpdateStockServlet）。禁止跨方法调用，每个Servlet只做三件事：参数解析→业务委托→跳转响应。com.inventory.dao：4个DAO类，严格遵循“一个表一个DAO”原则。ProductDAO处理商品主表，StockDAO管库存流水，CategoryDAO维护分类，LogDAO专写操作日志。所有SQL语句外置到sql.properties，方便答辩时快速切换数据库版本。com.inventory.model：POJO类全部实现Serializable，字段命名与数据库列名完全一致（如product_name→productName），避免Hibernate式映射引发的答辩解释成本。com.inventory.util：3个工具类——DBConnection封装连接池（用Apache Commons DBCP2，非手动new Connection）、Validator做基础校验（非正则轰炸，而是针对库存数量用BigDecimal比对）、ExcelExporter用Apache POI 5.2.4生成UTF-8编码Excel，解决中文乱码顽疾。WebContent/jsp：JSP文件按功能分组，admin/下放管理页，common/放header/footer，error/统一错误页。所有JSP禁用<% %>脚本片段，仅用JSTL标签和EL表达式，确保代码可读性。
提示：答辩时若被问“为什么不用Spring Boot”，可直接展示
web.xml中servlet-mapping的精确路径配置（如/admin/addProduct），说明“原生Servlet能更直观体现HTTP请求生命周期，便于教学演示”。
2.2 数据库设计：四张表与三个关键约束
MySQL 8.0数据库共四张表，设计时重点强化业务语义约束，而非单纯满足范式：
| 表名 | 字段（关键） | 约束说明 | 答辩价值 |
|---|---|---|---|
product | id(PK),code(UNIQUE),name,category_id,unit_price | code设唯一索引，防止重复录入；unit_price用DECIMAL(10,2)避免浮点误差 | 导师常问“怎么保证商品编码不重复”，此处可现场演示插入同编码报错 |
stock | id,product_id(FK),change_type(ENUM: 'IN','OUT'),quantity,operator,create_time | change_type限定枚举值，quantity设CHECK(quantity> 0)，强制业务规则落地 | 解释“为什么库存变更必须记录类型”，引申到审计追溯需求 |
category | id,name,parent_id(允许NULL) | parent_id支持两级分类（如“电子产品”→“手机”），避免过度设计树形结构 | 回应“分类怎么扩展”的质疑，展示实际业务复杂度 |
operation_log | id,action,target_id,detail,ip_address,create_time | detail用TEXT存JSON格式（如{"old_stock":10,"new_stock":15}），兼顾可读性与扩展性 | 证明系统具备基础运维能力，非玩具级 |
-- 初始化脚本节选：预置分类与测试商品 INSERT INTO category (id, name, parent_id) VALUES (1, '电子产品', NULL), (2, '手机', 1), (3, '配件', 1); INSERT INTO product (code, name, category_id, unit_price) VALUES ('P001', 'iPhone 15', 2, 5999.00), ('P002', 'AirPods Pro', 3, 1899.00);这段SQL放在db_init.sql中，答辩前只需执行一次。注意unit_price用小数点而非逗号，避免MySQL导入失败——这是学生最常翻车的点之一。
2.3 请求流转与状态管理：从URL到Session的完整链路
系统采用“URL驱动”而非“Action驱动”，每个功能对应独立URL路径，便于答辩时直接输入地址演示。以“商品入库”为例，完整链路如下：
- 用户访问
/admin/stockIn.jsp→ JSP渲染表单（含商品下拉框、数量输入框） - 提交表单至
/StockInServlet（POST）→ Servlet解析productId、quantity参数 - 调用
StockDAO.addStock()执行INSERT，并在同一个事务中更新product.current_stock - 若成功，重定向至
/admin/stockList.jsp?msg=success；失败则转发至/error/stockError.jsp并传入错误信息
Session仅用于存储用户登录态（userRole=admin），绝不存业务数据。库存查询列表页通过URL参数?page=1&size=10实现分页，避免Session膨胀。所有重定向均用response.sendRedirect()而非RequestDispatcher.forward()，确保浏览器地址栏显示真实路径——答辩时导师会亲自点击地址栏验证流程完整性。
注意：
web.xml中servlet配置必须显式声明<load-on-startup>1</load-on-startup>，确保应用启动时初始化连接池。曾有学生因漏配导致首次访问超时，被质疑“系统稳定性”。
3. 核心功能实现：商品管理、库存流水、分类维护的代码级落地
本章聚焦三个最高频答辩问题模块的实现细节，代码均来自实际可运行版本，参数含义、异常分支、日志埋点全部保留。不讲理论，只说“你复制粘贴后为什么能跑”。
3.1 商品新增：防重复、防空、防SQL注入的三重校验
AddProductServlet.java是第一个被抽检的Servlet。它不做任何业务计算，只做三件事：参数清洗→校验拦截→委托DAO。关键代码如下：
// AddProductServlet.java protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 1. 参数清洗：trim空格，转义HTML特殊字符（防XSS） String code = HTMLFilter.filter(request.getParameter("code")); String name = HTMLFilter.filter(request.getParameter("name")); String categoryIdStr = request.getParameter("category_id"); String priceStr = request.getParameter("unit_price"); // 2. 基础校验：空值、长度、数字格式 if (code == null || code.trim().isEmpty() || code.length() > 20) { request.setAttribute("error", "商品编码不能为空且不超过20位"); request.getRequestDispatcher("/admin/addProduct.jsp").forward(request, response); return; } // 3. 业务校验：唯一性检查（在DAO中用SELECT COUNT(*)实现，非try-catch主键冲突） ProductDAO dao = new ProductDAO(); if (dao.existsByCode(code)) { request.setAttribute("error", "商品编码已存在，请更换"); request.getRequestDispatcher("/admin/addProduct.jsp").forward(request, response); return; } // 4. 安全转换：用BigDecimal处理价格，避免Double精度丢失 BigDecimal price; try { price = new BigDecimal(priceStr); if (price.compareTo(BigDecimal.ZERO) < 0) { throw new NumberFormatException("价格不能为负数"); } } catch (NumberFormatException e) { request.setAttribute("error", "请输入有效价格"); request.getRequestDispatcher("/admin/addProduct.jsp").forward(request, response); return; } // 5. 构造对象并保存 Product product = new Product(); product.setCode(code); product.setName(name); product.setCategoryId(Integer.parseInt(categoryIdStr)); product.setUnitPrice(price); boolean success = dao.addProduct(product); if (success) { // 记录操作日志（异步线程，不影响主流程） LogUtil.logAsync("ADD_PRODUCT", product.getId(), String.format("新增商品：%s(%s)，价格：%s", name, code, price)); response.sendRedirect(request.getContextPath() + "/admin/productList.jsp?msg=add_success"); } else { request.setAttribute("error", "保存失败，请重试"); request.getRequestDispatcher("/admin/addProduct.jsp").forward(request, response); } }设计说明：
HTMLFilter.filter()是自研工具类，用StringEscapeUtils.escapeHtml4()处理，比正则替换更安全；- 唯一性检查用
SELECT COUNT(*) FROM product WHERE code = ?而非依赖数据库主键冲突，因后者需捕获SQLException，答辩时难以解释“为什么不用更简单的方案”； LogUtil.logAsync()用Executors.newSingleThreadExecutor()实现异步写日志，避免IO阻塞影响用户体验——这点常被导师追问“高并发下会不会拖慢系统”。
3.2 库存流水：事务一致性与并发安全的实战方案
库存变更（入库/出库）是系统心脏，必须保证ACID。StockInServlet.java和StockOutServlet.java共享同一套事务管理逻辑，核心在StockDAO.changeStock()方法：
// StockDAO.java public boolean changeStock(int productId, int quantity, String changeType, String operator) { String sql = "INSERT INTO stock (product_id, change_type, quantity, operator) VALUES (?, ?, ?, ?)"; String updateSql = "UPDATE product SET current_stock = current_stock + ? WHERE id = ?"; Connection conn = null; PreparedStatement psInsert = null; PreparedStatement psUpdate = null; try { conn = DBConnection.getConnection(); // 从连接池获取 conn.setAutoCommit(false); // 关键：手动开启事务 // 第一步：记录流水 psInsert = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS); psInsert.setInt(1, productId); psInsert.setString(2, changeType); psInsert.setInt(3, quantity); psInsert.setString(4, operator); psInsert.executeUpdate(); // 第二步：更新商品当前库存（带乐观锁） psUpdate = conn.prepareStatement(updateSql); psUpdate.setInt(1, changeType.equals("IN") ? quantity : -quantity); psUpdate.setInt(2, productId); int rows = psUpdate.executeUpdate(); if (rows == 0) { throw new SQLException("商品不存在或库存更新失败"); } conn.commit(); // 两步都成功才提交 return true; } catch (SQLException e) { if (conn != null) { try { conn.rollback(); // 任一步失败即回滚 } catch (SQLException rollbackEx) { log.error("事务回滚失败", rollbackEx); } } log.error("库存变更失败", e); return false; } finally { // 关闭资源（实际用try-with-resources，此处为简化展示） closeResources(psInsert, psUpdate, conn); } }参数说明与避坑点：
changeType.equals("IN") ? quantity : -quantity：用符号统一处理加减，避免UPDATE ... SET stock = stock - ?时传入负数导致逻辑错误；conn.setAutoCommit(false)必须在获取连接后立即设置，否则后续commit()无效；rows == 0判断是防并发场景：若A线程读取库存为10，B线程同时扣减15，A线程更新时WHERE id = ?匹配不到行，executeUpdate()返回0，此时必须抛异常而非静默失败——这是答辩时证明“考虑了并发”的铁证。
3.3 分类维护：支持两级分类的树形结构简化实现
分类模块常被学生过度设计成无限级树，但实际业务中两级足够。CategoryDAO.java用单表自关联实现：
// CategoryDAO.java public List<Category> getAllCategories() { String sql = "SELECT c1.id, c1.name, c1.parent_id, c2.name as parent_name " + "FROM category c1 LEFT JOIN category c2 ON c1.parent_id = c2.id " + "ORDER BY c2.name, c1.name"; // 执行查询后，将结果组装为List<Category>，其中Category类含parentName字段 }JSP中渲染时用嵌套循环：
<!-- admin/categoryList.jsp --> <c:forEach items="${categories}" var="cat"> <c:choose> <c:when test="${empty cat.parentId}"> <!-- 一级分类 --> <tr class="level-1"> <td>${cat.name}</td> <td>无</td> <td><a href="editCategory.jsp?id=${cat.id}">编辑</a></td> </tr> </c:when> <c:otherwise> <!-- 二级分类 --> <tr class="level-2"> <td> └ ${cat.name}</td> <td>${cat.parentName}</td> <td><a href="editCategory.jsp?id=${cat.id}">编辑</a></td> </tr> </c:otherwise> </c:choose> </c:forEach>为什么这样设计：
- 避免递归查询（如
WITH RECURSIVE），MySQL 5.7兼容性更好； LEFT JOIN确保一级分类也能显示，parent_name为空时JSP用<c:when>分支处理，逻辑清晰；- 答辩时可当场演示：新增“手机壳”分类，选择父类为“配件”，刷新列表即显示缩进效果——证明“树形结构真实可用”。
4. 避坑指南：五个让答辩老师皱眉的高频翻车点及解决方案
这套方案经过17次课设答辩实测，以下问题是学生被追问最多、最影响分数的环节。每条按“现象→原因→解决”给出可立即执行的方案，不是泛泛而谈。
4.1 现象：输入中文商品名，页面显示乱码，数据库存成问号
原因：Tomcat默认使用ISO-8859-1解码URL参数，而JSP页面用UTF-8编码，导致GET请求参数乱码；MySQL连接未指定字符集，latin1存中文变?。
解决：
- 在
web.xml中添加过滤器，强制所有请求用UTF-8解码：
<filter> <filter-name>CharacterEncodingFilter</filter-name> <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>CharacterEncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>- MySQL连接URL追加参数：
jdbc:mysql://localhost:3306/inventory?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai - 创建数据库时显式指定字符集：
CREATE DATABASE inventory CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
4.2 现象：多人同时入库同一商品，库存数值错误（如应+10却+5）
原因：未加事务或事务隔离级别过低（READ UNCOMMITTED），导致“脏读”或“不可重复读”。
解决：
- 如3.2节代码所示，必须用
conn.setAutoCommit(false)手动控制事务； - 在
DBConnection.java中设置连接属性：conn.setTransactionIsolation(Connection.TRANSACTION_SERIALIZABLE);（虽性能略低，但答辩时能明确回答“为什么选最高隔离级别”）； - 在
product表增加version字段（INT类型），每次更新时SET version = version + 1 WHERE id = ? AND version = ?，用乐观锁兜底。
4.3 现象：导出Excel时中文全是方块或乱码，打开提示“文件损坏”
原因：Apache POI生成Excel时未设置字体，Windows系统默认用宋体，但服务器可能无此字体；HTTP响应头未声明Content-Type和Content-Disposition。
解决：
- 在
ExcelExporter.exportToResponse()中显式设置字体：
Font font = workbook.createFont(); font.setFontName("微软雅黑"); // 优先用常见中文字体 font.setFontHeightInPoints((short) 10); CellStyle style = workbook.createCellStyle(); style.setFont(font);- 设置响应头：
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setHeader("Content-Disposition", "attachment; filename=\"inventory_export_" + new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date()) + ".xlsx\"");4.4 现象：删除商品后，库存流水表仍有该商品记录，数据不一致
原因：未设置外键约束（FOREIGN KEY），或DAO中删除商品时未同步清理关联流水。
解决：
- 数据库建表时强制外键：
ALTER TABLE stock ADD CONSTRAINT fk_stock_product FOREIGN KEY (product_id) REFERENCES product(id) ON DELETE CASCADE;- 若因MySQL引擎限制（如MyISAM不支持外键），则在
ProductDAO.deleteProduct()中手动先删stock再删product：
public boolean deleteProduct(int id) { StockDAO stockDao = new StockDAO(); stockDao.deleteByProductId(id); // 先清空流水 return super.delete(id); // 再删商品 }4.5 现象：登录后访问/admin/目录下页面，未登录用户也能直接输入URL访问
原因：未配置Servlet容器安全约束（Security Constraint），或过滤器未覆盖所有admin路径。
解决：
- 在
web.xml中添加安全约束：
<security-constraint> <web-resource-collection> <web-resource-name>Admin Area</web-resource-name> <url-pattern>/admin/*</url-pattern> </web-resource-collection> <auth-constraint> <role-name>admin</role-name> </auth-constraint> </security-constraint> <login-config> <auth-method>FORM</auth-method> <form-login-page>/login.jsp</form-login-page> <form-error-page>/login_error.jsp</form-error-page> </login-config> <security-role> <role-name>admin</role-name> </security-role>- 同时在
LoginServlet中设置Session属性：session.setAttribute("userRole", "admin");，确保角色名与web.xml中一致。
5. 答辩验收：三步验证法与五项必演功能清单
答辩不是功能罗列，而是证明“你理解系统如何工作”。我带过的23个学生中，90%栽在“只会点按钮，答不出为什么”。以下是我总结的三步验证法，答辩前用10分钟走一遍，能极大提升可信度。
5.1 三步验证法：从日志、数据库、网络层交叉印证
不要只说“功能实现了”，要拿出证据链。每步耗时不超过2分钟，但能让导师信服：
| 步骤 | 操作 | 预期结果 | 为什么有效 |
|---|---|---|---|
| 第一步：看日志 | 在Tomcat/logs/catalina.out中搜索关键词ADD_PRODUCT或STOCK_IN | 显示完整操作记录，含时间、IP、参数详情（如新增商品：iPhone 15(P001)，价格：5999.00） | 证明系统有可观测性，非黑匣子；导师可现场tail -f验证实时性 |
| 第二步：查数据库 | 登录MySQL，执行SELECT * FROM stock ORDER BY create_time DESC LIMIT 5; | 显示最近5条流水，change_type为'IN'/'OUT'，quantity为正整数，product_id存在对应商品 | 证明数据持久化正确，且业务规则（如数量>0）已落地；避免“页面显示成功但数据库没写入”的尴尬 |
| 第三步：抓网络包 | 用浏览器开发者工具Network面板，提交一次入库请求 | 查看StockInServlet响应状态码为302（重定向），Headers中Location指向/admin/stockList.jsp?msg=success | 证明HTTP协议层面流程完整，非前端JS伪造成功提示；导师常要求“F12看网络请求” |
提示：答辩前把这三步的操作命令和预期结果打印在小纸条上，放在手边。当导师说“那你现场演示一下”时，你能立刻调出终端、数据库、浏览器，动作越流畅，可信度越高。
5.2 五项必演功能清单：覆盖导师80%提问场景
这五个功能是答辩必问点，必须提前演练到肌肉记忆。每个功能演示时，同步口述一句设计意图（括号内），让导师听到你的思考：
| 功能 | 演示步骤 | 设计意图（口述话术） |
|---|---|---|
| 1. 商品唯一性校验 | 在新增页面输入已存在的编码P001，点击提交 | “这里做了双重保障：前端JS做初步提示，后端DAO用SELECT COUNT查询确认，避免依赖数据库唯一索引报错这种不友好的方式。” |
| 2. 库存负数拦截 | 在入库页面输入数量-5，提交 | “所有数值型参数在Servlet层就用BigDecimal校验，拒绝负数输入，而不是等数据库报错再处理，保证用户第一时间得到明确反馈。” |
| 3. 中文导出无乱码 | 点击“导出Excel”，用WPS打开查看 | “POI生成时指定了微软雅黑字体，并设置了UTF-8响应头，确保跨平台兼容，这是企业级报表的基本要求。” |
| 4. 并发库存更新 | 开两个浏览器窗口，同时对同一商品执行+10操作 | “事务中用了SERIALIZABLE隔离级别，加上UPDATE语句的行级锁，两次操作会串行执行，最终库存准确增加20，不会出现15这种错误值。” |
| 5. 分类树形展示 | 新增二级分类“手机壳”，父类选“配件”，刷新列表 | “用单表自关联+LEFT JOIN实现两级分类，避免复杂递归，既满足业务需求，又保证查询性能，符合KISS原则（Keep It Simple, Stupid）。” |
5.3 答辩话术：把“我不知道”转化成“我这样设计的理由”
学生最怕被问倒，其实导师不期待你懂所有底层原理，而是想听你有没有工程权衡意识。遇到不确定的问题，用这个公式回应：
“这个问题我当前方案是按【具体做法】处理的，主要考虑三点：第一，【业务约束】（如‘课设要求一周内完成’）；第二，【技术平衡】（如‘用原生Servlet比Spring Boot更易追踪请求流程’）；第三，【可扩展性】（如‘预留了DAO接口，未来可轻松替换为MyBatis’）。如果需要深入优化，我会优先做【下一步动作】。”
例如被问“为什么不用Redis缓存库存？”：
“当前方案没引入Redis，主要考虑三点：第一，课设规模小，MySQL单表万级数据足够支撑；第二，加缓存会引入一致性难题（如DB更新后Redis怎么失效），增加调试复杂度；第三，DAO层已抽象为接口，未来只要实现
ProductDAORedisImpl，就能无缝切换。如果真要优化，我会先加监控看QPS，再决定是否上缓存。”
从那以后我每次带学生做课设，都强制他们在答辩前用三步验证法跑一遍，再对着五项清单自测三次。不是为了应付导师，而是让自己真正看清：每一行代码落在哪里，每一个请求穿过几层，每一个错误从何而来。希望帮到你。
本文还有配套的精品资源，点击获取
