简介这份资源是一套基于 JavaWeb 的超市收银系统完整源码面向计算机专业学生、JavaWeb 初学者及需要课程设计或毕业设计参考的开发者帮助解决收银结算、库存管理与销售统计等实际业务场景的开发需求。压缩包共 147 个文件约 1.61MB以 60 个 Java 源文件与 29 个 JSP 页面为主体配合 22 个 MyBatis 映射文件、16 个 CSS 与 7 个 JS 前端资源另有 SQL 建表脚本、Maven 配置及说明文档结构完整、层次清晰。系统覆盖商品管理、订单管理、用户管理与统计分析四大模块支持商品增删改查、库存预警、多支付方式、订单日志记录以及管理员、收银员、顾客多角色权限控制。目前已有 97 人学习读者可据此快速理解 JavaWeb 分层架构与前后端交互流程并在此基础上二次开发或直接用于课程实践。1. 从一份 JavaWeb 超市收银系统源码说起它到底能跑出什么很多人拿到「基于 JavaWeb 的超市收银系统」这类源码包第一反应是双击、找 main、点运行然后被 404、数据库连接失败、Tomcat 版本不匹配轮番教育。它本质上是一套典型的 JavaWeb 三层架构应用Servlet 或 SpringMVC 接请求Service 处理收银、库存、会员、退货等业务DAO 层用 JDBC 或 MyBatis 落库前端是 JSP 或 HTMLAjax。它解决的不是「高并发秒杀」这种问题而是把扫码、计价、找零、小票、库存扣减、日结这条线下门店最核心的链路用代码固化下来。适合谁课程设计要交作业的学生、想拿一个完整 CRUD 项目练手 MyBatis 和 Servlet 的后端新人、以及需要给小型便利店做一套能改能扩的收银底座的独立开发者。源码本身不是终点能不能在本地跑通、能不能改出第二个门店才是分水岭。2. 跑通前的环境选型JDK、Tomcat、MySQL 版本怎么配不翻车2.1 为什么 JavaWeb 老项目最容易死在版本上JavaWeb 收银系统这类源码绝大多数是 2018 到 2022 年之间的产物那个时间点的技术栈组合非常固定JDK 8、Tomcat 8.5 或 9、MySQL 5.7、Maven 3.6。你如果直接上 JDK 17 Tomcat 10 MySQL 8大概率会遇到三类问题javax.servlet包在 Tomcat 10 里被换成了jakarta.servlet所有 Servlet 直接编译不过MySQL 8 的驱动类名和时区参数变了连接池报Unknown system variableJDK 17 对反射和模块系统的限制让老版 C3P0、Druid 报非法访问。所以第一步不是急着导入 IDEA而是先确认源码里的pom.xml或lib目录看它依赖的是哪个 servlet-api 版本。判断方法很简单打开pom.xml搜servlet-api如果 groupId 是javax.servlet就锁死 Tomcat 9如果是jakarta.servlet才用 Tomcat 10。数据库同理看jdbc.properties或db.properties里的 URL带serverTimezone的通常是 MySQL 8 写法不带的多半是 5.7。2.2 一套能直接抄的环境清单下面这张表是我在 Windows 和 macOS 上都验证过的组合针对「javax.servlet MySQL 5.7 风格」的收银系统源码组件推荐版本说明JDK1.8.0_301不要用 8u 之后的过高小版本避免 TLS 差异Tomcat9.0.65支持 javax.servlet且比 8.5 稳定MySQL5.7.38与老驱动兼容性最好Maven3.6.33.8 对 http 仓库拦截更严IDEA2021.3对老项目索引更友好安装完 JDK 后务必确认JAVA_HOME指向 JDK 而不是 JRE否则 Tomcat 启动会报No compiler is provided。MySQL 安装时字符集选utf8mb4排序规则utf8mb4_general_ci因为收银系统里商品名、会员名经常有中文和生僻字。2.3 导入 IDEA 并让项目识别为 Web 应用很多新手卡在「IDEA 里没有 Web 选项」。正确姿势是先File - Open选中源码根目录有pom.xml的那层等 Maven 依赖下载完再File - Project Structure - Facets - - Web把web或webapp目录指为 Web 资源目录web.xml路径指对。如果是非 Maven 的老式项目还要在Modules - Dependencies里手动加lib下的所有 jar。# 验证 JDK 和 Maven 是否就位 java -version mvn -v # 在项目根目录执行强制刷新依赖 mvn clean compile -DskipTestsmvn clean compile这一步非常关键它能在你启动 Tomcat 之前就把编译错误暴露出来。如果这里报package javax.servlet does not exist说明依赖没下全或者 Tomcat 版本选错了先解决这个再往下走。参数-DskipTests是因为老项目的单元测试经常依赖外部环境跳过能省时间。3. 数据库初始化建库、导表、改连接串的三步操作3.1 从 sql 文件到可用的收银库源码包里通常会有一个sql目录或根目录下的.sql文件里面是建库建表语句加初始数据。不要直接复制粘贴到 Navicat 里一把梭先看文件头部有没有CREATE DATABASE。如果没有你得自己建库库名要和连接串里的一致。-- 常见收银系统的核心表结构简化示意 CREATE DATABASE IF NOT EXISTS supermarket DEFAULT CHARACTER SET utf8mb4; USE supermarket; -- 商品表收银扫码的核心 CREATE TABLE product ( id INT PRIMARY KEY AUTO_INCREMENT, barcode VARCHAR(50) UNIQUE NOT NULL COMMENT 条形码, name VARCHAR(100) NOT NULL, price DECIMAL(10,2) NOT NULL, stock INT DEFAULT 0, category_id INT ); -- 销售订单表日结和报表的数据源 CREATE TABLE sale_order ( id INT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) UNIQUE NOT NULL, total_amount DECIMAL(10,2), pay_type TINYINT COMMENT 1现金 2微信 3支付宝, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );导入时注意两点一是如果 sql 文件里用了ENGINEInnoDB但你的 MySQL 默认引擎是 MyISAM要显式指定二是初始数据里的密码字段如果是 MD5登录时要用对应算法别自己改成明文。3.2 连接串里四个必改参数打开src/main/resources下的jdbc.properties或db.properties逐项核对jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/supermarket?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password你的密码driver这一项MySQL 5.7 用com.mysql.jdbc.DriverMySQL 8 用com.mysql.cj.jdbc.Driver写错直接ClassNotFoundException。url里的useSSLfalse在老驱动上能避免一堆警告characterEncodingutf8保证中文不乱码。用户名密码改成你本地的别照抄源码里的root/123456。3.3 用一条查询验证数据库真的通了在写 Java 代码之前先用 Navicat 或命令行执行一条查询确认表和数据都在SELECT p.name, p.price, p.stock FROM product p WHERE p.barcode 6901234567890;如果这条能查出商品说明库、表、数据、字符集都没问题。查不到就回头检查 sql 是否导入到了正确的库以及 barcode 是否真的存在。这一步能帮你把「数据库问题」和「Java 代码问题」提前隔离开省下大量瞎猜时间。4. 启动与联调Tomcat 部署、扫码收银链路怎么验证4.1 在 IDEA 里配置 Tomcat 运行Run - Edit Configurations - - Tomcat Server - Local在Deployment标签页点 - Artifact选war exploded形式。Application context建议设成/或/supermarket要和源码里 JSP 的链接前缀一致。Server标签页里On Update action选Update classes and resources这样改 Java 代码不用重启。启动后如果控制台刷出Server startup in xxx ms说明 Tomcat 起来了。访问http://localhost:8080/能看到登录页就成功了一半。如果报 404先检查web.xml里的welcome-file和实际首页文件名是否一致。4.2 收银主链路的四个验证点收银系统的核心链路是登录 - 扫码加购 - 结算 - 扣库存。逐个验证第一登录。用 sql 里的初始账号通常是admin/123456。如果登录失败看控制台有没有NullPointerException多半是 Service 层没注入或者密码加密方式不匹配。第二扫码。在收银界面输入一个真实存在的 barcode看商品名和价格是否自动带出。这一步走的是product表的查询如果带不出检查前端 Ajax 的 URL 和后端 Servlet 的WebServlet或web.xml映射是否一致。第三结算。选支付方式点结算看是否生成订单号并跳转小票页。订单号一般用时间戳加随机数如果重复会报唯一索引冲突。第四扣库存。结算后回product表查该商品 stock 是否减 1。如果没减看 Service 里扣库存的 SQL 是不是漏了WHERE stock 1的条件这个条件能防止超卖。// 扣库存的典型写法注意 WHERE 条件 public int reduceStock(int productId, int qty) { String sql UPDATE product SET stock stock - ? WHERE id ? AND stock ?; // 参数顺序扣减数量、商品ID、扣减数量 return jdbcTemplate.update(sql, qty, productId, qty); }这段代码的关键在AND stock ?它把「检查库存」和「扣减库存」合并成一条原子 SQL避免先查后扣导致的并发超卖。返回值为 0 说明库存不足Service 层要抛业务异常并回滚订单。4.3 用日志定位前后端断点老项目日志往往只配了log4j.properties或logback.xml级别设成DEBUG能看到 SQL 和请求参数。如果前端点了没反应先按 F12 看 Network 里请求是否发出、状态码是多少。500 就去 Tomcat 控制台找堆栈404 就查 URL 映射400 多半是参数类型对不上。这套排查顺序比盲目改代码高效得多。5. 避坑与排查源码跑不起来时先看这五条5.1 启动报 ClassNotFoundException: com.mysql.jdbc.Driver现象Tomcat 一启动就抛这个异常应用直接挂掉。原因MySQL 驱动 jar 没放进WEB-INF/lib或者 Maven 依赖 scope 写成了provided。解决确认pom.xml里 mysql-connector 的 scope 是runtime或默认非 Maven 项目就把 jar 复制到web/WEB-INF/lib下并在 IDEA 的 Artifact 里确认它被包含进输出。5.2 页面中文全是问号或乱码现象商品名显示成???。原因数据库字符集、连接串字符集、JSP 页面编码三者不一致。解决库和表用utf8mb4连接串加characterEncodingutf8JSP 头部加% page contentTypetext/html;charsetUTF-8 %三处统一后再重启。5.3 登录后一直跳回登录页现象输入正确账号密码还是回到 login。原因Session 没保持住或者拦截器 Filter 把静态资源也拦了。解决检查web.xml里 Filter 的url-pattern排除.css、.js、.png再看浏览器是否禁用了 CookieSession 依赖 JSESSIONID。5.4 扫码后价格不显示现象输入条码商品名出来了但价格是空。原因前端拿的字段名和后端返回的 JSON key 不一致比如后端返回price前端读的是productPrice。解决F12 看接口返回的原始 JSON把前端字段名对齐或者在后端 VO 里加JsonProperty。5.5 结算时报 Duplicate entry for key order_no现象偶尔结算失败报唯一索引冲突。原因订单号生成规则用了秒级时间戳同一秒内多笔订单会重复。解决订单号改成时间戳 随机数 收银员ID或者直接用数据库自增主键加日期前缀。6. 从能跑到能改二次开发与数据校验的进阶手法跑通只是及格线真正让这套源码产生价值的是改出你自己的门店逻辑。我一般会先做两件事一是把收银小票的打印格式改成自己需要的二是加一个日结报表的导出。小票打印通常走JasperReports或纯 HTML 打印找到receipt.jsp改字段即可。日结报表则是加一个SaleReportServlet按create_time分组统计total_amount。-- 日结报表核心查询按支付方式汇总 SELECT DATE(create_time) AS sale_date, pay_type, COUNT(*) AS order_count, SUM(total_amount) AS total FROM sale_order WHERE create_time CURDATE() GROUP BY DATE(create_time), pay_type;这条 SQL 能直接喂给前端表格pay_type在前端映射成「现金/微信/支付宝」。注意CURDATE()只取当天如果要查历史就换成参数传入。改代码时最容易忽略的是数据校验。收银系统里金额和库存是敏感字段前端校验只是体验后端必须再校验一次。比如结算接口要校验total_amount是否等于购物车各项之和防止前端被篡改。我习惯在 Service 层加一个validateOrder方法把金额、库存、支付方式三项都过一遍不通过就抛异常回滚。还有一个实用技巧给product表的barcode加唯一索引后扫码查询会走索引速度明显提升。如果商品量大再给category_id加普通索引分类筛选就不卡了。这些索引调整不需要改 Java 代码但对收银体验的提升立竿见影。最后说个我踩过的坑有次改完代码IDEA 热部署没生效页面还是旧的我排查了半小时才发现是 Artifact 没重新构建。后来我养成习惯改完 Java 代码先Build - Rebuild Project再点 Tomcat 的重新部署按钮省下不少后悔药。这套源码值不值得投入取决于你是只想交个作业还是想把它当成一个能持续迭代的收银底座。如果是后者先把上面这些环境、数据库、链路验证做扎实后面每加一个功能都会顺很多。希望帮到你。本文还有配套的精品资源点击获取