Java毕设实战：电费管理系统核心模块与二次开发指南

Java毕设实战：电费管理系统核心模块与二次开发指南

发布时间：2026/10/21 8:53:32
Java毕设实战：电费管理系统核心模块与二次开发指南 简介这份资源是面向高校计算机相关专业学生与Java初学者的一套毕业设计完整项目源码主题为基于Java的电费管理系统可用于课程设计、毕业设计参考或自学练手。压缩包共158个文件整体约1.78MB以52个java源文件为核心配合24个js、19个html、14个css构建前端页面另有xml配置、properties参数文件、字体图标资源及Maven构建脚本等结构完整、便于二次开发。系统围绕用户管理、电费计算、缴费管理、数据统计与缴费提醒等模块展开采用Spring Boot结合MyBatis与MySQL实现后端前端使用Bootstrap等框架搭建响应式界面并集成Spring Security与JWT完成认证授权涵盖阶梯电价、峰谷电价等计费逻辑以及报表导出与短信提醒等实用功能。目前已有117人学习下载适合需要完整项目案例、想理解MVC分层设计与前后端协作流程的读者参考借鉴。1. 从一份 Java 毕设资源说起电费管理系统到底能跑出什么如果你正在找一份能直接跑起来的 Java 毕业设计又不想碰那种“只有登录页和一张静态表格”的演示壳子那这份电费管理系统值得花时间拆一拆。它解决的是一个很具体的场景小区、园区或宿舍楼的电表抄表、费用计算、缴费记录和欠费提醒全部塞进一个 Java Web 项目里。适合谁正在做毕设但缺一个完整业务闭环的计算机专业学生以及想拿一个中小型管理系统练手 CRUD、权限和报表逻辑的初级开发者。我见过太多毕设项目把“管理”两个字做成了摆设但这个系统至少把用户、电表、费率、账单、缴费这几条线串起来了跑通之后你能清楚看到一个费用从产生到结清的全过程。2. 技术栈与目录结构先看清骨架再动手2.1 技术选型为什么是这套组合从项目标题里的.zip和java能判断这是一个典型的 Java Web 工程。结合这类毕设项目的常见做法技术栈大概率落在SSMSpring Spring MVC MyBatis或Spring Boot MyBatis上。我拿到源码后第一件事就是看pom.xml或lib目录确认是 Maven 管理还是传统 Web 项目。如果是 Maven 项目pom.xml里会集中声明依赖。常见配置如下!-- pom.xml 核心依赖片段 -- dependencies !-- Spring 核心IoC 容器和事务管理 -- dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.3.x/version /dependency !-- Spring MVC处理 Web 请求和视图解析 -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.3.x/version /dependency !-- MyBatisSQL 映射与数据库操作 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.x/version /dependency !-- MySQL 驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.x/version /dependency !-- JSP 与 JSTL前端页面渲染 -- dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependencies这段配置说明项目走的是传统三层架构Controller 接请求Service 写业务DAO 层用 MyBatis 操作数据库。参数上要注意 Spring 和 MyBatis 的版本兼容5.3.x 配 3.5.x 是稳妥组合MySQL 驱动 8.0 以上要改 JDBC URL 里的时区和 SSL 参数。如果项目是 Spring Boot 版本那pom.xml里会看到spring-boot-starter-web和mybatis-spring-boot-starter启动类上会有SpringBootApplication。两种形态的改造思路不同后面章节会分开说。2.2 目录结构每个包在干什么解压后典型的目录长这样electricity-fee-system/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/example/efee/ │ │ │ ├── controller/ # 接收前端请求 │ │ │ ├── service/ # 业务逻辑 │ │ │ │ └── impl/ │ │ │ ├── mapper/ # MyBatis 接口 │ │ │ ├── entity/ # 数据库实体类 │ │ │ ├── vo/ # 前端展示对象 │ │ │ └── util/ # 工具类 │ │ ├── resources/ │ │ │ ├── mapper/ # MyBatis XML 映射文件 │ │ │ ├── application.yml # 或 spring.xml │ │ │ └── db.properties # 数据库连接配置 │ │ └── webapp/ │ │ ├── WEB-INF/ │ │ │ ├── web.xml # 传统 Web 项目入口 │ │ │ └── views/ # JSP 页面 │ │ └── static/ # CSS、JS、图片 │ └── test/ # 测试代码 ├── sql/ │ └── electricity_fee.sql # 建表与初始数据 └── pom.xmlcontroller包负责把 HTTP 请求参数转成 Java 对象service包写费用计算和状态流转mapper包是 MyBatis 接口对应的 SQL 写在resources/mapper下的 XML 里。entity和数据库表一一对应vo是给前端页面用的组合对象比如账单列表里要同时显示用户名和电表编号就会用一个BillVO来装。提示拿到源码先别急着改代码把sql目录下的脚本在 MySQL 里执行一遍确认表结构和初始数据都进去了后面排查问题时能少一半玄学。2.3 数据库表设计费用流转的数据底座电费管理系统的核心表通常有这几张表名作用关键字段user系统用户管理员/住户id, username, password, role, room_idroom房间或住户信息id, room_no, owner_name, phonemeter电表信息id, meter_no, room_id, install_datereading抄表记录id, meter_id, read_date, current_reading, last_readingfee_rate费率配置id, rate_name, price_per_kwh, effective_datebill账单id, room_id, period, usage_kwh, amount, statuspayment缴费记录id, bill_id, pay_date, pay_amount, operatorreading表里存的是本次抄表读数和上次读数差值就是用电量。bill表根据用电量和费率算出金额status字段标记“未缴/已缴/逾期”。payment表记录每一笔缴费和bill是一对多关系支持分次缴费的场景。这套表结构不算复杂但覆盖了从抄表到出账再到缴费的完整链路。二次开发时如果想加“阶梯电价”只需要在fee_rate和计算逻辑里动刀不用推翻整个设计。3. 核心模块拆解抄表、算费、出账的代码链路3.1 抄表录入从表单到数据库抄表是费用计算的起点。前端页面提交电表编号和本次读数后端要做的第一件事是查出上次读数算出用电量然后存一条reading记录。// ReadingController.java 抄表录入接口 PostMapping(/reading/add) public String addReading(RequestParam(meterNo) String meterNo, RequestParam(currentReading) BigDecimal currentReading, Model model) { // 1. 根据电表编号查最近一次抄表记录 Reading lastReading readingService.getLastReadingByMeterNo(meterNo); if (lastReading null) { model.addAttribute(msg, 该电表暂无历史抄表记录请先初始化); return reading/add; } // 2. 校验本次读数不能小于上次读数 if (currentReading.compareTo(lastReading.getCurrentReading()) 0) { model.addAttribute(msg, 本次读数不能小于上次读数); return reading/add; } // 3. 组装新记录并保存 Reading reading new Reading(); reading.setMeterNo(meterNo); reading.setLastReading(lastReading.getCurrentReading()); reading.setCurrentReading(currentReading); reading.setReadDate(new Date()); readingService.saveReading(reading); return redirect:/reading/list; }这段代码的逻辑很直白先查历史再校验最后落库。参数上currentReading用BigDecimal而不是double是因为电费计算涉及金额浮点数会有精度问题这是很多毕设项目容易翻车的地方。getLastReadingByMeterNo在 Service 层会调用 Mapper 的selectLastByMeterNoSQL 里用ORDER BY read_date DESC LIMIT 1取最近一条。如果项目是 Spring Boot 版本PostMapping和RequestParam的用法一样只是不需要在web.xml里配 DispatcherServlet启动类会自动扫描 Controller。3.2 费用计算费率匹配与金额生成抄表记录有了下一步是出账。出账的核心是根据用电量和当前生效的费率算出金额。// BillService.java 出账逻辑 public Bill generateBill(Long roomId, String period) { // 1. 查该房间在指定周期的抄表记录 Reading reading readingMapper.selectByRoomAndPeriod(roomId, period); if (reading null) { throw new BusinessException(该周期无抄表记录无法出账); } // 2. 计算用电量 本次读数 - 上次读数 BigDecimal usage reading.getCurrentReading() .subtract(reading.getLastReading()); // 3. 查当前生效的费率 FeeRate rate feeRateMapper.selectCurrentRate(); if (rate null) { throw new BusinessException(未配置费率请先在费率管理中设置); } // 4. 金额 用电量 × 单价保留两位小数 BigDecimal amount usage.multiply(rate.getPricePerKwh()) .setScale(2, RoundingMode.HALF_UP); // 5. 组装账单对象 Bill bill new Bill(); bill.setRoomId(roomId); bill.setPeriod(period); bill.setUsageKwh(usage); bill.setAmount(amount); bill.setStatus(UNPAID); // 初始状态未缴 billMapper.insert(bill); return bill; }这里有几个关键点。第一用电量用subtract而不是直接减保证BigDecimal的精度。第二setScale(2, RoundingMode.HALF_UP)是金额保留两位小数的标准做法四舍五入模式要显式指定否则默认的RoundingMode在某些场景下会抛异常。第三费率查询用selectCurrentRateSQL 里按effective_date倒序取第一条支持费率调整后新账单自动用新价格。period参数一般是2025-01这种格式对应抄表记录的月份。如果项目里没有period字段可能是用read_date的范围来筛选改造时要注意统一。3.3 缴费与状态流转账单从“未缴”到“已缴”账单生成后住户缴费系统要更新账单状态并记录缴费流水。// PaymentService.java 缴费处理 Transactional public void payBill(Long billId, BigDecimal payAmount, String operator) { // 1. 查账单校验状态 Bill bill billMapper.selectById(billId); if (bill null) { throw new BusinessException(账单不存在); } if (PAID.equals(bill.getStatus())) { throw new BusinessException(该账单已缴清请勿重复操作); } // 2. 校验缴费金额 if (payAmount.compareTo(bill.getAmount()) 0) { throw new BusinessException(缴费金额不足当前应缴 bill.getAmount()); } // 3. 写缴费记录 Payment payment new Payment(); payment.setBillId(billId); payment.setPayAmount(payAmount); payment.setPayDate(new Date()); payment.setOperator(operator); paymentMapper.insert(payment); // 4. 更新账单状态 bill.setStatus(PAID); billMapper.updateStatus(bill); }Transactional注解保证缴费记录插入和账单状态更新在同一个事务里要么都成功要么都回滚。这是缴费模块最不能省的地方否则会出现“钱交了但账单还是未缴”的脏数据。参数operator记录操作人方便后续对账。如果项目支持分次缴费payAmount可以小于bill.getAmount()状态改成PARTIAL这里按全额缴费的简单场景处理。3.4 欠费提醒与报表查询欠费提醒的逻辑是查bill表里status UNPAID且period超过当前月份的记录在首页或单独页面展示。报表查询则是按房间、按周期聚合用电量和金额SQL 里用GROUP BY实现。!-- BillMapper.xml 按房间统计用电量 -- select idsumUsageByRoom resultTypemap SELECT r.room_no AS roomNo, SUM(b.usage_kwh) AS totalUsage, SUM(b.amount) AS totalAmount FROM bill b JOIN room r ON b.room_id r.id WHERE b.period BETWEEN #{startPeriod} AND #{endPeriod} GROUP BY r.room_no ORDER BY totalUsage DESC /select这个查询返回一个ListMapString, Object前端用 JSTL 遍历渲染成表格。startPeriod和endPeriod是查询参数对应页面上的时间范围选择器。如果数据量大可以在period和room_id上建联合索引查询速度会明显提升。4. 本地跑起来环境、配置与启动步骤4.1 环境准备JDK、MySQL、Tomcat 一个不能少传统 SSM 项目需要 JDK 8 或 11、MySQL 5.7 或 8.0、Tomcat 8.5 或 9.0。Spring Boot 项目内置 Tomcat只需要 JDK 和 MySQL。我一般先确认 JDK 版本java -version # 输出 java version 1.8.0_xxx 或 11.0.xMySQL 安装后建一个库字符集用utf8mb4CREATE DATABASE electricity_fee DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;然后把sql/electricity_fee.sql导入mysql -u root -p electricity_fee sql/electricity_fee.sql导入完成后用SHOW TABLES;确认表都建好了再看一眼fee_rate表里有没有初始费率数据没有的话出账会直接报错。4.2 数据库连接配置改对这三处找到db.properties或application.yml改数据库连接信息# db.properties 传统 SSM 项目 jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/electricity_fee?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码如果是 Spring Boot 的application.ymlspring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/electricity_fee?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的密码serverTimezoneAsia/Shanghai不加的话MySQL 8.0 会报时区错误。useSSLfalse是本地开发关掉 SSL 警告生产环境要按实际情况配置。4.3 启动与访问看到登录页就算成功一半传统 SSM 项目在 IDEA 里配置 Tomcat把项目部署上去启动后访问http://localhost:8080/项目名/。Spring Boot 项目直接运行启动类的main方法控制台看到Started Application in x seconds就说明起来了。默认账号一般在sql脚本的user表里常见的是admin/123456或admin/admin。登录后先别急着点菜单按这个顺序走一遍费率管理 → 房间管理 → 电表管理 → 抄表录入 → 生成账单 → 缴费。这条链路走通说明核心业务没问题。注意如果登录后页面报 500先看控制台异常。最常见的是 MyBatis 映射文件没被扫描到检查mybatis.mapper-locations配置或SqlSessionFactoryBean的mapperLocations属性。5. 避坑与排查那些让我加班到凌晨的坑5.1 中文乱码从数据库到页面的全链路排查现象抄表记录里的备注、房间名显示成???或乱码。原因数据库字符集、JDBC URL、页面编码三者不一致。常见的是数据库建库时用了latin1或者 JDBC URL 里没加characterEncodingutf8。解决先确认数据库和表的字符集是utf8mb4再检查 JDBC URL 带上useUnicodetruecharacterEncodingutf8最后在 JSP 页面顶部加% page contentTypetext/html;charsetUTF-8 languagejava %。三处都对齐乱码基本消失。5.2 费率查不到出账时抛“未配置费率”现象点“生成账单”按钮页面提示“未配置费率”。原因fee_rate表是空的或者effective_date设置成了未来时间selectCurrentRate查不到生效记录。解决往fee_rate表插一条effective_date小于等于今天的记录比如INSERT INTO fee_rate (rate_name, price_per_kwh, effective_date) VALUES (居民用电, 0.55, 2025-01-01);。如果项目用的是逻辑删除还要确认deleted字段是 0。5.3 账单重复生成同一周期点了两次出账现象同一个房间同一个周期出现两条账单。原因出账接口没有做幂等校验每次点击都插一条新记录。解决在generateBill方法开头加一次查询如果该房间该周期已有账单直接返回已有账单或抛业务异常。SQL 层面可以在bill表的(room_id, period)上建唯一索引数据库兜底。5.4 缴费后状态没变事务没生效现象缴费记录插入了但账单状态还是“未缴”。原因Transactional注解没生效常见于 Service 类没有被 Spring 代理或者异常被 catch 后没重新抛出。解决确认Transactional加在 public 方法上且类被 Spring 管理。如果方法里用了 try-catch确保异常能抛出去触发回滚。Spring Boot 项目还要确认启动类上有EnableTransactionManagement虽然自动配置通常已经开了。5.5 页面 404Controller 没扫描到现象访问某个功能页面报 404控制台没有异常。原因Controller 类不在 Spring 扫描的包路径下或者Controller写成了Component。解决检查spring.xml或启动类上的ComponentScan范围确保 Controller 包被包含。传统 SSM 项目还要确认web.xml里 DispatcherServlet 的contextConfigLocation指向了正确的配置文件。6. 二次开发从能跑到好用我一般改这三处6.1 加阶梯电价改计算逻辑和费率表阶梯电价是电费系统最常见的改造需求。我的做法是在fee_rate表加tier1_limit、tier1_price、tier2_limit、tier2_price等字段然后在generateBill里分段计算。// 阶梯电价计算示例 BigDecimal usage reading.getCurrentReading().subtract(reading.getLastReading()); BigDecimal amount BigDecimal.ZERO; BigDecimal tier1Limit rate.getTier1Limit(); // 第一档上限如 200 度 if (usage.compareTo(tier1Limit) 0) { amount usage.multiply(rate.getTier1Price()); } else { // 第一档部分 amount tier1Limit.multiply(rate.getTier1Price()); // 超出部分按第二档算 BigDecimal remaining usage.subtract(tier1Limit); amount amount.add(remaining.multiply(rate.getTier2Price())); } amount amount.setScale(2, RoundingMode.HALF_UP);改造时注意tier1Limit和tier2Price这些字段要在FeeRate实体和 Mapper XML 里同步加上否则查出来是 null。验证方法是造一条用电量刚好跨档的抄表记录看金额是不是按分段算出来的。6.2 加导出功能用 POI 把账单导成 Excel报表页面加一个“导出”按钮用 Apache POI 实现。先在pom.xml加依赖dependency groupIdorg.apache.poi/groupId artifactIdpoi-ooxml/artifactId version5.2.3/version /dependency然后在 Controller 里写导出接口GetMapping(/bill/export) public void exportBill(HttpServletResponse response) throws IOException { ListBillVO list billService.listAllBills(); XSSFWorkbook workbook new XSSFWorkbook(); XSSFSheet sheet workbook.createSheet(账单列表); // 表头 XSSFRow header sheet.createRow(0); header.createCell(0).setCellValue(房间号); header.createCell(1).setCellValue(周期); header.createCell(2).setCellValue(用电量); header.createCell(3).setCellValue(金额); header.createCell(4).setCellValue(状态); // 数据行 int rowNum 1; for (BillVO vo : list) { XSSFRow row sheet.createRow(rowNum); row.createCell(0).setCellValue(vo.getRoomNo()); row.createCell(1).setCellValue(vo.getPeriod()); row.createCell(2).setCellValue(vo.getUsageKwh().doubleValue()); row.createCell(3).setCellValue(vo.getAmount().doubleValue()); row.createCell(4).setCellValue(vo.getStatus()); } response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment;filenamebills.xlsx); workbook.write(response.getOutputStream()); workbook.close(); }XSSFWorkbook对应.xlsx格式HSSFWorkbook对应.xls。数据量大时用SXSSFWorkbook避免内存溢出。导出文件名用英文中文文件名在某些浏览器上会乱码。6.3 加权限控制从“登录就行”到“按角色分菜单”原项目可能只有登录校验没有细粒度权限。我一般用 Spring Security 或简单的拦截器实现。轻量做法是自定义拦截器public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); User user (User) session.getAttribute(loginUser); if (user null) { response.sendRedirect(request.getContextPath() /login); return false; } // 管理员才能访问用户管理和费率管理 String uri request.getRequestURI(); if ((uri.contains(/user/) || uri.contains(/rate/)) !ADMIN.equals(user.getRole())) { response.sendRedirect(request.getContextPath() /403); return false; } return true; } }然后在springmvc.xml里注册拦截器指定拦截路径和排除路径。验证方法是分别用管理员和普通住户账号登录看菜单和接口访问是否符合预期。6.4 一个我踩过的坑改完费率后旧账单被重算有次我改费率表顺手把generateBill里的费率查询逻辑改成了“实时查最新费率”结果重新生成历史账单时旧账单金额全变了。后来我强制自己账单一旦生成金额就冻结费率调整只影响新账单。具体做法是在bill表加rate_snapshot字段出账时把当时的单价存进去后续查询和展示都用这个快照值。从那以后我每次改费率相关逻辑都强制走一遍“改费率 → 生成新账单 → 查历史账单”的验证流程确认旧数据没被波及。希望帮到你。本文还有配套的精品资源点击获取