超市收银系统源码拆解：扫码结算、库存事务与小票打印-北京尧图网络

简介面向小型超市收银场景的毕业设计项目源码适合计算机相关专业学生和初入商业软件开发的学习者用于理解收银业务从商品录入到交易结算的基础实现。内容围绕添加商品、商品销售、商品查询与计算器小工具展开并涉及库存管理、会员管理、报表分析、支付接口、退货退款和权限管理等扩展方向可据此梳理数据库设计、前端界面与后端逻辑的协作关系。压缩包约3.3MB文件总数显示为0、类型明细暂未提供实际文件清单以上游为准据描述可能包含源代码、数据库配置和用户手册等便于对照学习系统结构与业务模块划分。已有3120人学习或下载可作为小型收银系统课程设计与毕业设计的参考样本帮助读者建立从需求到功能落地的整体认识。1. 一笔 38 块 5 的结账背后这套超市收银系统源码到底在管什么早高峰收银员用扫码枪连着扫了六件商品屏幕跳出应收 38.5 元会员卡一刷自动抹掉 5 毛顾客递上一张 50 元钱箱弹开找零 11.5 元小票机滋啦一声吐出小票整个过程不到三秒。这三秒里一套合格的超市收银系统源码其实干完了六件事解析条码、匹配商品与价格、算会员优惠、扣库存、落订单和明细、驱动小票打印。任何一环掉链子收银台前立刻排起长队。这份源码就是围绕这条链路搭起来的收银台负责快后台负责准数据库负责账实一致。适合三类人——想做毕业设计但不想从零画表的同学、接社区超市私活需要快速交付的开发者、以及自家小店想换掉老式单机收银软件的老板。它不追求大而全的 ERP重点是把收钱、减货、记账三件事做扎实剩下的会员、促销、报表都是在上面加壳。2. 工程结构与技术选型前后端分离收银端如何拆模块一套超市收银系统源码能不能二次开发先看它怎么分模块。分成收银端管理后台服务端三块的项目改起来最省心——收银端出问题不影响后台改商品后台挂掉收银端还能靠本地缓存顶一会儿。这份工程就是这种结构前端一套 Vue 工程同时承载收银台和管理后台靠路由和权限区分打包时按需拆成两个入口。2.1 技术栈的组合与选型理由后端用 Spring Boot 2.5 MyBatis-Plus MySQL 8.0缓存和防重复提交用 Redis。这套组合在国内中小型管理系统里几乎是默认答案MyBatis-Plus 的LambdaQueryWrapper能把 80% 的 CRUD 写成一两行遇到复杂报表 SQL 又能直接写 XML不用被 ORM 绑架。MySQL 8.0 的窗口函数在日结、月度毛利这类统计里省事不少。前端 Vue 2 Element UI Axios收银台页面单独做了大字号、大按钮、高对比度的布局因为收银员很多是四五十岁的阿姨界面精细不重要能一眼看清金额才重要。小票打印走浏览器打印通道window.print()配合一套media print的 CSS比后端调 ESC/POS 指令省心也方便换 58mm 和 80mm 两种纸宽。层次技术选型承担职责收银端Vue 2 Element UI扫码、购物车、结算、打印管理后台Vue 2 Element UI ECharts商品、会员、库存、报表服务端Spring Boot 2.5 MyBatis-Plus业务逻辑、事务、权限存储MySQL 8.0 Redis主数据、订单、锁与缓存部署Nginx jar 包静态资源与接口反向代理选型里有一个容易忽略的点没有上微服务。单店或三五家连锁的收银场景QPS 峰值也就几十拆微服务只会让运维成本翻倍。常见做法是把订单、商品、会员放在同一个工程的不同 package 下将来真要拆再按 package 边界切成本可控。2.2 目录结构逐个看从 pos-server 到 pos-web拿到源码第一件事是看目录目录结构能告诉你作者有没有认真分层。这套工程的目录大致长这样supermarket-pos/ ├── pos-server/ # 后端服务 │ ├── src/main/java/com/pos/ │ │ ├── controller/ # 接口层只做参数校验和返回封装 │ │ ├── service/ # 业务层事务边界都在这里 │ │ │ └── impl/ │ │ ├── mapper/ # MyBatis-Plus Mapper 接口 │ │ ├── entity/ # 数据库实体 │ │ ├── dto/ # 入参出参对象 │ │ ├── common/ # 统一返回、全局异常、工具类 │ │ └── config/ # 跨域、拦截器、Redis 配置 │ └── src/main/resources/ │ ├── mapper/ # 复杂 SQL 的 XML │ ├── db/pos.sql # 建表初始数据 │ └── application.yml # 数据源、Redis、打印配置 ├── pos-web/ # 前端工程收银端后台 │ ├── src/ │ │ ├── views/cashier/ # 收银台主界面 │ │ ├── views/goods/ # 商品与分类维护 │ │ ├── views/order/ # 订单查询与退货 │ │ ├── views/report/ # 日结、毛利报表 │ │ ├── api/ # 接口封装 │ │ └── router/ # 路由与权限守卫 │ └── vue.config.js # 开发代理配置 └── README.mdservice层是整个工程的重心事务注解、库存扣减、订单号生成都压在这里controller保持得很薄只做Valid校验和Result包装这个习惯很关键——如果业务逻辑漏到 controller将来做接口复用会非常难受。dto和entity严格分开避免把数据库字段直接吐给前端比如商品的进价字段就不该出现在收银端的响应里。resources/mapper下放的是报表类 SQL像按日统计各支付方式金额按商品分类统计毛利这类带GROUP BY的查询用 XML 写比链式调用清楚得多。db/pos.sql是整套系统的起点建库、建表、插入默认管理员和测试商品都在里面导入完就能直接跑。2.3 数据表设计订单、明细、库存流水三张表的配合收银系统的数据表能不能撑住看三张表的关系订单主表sale_order、订单明细sale_order_item、库存流水stock_record。主表存一笔交易的头信息——订单号、收银员、会员、应收、实收、找零、支付方式、营业日期明细存每一行商品——商品 ID、名称快照、单价快照、数量、小计。这里有个设计细节值得说明细表必须存商品名称和单价的快照不能只存商品 ID 去关联查。因为商品改名、调价之后历史订单打印出来的小票必须还是当时的价格否则退货对账时全是糊涂账。这是踩过坑的人才会加上的字段。stock_record是库存流水每次入库、销售扣减、退货回补都记一条字段包括商品 ID、变动数量正负、变动类型、关联单号、操作人。有了它商品表上的stock字段就只是一个当前余额的冗余真实账目永远可以靠流水重算出来。库存对不上时把流水按商品汇总一遍和goods.stock一比差在哪一笔一目了然。这套设计不复杂但少有人一开始就想明白。3. 核心链路拆解从扫码枪输入到小票打印机出纸收银台这条链路是整个项目最值得读的部分它把前端输入、后端事务、硬件输出串成了一条线。读懂这条线剩下的商品管理、会员管理都是它的变体。3.1 扫码枪输入一次 keydown 如何变成购物车条目扫码枪在操作系统眼里就是一个键盘扫一次条码等于快速敲入一串字符再敲一个回车。所以前端不需要什么特殊 SDK只要保证输入框始终聚焦监听回车即可。麻烦在于扫码枪有时会连发两次回车或者收银员手快又按了一次导致同一件商品被加两次。// Cashier.vue —— 扫码输入处理 data() { return { barcode: , lastScanTime: 0 }; }, methods: { onBarcodeEnter() { const now Date.now(); // 300ms 内的重复回车视为扫码枪连发直接丢弃 if (now - this.lastScanTime 300) { this.barcode ; return; } this.lastScanTime now; const code this.barcode.trim(); this.barcode ; if (!code) return; this.addToCart(code); }, async addToCart(code) { const res await getGoodsByBarcode(code); if (!res.data) { this.$message.warning(未找到条码 code); return; } const exist this.cart.find(i i.goodsId res.data.id); if (exist) { exist.qty 1; // 已在购物车则数量加一 } else { this.cart.push({ ...res.data, qty: 1 }); } this.calcTotal(); } }lastScanTime是防连发的关键300 毫秒这个阈值是根据常见扫码枪的出码间隔定的太快会误杀连续扫两件同款商品的正常操作太慢又挡不住连发。addToCart里做了同商品合并购物车里一件商品只有一行数量累加这样小票打印出来也清爽。calcTotal负责重算应收、优惠、抹零任何一次增删改数量后都必须调一次别指望 Vue 的 computed 能覆盖所有场景——涉及四舍五入的地方手动算更稳。3.2 下单事务扣库存、写订单、记流水必须在一个事务里结算按钮按下去后端要做的事按顺序是校验库存、扣减库存、写订单主表、写订单明细、写库存流水、累加会员积分、生成小票数据。这七步任何一步失败都必须整体回滚否则就会出现钱收了但库存没减或者订单写了但明细丢了这种对不上账的情况。// SaleOrderServiceImpl.java —— 收银下单主事务 Transactional(rollbackFor Exception.class) public OrderResultVO checkout(CheckoutDTO dto) { // 1. 幂等锁同一台收银机同一请求号只处理一次 String lockKey pos:checkout: dto.getClientNo() : dto.getRequestId(); if (!redisLock.tryLock(lockKey, 10, TimeUnit.SECONDS)) { throw new BizException(请勿重复提交); } try { BigDecimal total BigDecimal.ZERO; ListSaleOrderItem items new ArrayList(); for (CartItemDTO ci : dto.getItems()) { // 2. 条件更新扣库存stock qty 才允许扣防超卖 int affected goodsMapper.deductStock(ci.getGoodsId(), ci.getQty()); if (affected 0) { throw new BizException(商品[ ci.getGoodsName() ]库存不足); } Goods goods goodsMapper.selectById(ci.getGoodsId()); // 3. 单价取数据库当前售价不信任前端传值 BigDecimal amount goods.getSalePrice() .multiply(BigDecimal.valueOf(ci.getQty())) .setScale(2, RoundingMode.HALF_UP); total total.add(amount); items.add(buildItem(goods, ci.getQty(), amount)); } // 4. 会员折扣与抹零在服务端统一算前端算的只用于展示 BigDecimal payable memberService.applyDiscount(dto.getMemberId(), total); SaleOrder order buildOrder(dto, total, payable); saleOrderMapper.insert(order); items.forEach(i - i.setOrderId(order.getId())); saleOrderItemMapper.insertBatch(items); // 5. 库存流水逐条落库方便日后对账 stockRecordService.batchSave(order.getOrderNo(), items); memberService.addPoints(dto.getMemberId(), payable); return new OrderResultVO(order.getOrderNo(), payable, dto.getPaidAmount().subtract(payable)); } finally { redisLock.unlock(lockKey); } }几个参数值得单独说明。clientNo是收银机编号requestId是前端生成的 UUID两者组合成幂等键能挡住收银员手抖连点两次结算的情况。deductStock对应的是下面这条 SQL靠stock #{qty}这个条件在数据库层面兜底比先查再减安全得多UPDATE goods SET stock stock - #{qty}, update_time NOW() WHERE id #{goodsId} AND stock #{qty};返回影响行数为 0 就说明库存不够直接抛异常回滚。单价一定要从数据库取不能信前端传的价格——这是收银系统最基本的安全底线改价必须走后端授权的改价接口并留痕绝不能在前端随便改个数字就提交。3.3 金额计算BigDecimal 与抹零、找零的处理收银系统里所有跟钱有关的字段Java 侧一律BigDecimal数据库侧一律DECIMAL(10,2)没有例外。用double算0.1 0.2得到0.30000000000000004这种事在收银台就是实实在在的客诉。每次乘除之后必须setScale(2, RoundingMode.HALF_UP)把精度钉死在分。抹零是另一处容易翻车的地方。常见做法有三种四舍五入到角、直接舍去分、满整抹零。工程里把抹零策略做成了配置项pos.checkout.round-mode取值NONE / HALF_UP / DOWN结算时按配置处理抹掉的金额记在订单的discount_amount字段里单独统计。找零则是实收 - 应收实收小于应收直接拦截不允许负找零。3.4 小票打印58mm 热敏纸的排版与打印触发打印这块前端方案是页面上藏一个#receipt容器结算成功后把订单数据填进去调window.print()剩下的交给 CSS。关键是page的尺寸要和纸宽对上58mm 的机器写 80mm 会切边80mm 的写 58mm 会留一大片空白。media print { page { size: 58mm auto; margin: 0; } body * { visibility: hidden; } #receipt, #receipt * { visibility: visible; } #receipt { width: 58mm; font-size: 12px; font-family: SimSun, monospace; line-height: 1.4; } #receipt .row { display: flex; justify-content: space-between; } #receipt .divider { border-top: 1px dashed #000; margin: 4px 0; } }visibility: hidden配合子元素visible是隐藏页面其余部分的标准写法比display: none稳后者在某些浏览器里会把打印区域一起干掉。字体选宋体或等宽字体因为热敏打印机对比例字体支持差等宽字体才能保证金额右对齐。小票内容一般包括店名、订单号、收银员、商品明细、合计、优惠、实收、找零、支付方式、打印时间最后留一行谢谢惠顾。如果项目要接的是 USB 口或串口的 ESC/POS 指令打印机那就得走后端方案Java 侧拼装指令字节流通过javax.usb或串口库直接推给打印机。工程里预留了PrinterService接口默认实现是浏览器打印需要换硬件时新增一个实现类即可不用改调用方。4. 本地部署实战数据库、配置项与前后端联调源码能不能跑起来取决于三件事数据库脚本是否完整、配置项是否对得上、前后端代理是否通。按下面顺序走一般半小时内能看到收银台界面。4.1 环境准备与数据库初始化先确认本机有 JDK 8 或 11、Maven 3.6、Node 14、MySQL 8.0、Redis 5。版本别乱跳Spring Boot 2.5 配 JDK 17 会有一堆反射相关的告警新手容易被吓到。Redis 主要用来做结算幂等锁和会员会话缓存没有它系统也能跑但并发结算会退化。# 1. 建库字符集必须 utf8mb4否则商品名里的生僻字会变问号 mysql -uroot -p -e CREATE DATABASE pos DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 2. 导入表结构与初始数据 mysql -uroot -p pos pos-server/src/main/resources/db/pos.sql # 3. 编译并启动后端 cd pos-server mvn clean package -DskipTests java -jar target/pos-server-1.0.0.jar # 4. 安装依赖并启动前端 cd ../pos-web npm install --registryhttps://registry.npmmirror.com npm run servepos.sql里会插入一个默认管理员账号和十几条测试商品商品条码是模拟的 13 位数字可以直接手输测试不用真拿扫码枪。导入完先SELECT COUNT(*) FROM goods;确认一下数据进去了很多人卡在登录成功但商品列表空八成是脚本只导了结构没导数据。4.2 后端配置application.yml 里必须改的几项配置文件里跟环境相关的就那么几项改错一个就起不来。重点是数据源 URL 里的时区和编码参数以及 Redis 的库号——本地 Redis 常常被别的项目占着 0 号库这里指定一个独立库号能省掉键冲突的麻烦。server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/pos?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 改成你自己的密码 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 database: 3 pos: checkout: round-mode: HALF_UP # 抹零策略NONE / HALF_UP / DOWN printer: paper-width: 58 # 小票纸宽58 或 80 store-name: 示例门店serverTimezoneAsia/Shanghai必须加不然日结报表按时间分组时会整体偏移八小时凌晨那几笔单子会跑到前一天去。allowPublicKeyRetrievaltrue是 MySQL 8 默认加密方式下连接的必要参数漏了会报Public Key Retrieval is not allowed。round-mode改成NONE就是不抹零方便对账时排查差异。4.3 前端启动与接口联调前端开发态通过vue.config.js里的 proxy 把/api转发到 8080生产环境则交给 Nginx。这一步配错的典型症状是登录页一直转圈控制台报 404 或跨域。// vue.config.js module.exports { devServer: { port: 8081, proxy: { /api: { target: http://127.0.0.1:8080, changeOrigin: true, pathRewrite: { ^/api: } // 后端接口没有 /api 前缀转发时剥掉 } } } }pathRewrite这一行是坑点后端RequestMapping(/goods)没有/api前缀前端如果按/api/goods请求不剥前缀就会 404。启动后访问http://localhost:8081用 SQL 里插入的管理员账号登录进收银台页面手动输入一个测试条码回车能看到商品进购物车链路就通了。4.4 收银端外设接入扫码枪、钱箱、小票机扫码枪是 USB 免驱的插上就能当键盘用唯一要做的是在收银页面加载完成后自动让条码输入框获得焦点并监听全局的focus丢失事件重新聚焦——收银员点了别的地方再扫码字符会打到一个看不见的地方。钱箱一般接在小票机的 RJ11 口上打印小票时打印机发出的开箱指令会顺带弹开所以只要小票能打钱箱就能开。小票机装好驱动后在浏览器打印对话框里选它把边距设为无、缩放设为 100%然后勾选另存为默认设置收银员就不用每次调了。这一步没什么技术含量但实测下来是新手最容易卡住的地方因为浏览器默认缩放经常把 58mm 的小票打成半截。5. 常见问题排查条码扫不进、库存对不上、小票乱码这几类坑这套系统在本地跑通只是开始真正上线后遇到的问题大多集中在输入、并发、精度和硬件四类。下面这几条都是高频翻车现场按现象 → 原因 → 解决整理。5.1 扫一件商品进了两行或者条码根本没反应现象扫一次条码购物车里出现两条同样的商品或者扫了没反应得手动点一下输入框才行。原因前一种是扫码枪连发回车或者全局 keydown 监听和输入框的回车事件同时触发导致addToCart被调用两次后一种是页面某个弹窗关闭后焦点没回到输入框字符打到了 body 上。解决一是加时间戳防抖300ms 内的重复回车直接丢弃二是把回车监听挂在输入框上用keyup.enter不要同时在document上再挂一个。弹窗关闭后用this.$nextTick(() this.$refs.barcodeInput.focus())把焦点抢回来这个$nextTick不能省DOM 还没渲染完就 focus 会失效。5.2 库存扣成了负数或者两个收银台同时卖断货现象后台看商品库存是 -3或者明明只剩 1 件两个收银台同时结算都成功了。原因用了先 select 查库存再 update 减库存的写法。两条 SQL 之间有时间窗两个事务都读到 1都判断够都去减结果就是超卖加负库存。解决换成条件更新把判断塞进 SQL 的 where 里靠数据库行锁保证原子性UPDATE goods SET stock stock - #{qty} WHERE id #{goodsId} AND stock #{qty};然后判断返回的影响行数0 就抛异常回滚。这条规则对退货回补同样适用stock stock #{qty}也要走同一条 Mapper 方法族别图省事用updateById传个对象过去那样会绕过条件判断。5.3 小计和合计差一分钱顾客当场质疑现象三件商品各 3.33 元小票上小计分别 3.33合计却显示 9.98 而不是 9.99。原因每行amount都做了setScale(2, HALF_UP)但合计是拿已经舍入过的行金额相加还是拿未舍入的原始值相加两处口径不一致就会差一分。更糟的是有人用了double累加。解决统一口径——每行先算原始金额累加时用未舍入值最后对总计做一次setScale。同时把数据库字段类型改成DECIMAL(10,2)实体类用BigDecimalapplication.yml里配好round-mode让抹零只发生在最后一步。BigDecimal rawTotal items.stream() .map(i - i.getUnitPrice().multiply(BigDecimal.valueOf(i.getQty()))) .reduce(BigDecimal.ZERO, BigDecimal::add); // 累加阶段不舍入 BigDecimal payable rawTotal.setScale(2, RoundingMode.HALF_UP); // 只在最后舍入一次5.4 小票打出来是乱码或者只打了半个页面现象中文全变成方块或问号或者一页纸只打了两行字就切断。原因乱码通常是编码没统一浏览器、HTML 的charset、CSS 字体三者有一个不是 UTF-8 或系统里没装对应字体打半页则是page size和实际纸宽不匹配或者打印对话框里的缩放不是 100%。解决HTML 头部声明meta charsetutf-8CSS 里把font-family指定成系统确有安装的宋体或黑体page的size严格按纸宽写58mm automargin: 0打印对话框里把边距设无、缩放设 100%并保存为默认。如果换到 80mm 机器除了改page还要把配置里的paper-width一起改两处必须同步。5.5 日结报表总数对不上凌晨的单子跑到昨天去了现象昨天营业结束后对账现金应该收 5000报表显示 4800差的正好是晚上十一点半之后那几笔。原因报表按create_time分组统计而 MySQL 连接串没配serverTimezone驱动用 UTC 解析时间整体偏移八小时跨零点的订单就被算到前一天了。解决连接串加serverTimezoneAsia/Shanghai同时订单表增加一个business_date字段结算时由后端按门店配置的营业日切分规则写入比如凌晨两点前算前一天。报表一律按business_date统计不再碰create_time。这个字段看起来冗余但做过零售对账的人都知道营业日和自然日从来就不是一回事。6. 二次开发改造促销引擎、支付扩展与报表口径拿到源码后最常被提的需求是加个满减接个聚合支付报表加个毛利维度。这三件事分别对应三个扩展点改对了地方代码量都不大。促销这块工程里MemberService.applyDiscount目前只做了会员折扣要扩成规则引擎别在里面堆if-else用策略模式最合适。定义一个PromotionStrategy接口方法签名BigDecimal apply(CartContext ctx, BigDecimal amount)然后满减、第二件半价、满赠各写一个实现类用Component注册到 Spring再用一个PromotionChain按优先级排序依次执行public interface PromotionStrategy { int priority(); // 数值越小越先执行 boolean match(CartContext ctx); // 是否命中该规则 BigDecimal apply(CartContext ctx, BigDecimal amount); } Component public class FullReduceStrategy implements PromotionStrategy { public int priority() { return 10; } public boolean match(CartContext ctx) { return ctx.getAmount().compareTo(new BigDecimal(88)) 0; } public BigDecimal apply(CartContext ctx, BigDecimal amount) { return amount.subtract(new BigDecimal(10)).max(BigDecimal.ZERO); } }支付扩展同理定义一个PayChannel接口现金、扫码、会员余额各一个实现收银端只传payType后端按类型分发。将来接新的支付方式新增一个实现类就行不用动结算主流程。报表口径则要守住一条所有涉及金额的字段都以business_date为维度聚合退货用负数金额冲抵不要单独做一张退货表再去关联那样口径必然分叉。改完怎么验证我一般会跑三组数据一件单价 0.01 元的商品买三件看总价是不是 0.03库存为 1 的商品用两个线程并发结算看是不是只有一个成功跨零点打印一张小票看报表里落在哪一天。这三组过了基本的功能改造就稳了。从那以后我每次改金额和库存相关的代码都强制把这三组用例走一遍宁可多花十分钟也不想再被店长追着问昨天的账怎么少了二十块。希望这些能帮到你少走点弯路。本文还有配套的精品资源点击获取

超市收银系统源码拆解：扫码结算、库存事务与小票打印

相关推荐

离线超市收银系统源码：Electron+SQLite全链路实战

动漫资源命名规范与版本控制实践指南

impeccable不是CLI工具：解密开发者工作流中的质量信号词

更多资讯

C++内存布局与编译流程详解

从“一句话”到CAD模型：text-to-cad实现原理与落地路线

现代CLI认证机制：从2FA到浏览器扩展的工程实践

橙星梦工厂：轻量化创作工具的技术解析与应用

Vibe Coding如何用AI重构微服务架构设计

t3code：用一份Schema生成全套TypeScript全栈代码，终结类型不同步

今日更新

Agent-Reach：打通大模型触达外部系统的最后一公里

深度学习图像隐写分析实战：从CNN原理到毕设源码全解析

AI赋能知识产权供需匹配：专利评估、需求挖掘与多路召回工程实践

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？