简介这是一套基于JSPServletMySQL实现的轻量级库存商品管理系统面向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等重量级框架用原生ServletJSP实现可控性更强的控制流。整个系统划分为五个物理模块每个模块对应明确的职责边界和交付物避免学生常犯的“所有逻辑堆在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.dao4个DAO类严格遵循“一个表一个DAO”原则。ProductDAO处理商品主表StockDAO管库存流水CategoryDAO维护分类LogDAO专写操作日志。所有SQL语句外置到sql.properties方便答辩时快速切换数据库版本。com.inventory.modelPOJO类全部实现Serializable字段命名与数据库列名完全一致如product_name→productName避免Hibernate式映射引发的答辩解释成本。com.inventory.util3个工具类——DBConnection封装连接池用Apache Commons DBCP2非手动new Connection、Validator做基础校验非正则轰炸而是针对库存数量用BigDecimal比对、ExcelExporter用Apache POI 5.2.4生成UTF-8编码Excel解决中文乱码顽疾。WebContent/jspJSP文件按功能分组admin/下放管理页common/放header/footererror/统一错误页。所有JSP禁用% %脚本片段仅用JSTL标签和EL表达式确保代码可读性。提示答辩时若被问“为什么不用Spring Boot”可直接展示web.xml中servlet-mapping的精确路径配置如/admin/addProduct说明“原生Servlet能更直观体现HTTP请求生命周期便于教学演示”。2.2 数据库设计四张表与三个关键约束MySQL 8.0数据库共四张表设计时重点强化业务语义约束而非单纯满足范式表名字段关键约束说明答辩价值productid(PK),code(UNIQUE),name,category_id,unit_pricecode设唯一索引防止重复录入unit_price用DECIMAL(10,2)避免浮点误差导师常问“怎么保证商品编码不重复”此处可现场演示插入同编码报错stockid,product_id(FK),change_type(ENUM: IN,OUT),quantity,operator,create_timechange_type限定枚举值quantity设CHECK(quantity 0)强制业务规则落地解释“为什么库存变更必须记录类型”引申到审计追溯需求categoryid,name,parent_id(允许NULL)parent_id支持两级分类如“电子产品”→“手机”避免过度设计树形结构回应“分类怎么扩展”的质疑展示实际业务复杂度operation_logid,action,target_id,detail,ip_address,create_timedetail用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渲染表单含商品下拉框、数量输入框提交表单至/StockInServletPOST→ Servlet解析productId、quantity参数调用StockDAO.addStock()执行INSERT并在同一个事务中更新product.current_stock若成功重定向至/admin/stockList.jsp?msgsuccess失败则转发至/error/stockError.jsp并传入错误信息Session仅用于存储用户登录态userRoleadmin绝不存业务数据。库存查询列表页通过URL参数?page1size10实现分页避免Session膨胀。所有重定向均用response.sendRedirect()而非RequestDispatcher.forward()确保浏览器地址栏显示真实路径——答辩时导师会亲自点击地址栏验证流程完整性。注意web.xml中servlet配置必须显式声明load-on-startup1/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?msgadd_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线程读取库存为10B线程同时扣减15A线程更新时WHERE id ?匹配不到行executeUpdate()返回0此时必须抛异常而非静默失败——这是答辩时证明“考虑了并发”的铁证。3.3 分类维护支持两级分类的树形结构简化实现分类模块常被学生过度设计成无限级树但实际业务中两级足够。CategoryDAO.java用单表自关联实现// CategoryDAO.java public ListCategory 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; // 执行查询后将结果组装为ListCategory其中Category类含parentName字段 }JSP中渲染时用嵌套循环!-- admin/categoryList.jsp -- c:forEach items${categories} varcat c:choose c:when test${empty cat.parentId} !-- 一级分类 -- tr classlevel-1 td${cat.name}/td td无/td tda hrefeditCategory.jsp?id${cat.id}编辑/a/td /tr /c:when c:otherwise !-- 二级分类 -- tr classlevel-2 tdnbsp;nbsp;└ ${cat.name}/td td${cat.parentName}/td tda hrefeditCategory.jsp?id${cat.id}编辑/a/td /tr /c:otherwise /c:choose /c:forEach为什么这样设计避免递归查询如WITH RECURSIVEMySQL 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-nameCharacterEncodingFilter/filter-name filter-classorg.apache.catalina.filters.SetCharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameCharacterEncodingFilter/filter-name url-pattern/*/url-pattern /filter-mappingMySQL连接URL追加参数jdbc:mysql://localhost:3306/inventory?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/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再删productpublic 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-nameAdmin Area/web-resource-name url-pattern/admin/*/url-pattern /web-resource-collection auth-constraint role-nameadmin/role-name /auth-constraint /security-constraint login-config auth-methodFORM/auth-method form-login-page/login.jsp/form-login-page form-error-page/login_error.jsp/form-error-page /login-config security-role role-nameadmin/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/OUTquantity为正整数product_id存在对应商品证明数据持久化正确且业务规则如数量0已落地避免“页面显示成功但数据库没写入”的尴尬第三步抓网络包用浏览器开发者工具Network面板提交一次入库请求查看StockInServlet响应状态码为302重定向Headers中Location指向/admin/stockList.jsp?msgsuccess证明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再决定是否上缓存。”从那以后我每次带学生做课设都强制他们在答辩前用三步验证法跑一遍再对着五项清单自测三次。不是为了应付导师而是让自己真正看清每一行代码落在哪里每一个请求穿过几层每一个错误从何而来。希望帮到你。本文还有配套的精品资源点击获取