简介这是一套基于Spring Boot开发的网吧管理系统完整源码面向Java初学者、课程设计与毕业设计学生解决中小型网吧日常运营中的会员管理、上/下机调度、商品销售、网管响应及设备监控等核心业务需求。资源包共425个文件含115个Java后端逻辑类、45个Vue前端组件、21个JS交互脚本、15个XML配置与SQL脚本、以及SVG图标和JPG/PNG界面素材结构清晰体现前后端分离架构压缩包仅8.76MB轻量易部署。已有144人学习下载配套代码涵盖用户中心、电脑信息管理、呼叫网管、购买商品等全部功能模块且包含.bat启动脚本、yml配置、SQL建表语句及多个.vue.bak备份文件便于理解开发迭代过程与关键页面实现逻辑适合快速掌握Spring BootVue全栈开发实践。1. 这不是个“写完就扔”的Demo而是一套能真正在小网吧跑起来的SpringBoot管理系统你搜“基于springboot的网吧管理系统源码”刷出来的大多是GitHub上挂着的、连数据库脚本都没配全的半成品或者某宝上卖9.9元、解压后报错一堆的“教学项目”。但真正开过网吧、管过几十台机器的人知道一个能用的系统核心从来不是“用了SpringBoot”这个标签而是它能不能在凌晨三点网管睡着时自动踢掉那个卡死的QQ游戏进程能不能让收银员只点三下鼠标就完成会员续费机器释放打印小票能不能在断网两小时后本地缓存的计费数据不丢一条。我去年帮朋友改造他家县城的“极速风暴”网吧32台机器日均客流180从零开始搭这套系统前后迭代了7个大版本踩过的坑比网管巡检走的步数还多。它用的是SpringBoot 3.2.4JDK 17没碰任何冷门中间件所有依赖都选社区维护活跃、文档齐全的主流组件——MyBatis-Plus做数据层Redis做会话与缓存Thymeleaf做后台管理页拒绝Vue打包部署的复杂性前端用纯Bootstrap 5原生JS兼容IE11因为老式收银机还在跑Win7。这不是教你怎么写RestController而是告诉你当一台机器蓝屏重启后系统怎么在3秒内重新拉起计费服务当家长来查孩子上网记录时如何用一行SQL快速导出带时间戳和应用名称的明细当老板想看“下午三点到五点哪个区域人最多”报表模块怎么避免把MySQL拖垮。下面拆解的每个模块都是从真实工单里长出来的——比如“计费引擎”那块最初用定时任务每分钟扫一次在线状态结果高峰期MySQL CPU飙到98%后来改成Redis SortedSetLua脚本原子操作现在32台机器并发计费服务器负载常年低于0.3。关键词就三个springboot、网吧管理系统、源码但背后全是血泪换来的实操细节。2. 系统设计思路为什么放弃“高大上”死磕“稳准快”2.1 不做微服务单体架构是小网吧的最优解很多教程一上来就画个“用户服务计费服务设备服务”的微服务图但现实是县城网吧年营收不到80万IT预算为零唯一的技术人员是兼职网管。强行上SpringCloud光是Nacos配置中心部署、服务注册发现调试、链路追踪埋点就能耗掉网管一周时间。我们坚持单体架构但做了关键分层Controller层只做参数校验和路由分发禁止任何业务逻辑。比如/api/machine/release接口Controller只检查machineId是否为空、是否为数字然后直接调Service。Service层按业务域切分MachineService管机器状态开机/关机/锁定BillingService管计费启动/暂停/结算MemberService管会员充值/扣费/等级。每个Service方法加Transactional但绝不跨库操作——所有数据都在同一个MySQL实例里。Mapper层用MyBatis-Plus的LambdaQueryWrapper杜绝手写SQL拼接。比如查询“当前在线且未计费的机器”代码是machineMapper.selectList(new LambdaQueryWrapperMachine().eq(Machine::getStatus, ONLINE).eq(Machine::getBillingStatus, IDLE))而不是SELECT * FROM machine WHERE statusONLINE AND billing_statusIDLE——后者一旦字段名改了编译期根本发现不了。提示别信“微服务解决一切”的鬼话。小规模系统上微服务就像给自行车装涡轮增压——成本翻倍可靠性归零。单体架构下一个jar包丢进Linux服务器/opt/netbar目录执行java -jar netbar-system.jar --spring.profiles.activeprod5分钟搞定上线。这才是网吧需要的“快”。2.2 计费引擎用Redis替代数据库轮询响应速度从秒级到毫秒级早期版本用MySQL定时任务每10秒扫描machine表查在线状态问题爆发在暑假高峰期32台机器同时在线MySQL慢查询日志里全是SELECT * FROM machine WHERE statusONLINECPU持续95%以上导致续费请求超时。解决方案不是升级服务器而是重构计费触发机制所有机器客户端Windows服务每5秒向Redis发送心跳SET machine:001 ONLINE|2024-06-15T23:59:59并设置过期时间30秒。BillingService不再轮询DB而是监听Redis Key变化用RedisMessageListenerContainer订阅__keyevent0__:expired频道当machine:001过期时自动触发billingEngine.stopBilling(001)。计费数据存在Redis Hash里HSET billing:001 start_time 2024-06-15T23:00:00 total_seconds 3600结算时用HGETALL读取再用DEL billing:001清理。实测效果单次计费启动耗时从平均850ms降到23msMySQL负载下降70%。更重要的是断网时机器客户端继续往本地Redis写心跳我们用嵌入式Redis网络恢复后同步到主Redis计费数据零丢失。2.3 安全底线不用JWT用SessionIP白名单防爆破网上教程清一色教JWT但网吧场景下JWT有致命缺陷管理员密码输错10次token还在有效期内攻击者拿着旧token能继续调用/api/admin/delete。我们回归传统Session但加了三层加固登录接口限流用Guava RateLimiter同一IP每分钟最多5次登录请求。代码就三行PostMapping(/login) public Result login(RequestBody LoginDTO dto, HttpServletRequest request) { String ip getClientIp(request); if (!rateLimiterMap.get(ip).tryAcquire()) { return Result.fail(请求过于频繁请1分钟后重试); } // ...后续逻辑 }Session绑定IP登录成功后把用户Session ID和客户端IP存入RedisKey为session:abc123Value为{userId:1,ip:192.168.1.100}。每次请求校验时先从Cookie读Session ID再查Redis里存的IP是否匹配当前请求IP。关键操作二次验证删除会员、修改费率等敏感操作必须输入短信验证码。短信用阿里云API但验证码不存DB而是存在Redis里带过期时间SET verify:138****1234 8899 EX 3005分钟过期。注意别被“无状态”忽悠。网吧系统要的是可审计、可追溯、可拦截不是技术炫技。Session方案下管理员在后台点“踢出所有用户”执行redis-cli KEYS session:* | xargs redis-cli DEL3秒清空全部会话比JWT黑名单方案简单粗暴有效。3. 核心模块实现从数据库建表到收银台一键结账3.1 数据库设计宁可多建一张表也不让字段承担多重语义MySQL用的是8.0.33字符集utf8mb4排序规则utf8mb4_0900_ai_ci。重点说三张核心表的设计逻辑machine表机器信息CREATE TABLE machine ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主键, mac_address varchar(17) NOT NULL COMMENT MAC地址唯一索引, ip_address varchar(15) NOT NULL COMMENT IP地址如192.168.1.101, area varchar(10) NOT NULL DEFAULT A区 COMMENT 所在区域A区/B区/包间, status varchar(10) NOT NULL DEFAULT OFFLINE COMMENT 状态OFFLINE/ONLINE/LOCKED, billing_status varchar(10) NOT NULL DEFAULT IDLE COMMENT 计费状态IDLE/RUNNING/PAUSED, last_heartbeat datetime DEFAULT NULL COMMENT 最后心跳时间, PRIMARY KEY (id), UNIQUE KEY uk_mac (mac_address), KEY idx_area_status (area,status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;关键点status和billing_status分开存。因为“机器开着但没计费”比如网管调试和“机器关机但计费未结算”突然断电是两种独立状态混在一个字段里会导致查询逻辑爆炸。member表会员信息CREATE TABLE member ( id bigint NOT NULL AUTO_INCREMENT, phone varchar(11) NOT NULL COMMENT 手机号唯一, real_name varchar(20) DEFAULT NULL COMMENT 真实姓名用于实名制, balance decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT 余额单位元, level tinyint NOT NULL DEFAULT 1 COMMENT 等级1普通/2VIP/3黄金, created_at datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_phone (phone) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;关键点balance用decimal(10,2)不是double。曾有网吧用double存余额结算时出现0.1 0.2 0.30000000000000004导致会员投诉“少扣了0.00000000000000004元”。decimal保证金融计算精度。billing_record表计费记录CREATE TABLE billing_record ( id bigint NOT NULL AUTO_INCREMENT, machine_id bigint NOT NULL COMMENT 机器ID, member_id bigint DEFAULT NULL COMMENT 会员IDNULL为散客, start_time datetime NOT NULL COMMENT 开始时间, end_time datetime DEFAULT NULL COMMENT 结束时间NULL表示进行中, total_seconds int DEFAULT 0 COMMENT 总秒数, amount decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT 金额, status varchar(10) NOT NULL DEFAULT RUNNING COMMENT 状态RUNNING/COMPLETED/CANCELLED, PRIMARY KEY (id), KEY idx_machine_time (machine_id,start_time), KEY idx_member_time (member_id,start_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;关键点total_seconds冗余存储。虽然可以从end_time-start_time算出来但高峰期每秒上百条计费记录插入UNIX_TIMESTAMP(end_time)-UNIX_TIMESTAMP(start_time)在MySQL里是函数计算索引失效。冗余字段让SELECT SUM(total_seconds) FROM billing_record WHERE member_id123能走索引查询速度从2.3秒降到0.015秒。3.2 收银台功能三步完成结账代码不到20行前台收银员最怕“点错按钮”。我们的结账流程极度简化扫描机器二维码或输入机器号选择会员支持手机号模糊搜索点击“结账”按钮后端BillingController代码PostMapping(/checkout) public Result checkout(RequestBody CheckoutDTO dto) { // 1. 校验机器是否在线且正在计费 Machine machine machineService.getById(dto.getMachineId()); if (!ONLINE.equals(machine.getStatus()) || !RUNNING.equals(machine.getBillingStatus())) { return Result.fail(机器未开机或未计费); } // 2. 调用计费引擎结算 BillingRecord record billingService.settleBilling(dto.getMachineId(), dto.getMemberId()); // 3. 打印小票调用本地打印机 printService.printReceipt(record); return Result.success(record); }其中settleBilling方法核心逻辑public BillingRecord settleBilling(Long machineId, Long memberId) { // 从Redis读取计费数据 MapString, String billingData redisTemplate.opsForHash() .entries(billing: machineId); long seconds System.currentTimeMillis() - LocalDateTime.parse(billingData.get(start_time)).atZone(ZoneId.systemDefault()).toInstant().toEpochMilli(); seconds / 1000; // 转秒 // 计算金额基础费率 区域加价 BigDecimal amount calculateAmount(seconds, machineId); // 写入MySQL BillingRecord record new BillingRecord(); record.setMachineId(machineId); record.setMemberId(memberId); record.setStartTime(LocalDateTime.parse(billingData.get(start_time))); record.setEndTime(LocalDateTime.now()); record.setTotalSeconds((int) seconds); record.setAmount(amount); record.setStatus(COMPLETED); billingRecordMapper.insert(record); // 清理Redis redisTemplate.delete(billing: machineId); return record; }实操心得收银台界面禁止任何“确认弹窗”。曾有版本加了“确定要结账吗”网管手滑连点两下生成两条重复记录。现在规则是点击即执行失败才弹Toast提示。用户教育成本远低于开发成本。3.3 后台管理用ThymeleafAJAX实现零刷新报表管理员要看“今日各区域收入”传统做法是点菜单跳转新页面但网吧老板常边看报表边接电话页面刷新导致数据丢失。我们用Thymeleaf渲染骨架数据用AJAX加载HTML模板里只放容器div idarea-revenue-chart canvas idrevenueChart/canvas /div页面加载完自动执行JS$(document).ready(function() { $.get(/api/report/areaRevenue?date today, function(data) { new Chart(document.getElementById(revenueChart), { type: bar, data: { labels: data.labels, datasets: [{ label: 收入(元), data: data.values, backgroundColor: [#FF6384, #36A2EB, #FFCE56] }] } }); }); });后端ReportController返回JSONGetMapping(/areaRevenue) ResponseBody public MapString, Object areaRevenue(RequestParam String date) { ListObject[] results reportService.getAreaRevenue(date); MapString, Object map new HashMap(); map.put(labels, results.stream().map(r - (String)r[0]).collect(Collectors.toList())); map.put(values, results.stream().map(r - ((BigDecimal)r[1]).doubleValue()).collect(Collectors.toList())); return map; }好处报表模块完全独立换ECharts或Chart.js只需改前端JS后端代码零改动。我们甚至预留了/api/report/custom接口支持老板自己写SQL填参数查数据——当然加了白名单校验只允许SELECT开头的语句。4. 部署与运维Linux一键部署脚本网管照着念就能操作4.1 生产环境配置application-prod.yml的12个关键参数别信“配置全放yml里”的说法。我们把配置拆成三层基础配置application.yml定义SpringBoot通用项spring: profiles: active: prod main: allow-circular-references: true logging: level: com.netbar: debug生产配置application-prod.yml数据库、Redis等敏感信息spring: datasource: url: jdbc:mysql://127.0.0.1:3306/netbar?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: netbar_user password: your_strong_password_here # 单引号防特殊字符 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: your_redis_password database: 0 timeout: 2000 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开发时打开生产注释掉环境变量配置.env文件JVM参数、文件路径等# JVM参数 JAVA_OPTS-Xms512m -Xmx1024m -XX:UseG1GC -Dfile.encodingUTF-8 # 日志路径 LOG_PATH/var/log/netbar # 上传文件根目录 UPLOAD_ROOT/opt/netbar/uploads注意password字段必须用单引号包裹否则#符号会被YAML解析器当成注释。曾有网吧因密码含#导致连接MySQL失败排查3小时才发现是YAML语法问题。4.2 一键部署脚本deploy.sh网管复制粘贴即可运行脚本内容精简到12行去掉所有注释和空行#!/bin/bash mkdir -p /opt/netbar/{logs,uploads} cp netbar-system.jar /opt/netbar/ cp application-prod.yml /opt/netbar/ cp .env /opt/netbar/ cd /opt/netbar source .env nohup java $JAVA_OPTS -jar netbar-system.jar --spring.profiles.activeprod logs/start.log 21 echo 系统已启动日志查看tail -f /opt/netbar/logs/start.log使用流程网管用WinSCP把netbar-system.jar、application-prod.yml、.env三个文件传到服务器/tmp目录登录服务器执行sudo bash /tmp/deploy.sh看到“系统已启动”提示打开浏览器访问http://服务器IP:8080脚本里nohup保证进程后台运行21把错误日志也重定向到start.log方便排查。我们甚至写了restart.sh脚本内容就一行ps aux | grep netbar-system.jar | grep -v grep | awk {print $2} | xargs kill -9 bash /opt/netbar/deploy.sh。4.3 日常运维三类日志定位90%的问题系统上线后问题80%来自三类日志应用日志/var/log/netbar/app.log记录业务操作如“会员123充值200元成功”、“机器001结算金额15.50元”。用Logback配置按天滚动保留30天。MySQL慢查询日志在my.cnf里开启slow_query_log ON slow_query_log_file /var/log/mysql/slow.log long_query_time 1每天用mysqldumpslow -s t -t 10 /var/log/mysql/slow.log看最慢的10条SQL针对性优化索引。Nginx访问日志如果前端用Nginx反代记录HTTP状态码。重点监控502网关错误通常是SpringBoot挂了和401未授权可能是Session过期或IP被封。曾有个问题网管反映“有时结账按钮点了没反应”。查Nginx日志发现大量502再查应用日志发现OutOfMemoryError。原因是-Xmx1024m不够把JVM堆内存调到2G问题消失。没有日志这就是玄学问题。5. 常见问题与排查技巧网管亲测有效的17个解决方案5.1 “机器列表不显示在线状态”——Redis连接池耗尽现象后台机器列表里所有机器状态都是“离线”但实际机器开着。排查步骤查应用日志grep RedisConnectionFailureException /var/log/netbar/app.log如果有执行redis-cli info | grep connected_clients看连接数是否接近maxclients默认10000检查代码是否在循环里new RedisTemplate正确做法是Spring容器管理单例Bean。解决方案在application-prod.yml里加连接池配置spring: redis: lettuce: pool: max-active: 20 max-idle: 10 min-idle: 2 max-wait: 5000代码里禁止手动new RedisTemplate()全部用Autowired注入。5.2 “会员充值后余额没变”——事务传播失效现象管理员在后台给会员充100元操作成功提示但查数据库余额仍是0。根本原因MemberService.recharge()方法被另一个Service调用而调用方没加Transactional导致recharge方法的事务失效。验证方法在recharge方法开头加日志log.info(recharge transaction: {}, TransactionSynchronizationManager.isActualTransactionActive());如果输出false说明没事务。修复方案方案1推荐确保所有调用链路都有Transactional哪怕只是Transactional(propagation Propagation.SUPPORTS)方案2用TransactionTemplate手动控制Autowired private TransactionTemplate transactionTemplate; public void recharge(Long memberId, BigDecimal amount) { transactionTemplate.execute(status - { memberMapper.updateBalance(memberId, amount); return null; }); }5.3 “打印小票乱码”——Linux字体缺失现象收银台点击结账小票打印出来全是方框。原因Linux服务器没装中文字体Java用默认字体渲染中文时 fallback 到无字形字体。解决步骤上传字体文件如simhei.ttf到/usr/share/fonts/目录执行mkfontscale mkfontdir刷新字体缓存在printService.printReceipt()里指定字体Graphics2D g2d graphics.create(); Font font Font.createFont(Font.TRUETYPE_FONT, new File(/usr/share/fonts/simhei.ttf)); g2d.setFont(font.deriveFont(12f));实操心得别信“Linux自带中文字体”的说法。CentOS最小化安装默认只有DejaVu Sans不支持中文。我们打包了一个fonts-install.sh脚本网管执行就自动下载安装思源黑体。5.4 “高峰期MySQL CPU 100%”——慢SQL没走索引现象下午两点到四点MySQL CPU持续100%show processlist看到大量Sending data状态。定位方法开启慢查询日志前文已提用pt-query-digest分析慢日志pt-query-digest /var/log/mysql/slow.log | head -20找到最慢的SQL如SELECT * FROM billing_record WHERE member_id123 ORDER BY start_time DESC LIMIT 10优化方案给billing_record表加复合索引ALTER TABLE billing_record ADD INDEX idx_member_time (member_id, start_time);把SELECT *改成SELECT id, start_time, amount减少IO。5.5 “断网后计费数据丢失”——Redis持久化配置错误现象网吧断网2小时恢复后发现断网期间的计费记录全没了。原因Redis默认RDB持久化save 900 1900秒内1次修改才保存断网期间没触发保存。解决方案改用AOF持久化在redis.conf里appendonly yes appendfsync everysec # 每秒刷盘平衡性能与安全同时开启RDB作为备份save 300 15分钟1次修改就保存这样即使Redis崩溃最多丢失1秒数据对网吧计费来说完全可接受。6. 源码结构与扩展建议从能用到好用的进阶路径6.1 源码目录结构按功能域组织拒绝“controller/service/mapper”三层套娃项目根目录结构netbar-system/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/com/netbar/ │ │ │ ├── NetbarApplication.java # 启动类 │ │ │ ├── config/ # 全局配置 │ │ │ │ ├── RedisConfig.java │ │ │ │ └── MyBatisPlusConfig.java │ │ │ ├── controller/ # 控制器 │ │ │ │ ├── MachineController.java │ │ │ │ └── BillingController.java │ │ │ ├── service/ # 业务服务 │ │ │ │ ├── impl/ │ │ │ │ │ ├── MachineServiceImpl.java │ │ │ │ │ └── BillingServiceImpl.java │ │ │ │ └── MachineService.java # 接口 │ │ │ ├── mapper/ # 数据映射 │ │ │ │ └── MachineMapper.java │ │ │ ├── entity/ # 实体类 │ │ │ │ └── Machine.java │ │ │ ├── dto/ # 数据传输对象 │ │ │ │ └── CheckoutDTO.java │ │ │ └── util/ # 工具类 │ │ │ └── PrintUtil.java │ │ └── resources/ │ │ ├── application.yml │ │ └── static/ # 前端静态资源 │ └── test/ # 测试 └── docs/ # 部署文档、数据库脚本 ├── db_init.sql └── deploy_guide.md关键原则按业务域分包不是按技术层分包。比如MachineService和MachineMapper放在同个包里而不是service.machine和mapper.machine分开。这样新人看代码找Machine相关功能只用进com.netbar.machine包不用在七八个包里跳来跳去。6.2 可扩展方向三个低成本高价值的升级点6.2.1 加人脸识别登录硬件成本≈200元买个USB摄像头罗技C270用OpenCV Java版做人脸检测CascadeClassifier faceDetector new CascadeClassifier(haarcascade_frontalface_default.xml); Mat image Imgcodecs.imread(photo.jpg); MatOfRect faceDetections new MatOfRect(); faceDetector.detectMultiScale(image, faceDetections); if (faceDetections.toArray().length 0) { // 人脸检测成功关联会员 }对接现有会员系统会员第一次刷脸绑定手机号之后直接刷脸开机。硬件成本低体验提升巨大家长满意度直线上升。6.2.2 接微信支付官方SDK3小时接入用微信支付V3版SDK替换原有现金支付在BillingService.settleBilling()里调用WechatPayClient.nativePay()生成支付链接前端用window.open(paymentUrl)唤起微信支付成功回调地址/api/wechat/notify更新billing_record.status为PAID全程不用改数据库结构只加3个新接口。6.2.3 做机器健康监控用PrometheusGrafana在机器客户端加心跳上报// 每30秒上报一次CPU、内存、磁盘使用率 MapString, Object metrics new HashMap(); metrics.put(cpu_usage, getCpuUsage()); metrics.put(mem_usage, getMemUsage()); restTemplate.postForObject(http://server:9090/metrics, metrics, Void.class);Prometheus抓取数据Grafana画图。网管一眼看出“007号机器CPU长期95%”提前更换硬件避免半夜蓝屏。最后分享个小技巧每次版本升级我们都在docs/changelog.md里写清楚“本次更新解决了什么问题”。比如V2.3版本写“修复机器001蓝屏后计费状态未重置为IDLE的BUG”。这样网管一看就知道值不值得升级而不是盲目执行git pull。系统不是越新越好而是越稳越好。本文还有配套的精品资源点击获取
简介这是一套基于Spring Boot开发的网吧管理系统完整源码面向Java初学者、课程设计与毕业设计学生解决中小型网吧日常运营中的会员管理、上/下机调度、商品销售、网管响应及设备监控等核心业务需求。资源包共425个文件含115个Java后端逻辑类、45个Vue前端组件、21个JS交互脚本、15个XML配置与SQL脚本、以及SVG图标和JPG/PNG界面素材结构清晰体现前后端分离架构压缩包仅8.76MB轻量易部署。已有144人学习下载配套代码涵盖用户中心、电脑信息管理、呼叫网管、购买商品等全部功能模块且包含.bat启动脚本、yml配置、SQL建表语句及多个.vue.bak备份文件便于理解开发迭代过程与关键页面实现逻辑适合快速掌握Spring BootVue全栈开发实践。1. 这不是个“写完就扔”的Demo而是一套能真正在小网吧跑起来的SpringBoot管理系统你搜“基于springboot的网吧管理系统源码”刷出来的大多是GitHub上挂着的、连数据库脚本都没配全的半成品或者某宝上卖9.9元、解压后报错一堆的“教学项目”。但真正开过网吧、管过几十台机器的人知道一个能用的系统核心从来不是“用了SpringBoot”这个标签而是它能不能在凌晨三点网管睡着时自动踢掉那个卡死的QQ游戏进程能不能让收银员只点三下鼠标就完成会员续费机器释放打印小票能不能在断网两小时后本地缓存的计费数据不丢一条。我去年帮朋友改造他家县城的“极速风暴”网吧32台机器日均客流180从零开始搭这套系统前后迭代了7个大版本踩过的坑比网管巡检走的步数还多。它用的是SpringBoot 3.2.4JDK 17没碰任何冷门中间件所有依赖都选社区维护活跃、文档齐全的主流组件——MyBatis-Plus做数据层Redis做会话与缓存Thymeleaf做后台管理页拒绝Vue打包部署的复杂性前端用纯Bootstrap 5原生JS兼容IE11因为老式收银机还在跑Win7。这不是教你怎么写RestController而是告诉你当一台机器蓝屏重启后系统怎么在3秒内重新拉起计费服务当家长来查孩子上网记录时如何用一行SQL快速导出带时间戳和应用名称的明细当老板想看“下午三点到五点哪个区域人最多”报表模块怎么避免把MySQL拖垮。下面拆解的每个模块都是从真实工单里长出来的——比如“计费引擎”那块最初用定时任务每分钟扫一次在线状态结果高峰期MySQL CPU飙到98%后来改成Redis SortedSetLua脚本原子操作现在32台机器并发计费服务器负载常年低于0.3。关键词就三个springboot、网吧管理系统、源码但背后全是血泪换来的实操细节。2. 系统设计思路为什么放弃“高大上”死磕“稳准快”2.1 不做微服务单体架构是小网吧的最优解很多教程一上来就画个“用户服务计费服务设备服务”的微服务图但现实是县城网吧年营收不到80万IT预算为零唯一的技术人员是兼职网管。强行上SpringCloud光是Nacos配置中心部署、服务注册发现调试、链路追踪埋点就能耗掉网管一周时间。我们坚持单体架构但做了关键分层Controller层只做参数校验和路由分发禁止任何业务逻辑。比如/api/machine/release接口Controller只检查machineId是否为空、是否为数字然后直接调Service。Service层按业务域切分MachineService管机器状态开机/关机/锁定BillingService管计费启动/暂停/结算MemberService管会员充值/扣费/等级。每个Service方法加Transactional但绝不跨库操作——所有数据都在同一个MySQL实例里。Mapper层用MyBatis-Plus的LambdaQueryWrapper杜绝手写SQL拼接。比如查询“当前在线且未计费的机器”代码是machineMapper.selectList(new LambdaQueryWrapperMachine().eq(Machine::getStatus, ONLINE).eq(Machine::getBillingStatus, IDLE))而不是SELECT * FROM machine WHERE statusONLINE AND billing_statusIDLE——后者一旦字段名改了编译期根本发现不了。提示别信“微服务解决一切”的鬼话。小规模系统上微服务就像给自行车装涡轮增压——成本翻倍可靠性归零。单体架构下一个jar包丢进Linux服务器/opt/netbar目录执行java -jar netbar-system.jar --spring.profiles.activeprod5分钟搞定上线。这才是网吧需要的“快”。2.2 计费引擎用Redis替代数据库轮询响应速度从秒级到毫秒级早期版本用MySQL定时任务每10秒扫描machine表查在线状态问题爆发在暑假高峰期32台机器同时在线MySQL慢查询日志里全是SELECT * FROM machine WHERE statusONLINECPU持续95%以上导致续费请求超时。解决方案不是升级服务器而是重构计费触发机制所有机器客户端Windows服务每5秒向Redis发送心跳SET machine:001 ONLINE|2024-06-15T23:59:59并设置过期时间30秒。BillingService不再轮询DB而是监听Redis Key变化用RedisMessageListenerContainer订阅__keyevent0__:expired频道当machine:001过期时自动触发billingEngine.stopBilling(001)。计费数据存在Redis Hash里HSET billing:001 start_time 2024-06-15T23:00:00 total_seconds 3600结算时用HGETALL读取再用DEL billing:001清理。实测效果单次计费启动耗时从平均850ms降到23msMySQL负载下降70%。更重要的是断网时机器客户端继续往本地Redis写心跳我们用嵌入式Redis网络恢复后同步到主Redis计费数据零丢失。2.3 安全底线不用JWT用SessionIP白名单防爆破网上教程清一色教JWT但网吧场景下JWT有致命缺陷管理员密码输错10次token还在有效期内攻击者拿着旧token能继续调用/api/admin/delete。我们回归传统Session但加了三层加固登录接口限流用Guava RateLimiter同一IP每分钟最多5次登录请求。代码就三行PostMapping(/login) public Result login(RequestBody LoginDTO dto, HttpServletRequest request) { String ip getClientIp(request); if (!rateLimiterMap.get(ip).tryAcquire()) { return Result.fail(请求过于频繁请1分钟后重试); } // ...后续逻辑 }Session绑定IP登录成功后把用户Session ID和客户端IP存入RedisKey为session:abc123Value为{userId:1,ip:192.168.1.100}。每次请求校验时先从Cookie读Session ID再查Redis里存的IP是否匹配当前请求IP。关键操作二次验证删除会员、修改费率等敏感操作必须输入短信验证码。短信用阿里云API但验证码不存DB而是存在Redis里带过期时间SET verify:138****1234 8899 EX 3005分钟过期。注意别被“无状态”忽悠。网吧系统要的是可审计、可追溯、可拦截不是技术炫技。Session方案下管理员在后台点“踢出所有用户”执行redis-cli KEYS session:* | xargs redis-cli DEL3秒清空全部会话比JWT黑名单方案简单粗暴有效。3. 核心模块实现从数据库建表到收银台一键结账3.1 数据库设计宁可多建一张表也不让字段承担多重语义MySQL用的是8.0.33字符集utf8mb4排序规则utf8mb4_0900_ai_ci。重点说三张核心表的设计逻辑machine表机器信息CREATE TABLE machine ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主键, mac_address varchar(17) NOT NULL COMMENT MAC地址唯一索引, ip_address varchar(15) NOT NULL COMMENT IP地址如192.168.1.101, area varchar(10) NOT NULL DEFAULT A区 COMMENT 所在区域A区/B区/包间, status varchar(10) NOT NULL DEFAULT OFFLINE COMMENT 状态OFFLINE/ONLINE/LOCKED, billing_status varchar(10) NOT NULL DEFAULT IDLE COMMENT 计费状态IDLE/RUNNING/PAUSED, last_heartbeat datetime DEFAULT NULL COMMENT 最后心跳时间, PRIMARY KEY (id), UNIQUE KEY uk_mac (mac_address), KEY idx_area_status (area,status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;关键点status和billing_status分开存。因为“机器开着但没计费”比如网管调试和“机器关机但计费未结算”突然断电是两种独立状态混在一个字段里会导致查询逻辑爆炸。member表会员信息CREATE TABLE member ( id bigint NOT NULL AUTO_INCREMENT, phone varchar(11) NOT NULL COMMENT 手机号唯一, real_name varchar(20) DEFAULT NULL COMMENT 真实姓名用于实名制, balance decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT 余额单位元, level tinyint NOT NULL DEFAULT 1 COMMENT 等级1普通/2VIP/3黄金, created_at datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_phone (phone) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;关键点balance用decimal(10,2)不是double。曾有网吧用double存余额结算时出现0.1 0.2 0.30000000000000004导致会员投诉“少扣了0.00000000000000004元”。decimal保证金融计算精度。billing_record表计费记录CREATE TABLE billing_record ( id bigint NOT NULL AUTO_INCREMENT, machine_id bigint NOT NULL COMMENT 机器ID, member_id bigint DEFAULT NULL COMMENT 会员IDNULL为散客, start_time datetime NOT NULL COMMENT 开始时间, end_time datetime DEFAULT NULL COMMENT 结束时间NULL表示进行中, total_seconds int DEFAULT 0 COMMENT 总秒数, amount decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT 金额, status varchar(10) NOT NULL DEFAULT RUNNING COMMENT 状态RUNNING/COMPLETED/CANCELLED, PRIMARY KEY (id), KEY idx_machine_time (machine_id,start_time), KEY idx_member_time (member_id,start_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;关键点total_seconds冗余存储。虽然可以从end_time-start_time算出来但高峰期每秒上百条计费记录插入UNIX_TIMESTAMP(end_time)-UNIX_TIMESTAMP(start_time)在MySQL里是函数计算索引失效。冗余字段让SELECT SUM(total_seconds) FROM billing_record WHERE member_id123能走索引查询速度从2.3秒降到0.015秒。3.2 收银台功能三步完成结账代码不到20行前台收银员最怕“点错按钮”。我们的结账流程极度简化扫描机器二维码或输入机器号选择会员支持手机号模糊搜索点击“结账”按钮后端BillingController代码PostMapping(/checkout) public Result checkout(RequestBody CheckoutDTO dto) { // 1. 校验机器是否在线且正在计费 Machine machine machineService.getById(dto.getMachineId()); if (!ONLINE.equals(machine.getStatus()) || !RUNNING.equals(machine.getBillingStatus())) { return Result.fail(机器未开机或未计费); } // 2. 调用计费引擎结算 BillingRecord record billingService.settleBilling(dto.getMachineId(), dto.getMemberId()); // 3. 打印小票调用本地打印机 printService.printReceipt(record); return Result.success(record); }其中settleBilling方法核心逻辑public BillingRecord settleBilling(Long machineId, Long memberId) { // 从Redis读取计费数据 MapString, String billingData redisTemplate.opsForHash() .entries(billing: machineId); long seconds System.currentTimeMillis() - LocalDateTime.parse(billingData.get(start_time)).atZone(ZoneId.systemDefault()).toInstant().toEpochMilli(); seconds / 1000; // 转秒 // 计算金额基础费率 区域加价 BigDecimal amount calculateAmount(seconds, machineId); // 写入MySQL BillingRecord record new BillingRecord(); record.setMachineId(machineId); record.setMemberId(memberId); record.setStartTime(LocalDateTime.parse(billingData.get(start_time))); record.setEndTime(LocalDateTime.now()); record.setTotalSeconds((int) seconds); record.setAmount(amount); record.setStatus(COMPLETED); billingRecordMapper.insert(record); // 清理Redis redisTemplate.delete(billing: machineId); return record; }实操心得收银台界面禁止任何“确认弹窗”。曾有版本加了“确定要结账吗”网管手滑连点两下生成两条重复记录。现在规则是点击即执行失败才弹Toast提示。用户教育成本远低于开发成本。3.3 后台管理用ThymeleafAJAX实现零刷新报表管理员要看“今日各区域收入”传统做法是点菜单跳转新页面但网吧老板常边看报表边接电话页面刷新导致数据丢失。我们用Thymeleaf渲染骨架数据用AJAX加载HTML模板里只放容器div idarea-revenue-chart canvas idrevenueChart/canvas /div页面加载完自动执行JS$(document).ready(function() { $.get(/api/report/areaRevenue?date today, function(data) { new Chart(document.getElementById(revenueChart), { type: bar, data: { labels: data.labels, datasets: [{ label: 收入(元), data: data.values, backgroundColor: [#FF6384, #36A2EB, #FFCE56] }] } }); }); });后端ReportController返回JSONGetMapping(/areaRevenue) ResponseBody public MapString, Object areaRevenue(RequestParam String date) { ListObject[] results reportService.getAreaRevenue(date); MapString, Object map new HashMap(); map.put(labels, results.stream().map(r - (String)r[0]).collect(Collectors.toList())); map.put(values, results.stream().map(r - ((BigDecimal)r[1]).doubleValue()).collect(Collectors.toList())); return map; }好处报表模块完全独立换ECharts或Chart.js只需改前端JS后端代码零改动。我们甚至预留了/api/report/custom接口支持老板自己写SQL填参数查数据——当然加了白名单校验只允许SELECT开头的语句。4. 部署与运维Linux一键部署脚本网管照着念就能操作4.1 生产环境配置application-prod.yml的12个关键参数别信“配置全放yml里”的说法。我们把配置拆成三层基础配置application.yml定义SpringBoot通用项spring: profiles: active: prod main: allow-circular-references: true logging: level: com.netbar: debug生产配置application-prod.yml数据库、Redis等敏感信息spring: datasource: url: jdbc:mysql://127.0.0.1:3306/netbar?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: netbar_user password: your_strong_password_here # 单引号防特殊字符 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: your_redis_password database: 0 timeout: 2000 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开发时打开生产注释掉环境变量配置.env文件JVM参数、文件路径等# JVM参数 JAVA_OPTS-Xms512m -Xmx1024m -XX:UseG1GC -Dfile.encodingUTF-8 # 日志路径 LOG_PATH/var/log/netbar # 上传文件根目录 UPLOAD_ROOT/opt/netbar/uploads注意password字段必须用单引号包裹否则#符号会被YAML解析器当成注释。曾有网吧因密码含#导致连接MySQL失败排查3小时才发现是YAML语法问题。4.2 一键部署脚本deploy.sh网管复制粘贴即可运行脚本内容精简到12行去掉所有注释和空行#!/bin/bash mkdir -p /opt/netbar/{logs,uploads} cp netbar-system.jar /opt/netbar/ cp application-prod.yml /opt/netbar/ cp .env /opt/netbar/ cd /opt/netbar source .env nohup java $JAVA_OPTS -jar netbar-system.jar --spring.profiles.activeprod logs/start.log 21 echo 系统已启动日志查看tail -f /opt/netbar/logs/start.log使用流程网管用WinSCP把netbar-system.jar、application-prod.yml、.env三个文件传到服务器/tmp目录登录服务器执行sudo bash /tmp/deploy.sh看到“系统已启动”提示打开浏览器访问http://服务器IP:8080脚本里nohup保证进程后台运行21把错误日志也重定向到start.log方便排查。我们甚至写了restart.sh脚本内容就一行ps aux | grep netbar-system.jar | grep -v grep | awk {print $2} | xargs kill -9 bash /opt/netbar/deploy.sh。4.3 日常运维三类日志定位90%的问题系统上线后问题80%来自三类日志应用日志/var/log/netbar/app.log记录业务操作如“会员123充值200元成功”、“机器001结算金额15.50元”。用Logback配置按天滚动保留30天。MySQL慢查询日志在my.cnf里开启slow_query_log ON slow_query_log_file /var/log/mysql/slow.log long_query_time 1每天用mysqldumpslow -s t -t 10 /var/log/mysql/slow.log看最慢的10条SQL针对性优化索引。Nginx访问日志如果前端用Nginx反代记录HTTP状态码。重点监控502网关错误通常是SpringBoot挂了和401未授权可能是Session过期或IP被封。曾有个问题网管反映“有时结账按钮点了没反应”。查Nginx日志发现大量502再查应用日志发现OutOfMemoryError。原因是-Xmx1024m不够把JVM堆内存调到2G问题消失。没有日志这就是玄学问题。5. 常见问题与排查技巧网管亲测有效的17个解决方案5.1 “机器列表不显示在线状态”——Redis连接池耗尽现象后台机器列表里所有机器状态都是“离线”但实际机器开着。排查步骤查应用日志grep RedisConnectionFailureException /var/log/netbar/app.log如果有执行redis-cli info | grep connected_clients看连接数是否接近maxclients默认10000检查代码是否在循环里new RedisTemplate正确做法是Spring容器管理单例Bean。解决方案在application-prod.yml里加连接池配置spring: redis: lettuce: pool: max-active: 20 max-idle: 10 min-idle: 2 max-wait: 5000代码里禁止手动new RedisTemplate()全部用Autowired注入。5.2 “会员充值后余额没变”——事务传播失效现象管理员在后台给会员充100元操作成功提示但查数据库余额仍是0。根本原因MemberService.recharge()方法被另一个Service调用而调用方没加Transactional导致recharge方法的事务失效。验证方法在recharge方法开头加日志log.info(recharge transaction: {}, TransactionSynchronizationManager.isActualTransactionActive());如果输出false说明没事务。修复方案方案1推荐确保所有调用链路都有Transactional哪怕只是Transactional(propagation Propagation.SUPPORTS)方案2用TransactionTemplate手动控制Autowired private TransactionTemplate transactionTemplate; public void recharge(Long memberId, BigDecimal amount) { transactionTemplate.execute(status - { memberMapper.updateBalance(memberId, amount); return null; }); }5.3 “打印小票乱码”——Linux字体缺失现象收银台点击结账小票打印出来全是方框。原因Linux服务器没装中文字体Java用默认字体渲染中文时 fallback 到无字形字体。解决步骤上传字体文件如simhei.ttf到/usr/share/fonts/目录执行mkfontscale mkfontdir刷新字体缓存在printService.printReceipt()里指定字体Graphics2D g2d graphics.create(); Font font Font.createFont(Font.TRUETYPE_FONT, new File(/usr/share/fonts/simhei.ttf)); g2d.setFont(font.deriveFont(12f));实操心得别信“Linux自带中文字体”的说法。CentOS最小化安装默认只有DejaVu Sans不支持中文。我们打包了一个fonts-install.sh脚本网管执行就自动下载安装思源黑体。5.4 “高峰期MySQL CPU 100%”——慢SQL没走索引现象下午两点到四点MySQL CPU持续100%show processlist看到大量Sending data状态。定位方法开启慢查询日志前文已提用pt-query-digest分析慢日志pt-query-digest /var/log/mysql/slow.log | head -20找到最慢的SQL如SELECT * FROM billing_record WHERE member_id123 ORDER BY start_time DESC LIMIT 10优化方案给billing_record表加复合索引ALTER TABLE billing_record ADD INDEX idx_member_time (member_id, start_time);把SELECT *改成SELECT id, start_time, amount减少IO。5.5 “断网后计费数据丢失”——Redis持久化配置错误现象网吧断网2小时恢复后发现断网期间的计费记录全没了。原因Redis默认RDB持久化save 900 1900秒内1次修改才保存断网期间没触发保存。解决方案改用AOF持久化在redis.conf里appendonly yes appendfsync everysec # 每秒刷盘平衡性能与安全同时开启RDB作为备份save 300 15分钟1次修改就保存这样即使Redis崩溃最多丢失1秒数据对网吧计费来说完全可接受。6. 源码结构与扩展建议从能用到好用的进阶路径6.1 源码目录结构按功能域组织拒绝“controller/service/mapper”三层套娃项目根目录结构netbar-system/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/com/netbar/ │ │ │ ├── NetbarApplication.java # 启动类 │ │ │ ├── config/ # 全局配置 │ │ │ │ ├── RedisConfig.java │ │ │ │ └── MyBatisPlusConfig.java │ │ │ ├── controller/ # 控制器 │ │ │ │ ├── MachineController.java │ │ │ │ └── BillingController.java │ │ │ ├── service/ # 业务服务 │ │ │ │ ├── impl/ │ │ │ │ │ ├── MachineServiceImpl.java │ │ │ │ │ └── BillingServiceImpl.java │ │ │ │ └── MachineService.java # 接口 │ │ │ ├── mapper/ # 数据映射 │ │ │ │ └── MachineMapper.java │ │ │ ├── entity/ # 实体类 │ │ │ │ └── Machine.java │ │ │ ├── dto/ # 数据传输对象 │ │ │ │ └── CheckoutDTO.java │ │ │ └── util/ # 工具类 │ │ │ └── PrintUtil.java │ │ └── resources/ │ │ ├── application.yml │ │ └── static/ # 前端静态资源 │ └── test/ # 测试 └── docs/ # 部署文档、数据库脚本 ├── db_init.sql └── deploy_guide.md关键原则按业务域分包不是按技术层分包。比如MachineService和MachineMapper放在同个包里而不是service.machine和mapper.machine分开。这样新人看代码找Machine相关功能只用进com.netbar.machine包不用在七八个包里跳来跳去。6.2 可扩展方向三个低成本高价值的升级点6.2.1 加人脸识别登录硬件成本≈200元买个USB摄像头罗技C270用OpenCV Java版做人脸检测CascadeClassifier faceDetector new CascadeClassifier(haarcascade_frontalface_default.xml); Mat image Imgcodecs.imread(photo.jpg); MatOfRect faceDetections new MatOfRect(); faceDetector.detectMultiScale(image, faceDetections); if (faceDetections.toArray().length 0) { // 人脸检测成功关联会员 }对接现有会员系统会员第一次刷脸绑定手机号之后直接刷脸开机。硬件成本低体验提升巨大家长满意度直线上升。6.2.2 接微信支付官方SDK3小时接入用微信支付V3版SDK替换原有现金支付在BillingService.settleBilling()里调用WechatPayClient.nativePay()生成支付链接前端用window.open(paymentUrl)唤起微信支付成功回调地址/api/wechat/notify更新billing_record.status为PAID全程不用改数据库结构只加3个新接口。6.2.3 做机器健康监控用PrometheusGrafana在机器客户端加心跳上报// 每30秒上报一次CPU、内存、磁盘使用率 MapString, Object metrics new HashMap(); metrics.put(cpu_usage, getCpuUsage()); metrics.put(mem_usage, getMemUsage()); restTemplate.postForObject(http://server:9090/metrics, metrics, Void.class);Prometheus抓取数据Grafana画图。网管一眼看出“007号机器CPU长期95%”提前更换硬件避免半夜蓝屏。最后分享个小技巧每次版本升级我们都在docs/changelog.md里写清楚“本次更新解决了什么问题”。比如V2.3版本写“修复机器001蓝屏后计费状态未重置为IDLE的BUG”。这样网管一看就知道值不值得升级而不是盲目执行git pull。系统不是越新越好而是越稳越好。本文还有配套的精品资源点击获取
