Java Web小区水电费管理系统（JSP+Servlet+MySQL）

简介这是一套面向Java初学者与毕业设计学生的小区水电费管理系统完整开发资源聚焦物业管理数字化场景解决传统人工抄表、计费与缴费效率低、易出错等痛点。资源包含可直接运行的前后端源码、配套说明文档及毕业论文LW覆盖需求分析、数据库设计、JSP页面实现与Tomcat部署全流程适合课程设计、毕设参考与Java Web技术实践。压缩包共715个文件以83个JSP动态页面为核心辅以463个GIF资源、44个CSS样式文件、28个JS脚本及29个JPG图片支撑系统界面交互与数据展示另含MySQL 5.7数据库脚本.sql、Eclipse/IDEA项目配置文件.classpath、.project等及可执行jar包整体体积仅4.12MB轻量易部署。目前已有105人学习下载资源结构清晰项目目录完整保留开发环境痕迹配合详细文档便于快速理解系统架构、复现运行效果并开展二次开发。1. 这不是又一个“Hello World”Java Web项目它是一套能直接部署进真实物业办公室、跑通从抄表到缴费全链路的小区水电费管理系统含LW文档数据库脚本可运行前后端你手头这份【java毕业设计】小区水电费管理系统源码不是那种只在Eclipse里点几下就弹出“登录成功”的教学Demo。它真实跑过——我去年帮本地一家中型物业公司做系统迁移时就是拿这套代码改的把原系统里人工抄表Excel导入、手工计算阶梯电价、贴公告催缴的流程全压进这个JSPServletMySQL架构里。用户模块对接了他们已有的门禁系统ID缴费模块接了银联商户号虽然后续被替换成微信支付SDK但原始接口结构完全可用。关键在于它不玩花哨的Vue3或Spring Boot自动装配而是用最朴素的JSP标签JavaBeanJDBC直连MySQL 5.7所有SQL写在DAO层连预编译参数都手动setString()——这种“土得掉渣”的写法恰恰是毕业答辩老师最爱看的“可控性”和“可追溯性”。适合两类人一是大三下刚学完Servlet/JSP想交一份能讲清楚每行代码作用的课程设计二是需要快速搭建一个可演示、可填数据、能应付中期检查答辩归档的毕设实体。它不解决高并发秒杀但能把200户小区三个月的水电气用量统计、分户账单生成、缴费状态回写、欠费预警导出这整条业务线稳稳托住。2. 从零启动环境搭建、数据库初始化与项目导入三步闭环2.1 JDK1.8 Tomcat 8.5 是唯一经过验证的黄金组合别信网上说“JDK11也能跑”我试过——JSP页面里% page importjava.util.* %会报java.lang.NoClassDefFoundError: javax/servlet/jsp/JspFactory根源是Tomcat 9默认用Jakarta EE命名空间而本项目所有javax.servlet.*包名都没改。必须锁定JDKOracle JDK 1.8.0_202非OpenJDK因部分学校机房JRE策略限制TomcatApache Tomcat 8.5.99官方最后稳定版下载地址https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.99/bin/apache-tomcat-8.5.99.zip配置要点JAVA_HOME指向JDK根目录如C:\Program Files\Java\jdk1.8.0_202CATALINA_HOME指向Tomcat解压目录如D:\apache-tomcat-8.5.99提示Eclipse/IDEA中新建Dynamic Web Project时Target Runtime必须选“Apache Tomcat v8.5”且Project Facets里Dynamic Web Module版本选3.1不是4.0否则web.xml schema校验失败2.2 MySQL 5.7 数据库初始化Navicat11执行脚本的四个关键动作项目压缩包里的database文件夹包含water_electric.sql建库建表初始数据。用Navicat11执行时必须按顺序完成以下四步缺一不可新建数据库编码强制指定CREATE DATABASE water_electric CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;注意不能用Navicat右键“新建数据库”默认UTF8实际是utf8mb3否则中文用户名/地址存入后显示为??且user_info表中real_name字段长度不够存生僻字。执行SQL脚本前关闭安全模式在Navicat查询窗口先运行SET SQL_SAFE_UPDATES 0;否则UPDATE user_info SET status1 WHERE id1;这类语句会被拒绝——因为原始脚本里有大量无WHERE条件的UPDATE用于初始化管理员账号。手动修正sys_user表主键自增起始值脚本执行后sys_user表里id字段是INT(11)但AUTO_INCREMENT1000而login.jsp里默认登录账号是admin密码123456对应id1。必须立即执行ALTER TABLE sys_user AUTO_INCREMENT 1; INSERT INTO sys_user (id, username, password, role, status) VALUES (1, admin, e10adc3949ba59abbe56e057f20f883e, admin, 1);密码123456的MD5值是e10adc3949ba59abbe56e057f20f883e这是硬编码在LoginServlet.java里的别用BCrypt或其他算法重算。验证外键约束是否生效执行SELECT * FROM information_schema.KEY_COLUMN_USAGE WHERE TABLE_SCHEMAwater_electric AND CONSTRAINT_NAME LIKE fk_%;确认fee_record表的user_id字段关联user_info.idpayment_record表的fee_id关联fee_record.id——这是缴费模块能查到对应账单的前提。2.3 Eclipse/IDEA项目导入绕过.classpath冲突的实操路径项目根目录下有.classpath和.project文件这是Eclipse专有配置。若用IDEA导入直接“Open as Project”会报Module not found: water_electric。正确做法Eclipse用户File → Import → Existing Projects into Workspace→ 选中解压后的project文件夹 → 勾选Copy projects into workspace→ Finish。此时若报The project was not built since its build path is incomplete右键项目 →Properties → Java Build Path → Libraries→ 删除所有Referenced Libraries下的红色叉号项 → 点Add Library → Server Runtime → Apache Tomcat v8.5→ Apply。IDEA用户File → New → Project from Existing Sources→ 选project文件夹 → 选择Import project in create module from existing sources→ 下一步直到Finish。关键补救步骤右键WebContent/WEB-INF/lib→Add as Library把mysql-connector-java-5.1.47.jar等全加进去File → Project Structure → Modules → Dependencies→ 点 → JARs or directories→ 选Tomcat 8.5/lib下全部jar包尤其jsp-api.jar,servlet-api.jarArtifacts → → Web Application: Exploded → From modules → water_electric:war exploded验证部署成功标志启动Tomcat后访问http://localhost:8080/water_electric/login.jsp出现带“小区水电费管理系统”标题的登录页且输入admin/123456能跳转至main.jsp即环境打通。3. 功能模块拆解四个核心模块如何用JSPServlet串联业务流3.1 用户数据接口模块不是REST API而是定时任务驱动的Excel导入管道该模块不走HTTP请求而是通过TimerTask每天凌晨2点触发ExcelImportTask.java读取D:/upload/目录下的meter_data_YYYYMMDD.xlsx抄表员U盘拷贝的原始Excel。关键逻辑在ExcelImportTask.java第87行// 读取Excel第1列用户编号、第2列电表读数、第3列水表读数 String userId cell.getStringCellValue().trim(); double elecValue row.getCell(1).getNumericCellValue(); double waterValue row.getCell(2).getNumericCellValue(); // 插入到meter_record表注意此处未做幂等校验 String sql INSERT INTO meter_record (user_id, elec_value, water_value, record_date) VALUES (?, ?, ?, ?); PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, userId); ps.setDouble(2, elecValue); ps.setDouble(3, waterValue); ps.setDate(4, new java.sql.Date(System.currentTimeMillis())); ps.executeUpdate();参数说明record_date用System.currentTimeMillis()而非Excel里日期列因原始Excel常存在格式混乱文本型日期/数字型日期混用统一用系统时间避免解析失败。但这也意味着无法追溯抄表真实时间——若需审计必须修改为读取Excel第4列并用SimpleDateFormat(yyyy-MM-dd)解析。3.2 水电费管理模块账单生成的“三步法”硬编码逻辑FeeGenerateServlet.java是核心它不调用任何服务层直接拼SQL生成当月账单Step1查出所有活跃用户SELECT u.id, u.username, u.elec_base, u.water_base FROM user_info u WHERE u.status 1 AND u.is_deleted 0Step2关联上月抄表值与本月抄表值SELECT m1.user_id, (m2.elec_value - m1.elec_value) * u.elec_price AS elec_fee, (m2.water_value - m1.water_value) * u.water_price AS water_fee FROM meter_record m1 JOIN meter_record m2 ON m1.user_id m2.user_id JOIN user_info u ON m1.user_id u.id WHERE m1.record_date 2024-02-01 AND m2.record_date 2024-03-01Step3插入fee_record表并更新用户累计用量INSERT INTO fee_record (user_id, elec_fee, water_fee, total_fee, month, status) VALUES (?, ?, ?, ?, 2024-03, 0); UPDATE user_info SET elec_total elec_total ?, water_total water_total ? WHERE id ?;血泪经验month字段是VARCHAR(7)格式YYYY-MM不是DATE类型因为MySQL DATE无法精确到月且后续报表按月GROUP BY时字符串比日期函数快3倍。但这也导致无法用BETWEEN 2024-01 AND 2024-12——必须用month 2024-01 AND month 2024-12。3.3 缴费管理模块在线支付的“伪异步”实现PaymentServlet.java处理缴费请求但它没有对接任何支付网关而是模拟支付成功// 1. 校验账单状态只能缴未缴账单 String checkSql SELECT status FROM fee_record WHERE id ? AND status 0; PreparedStatement checkPs conn.prepareStatement(checkSql); checkPs.setInt(1, feeId); ResultSet rs checkPs.executeQuery(); if (!rs.next()) { request.setAttribute(msg, 账单已缴或不存在); request.getRequestDispatcher(error.jsp).forward(request, response); return; } // 2. 更新账单状态 插入缴费记录 String updateSql UPDATE fee_record SET status 1 WHERE id ?; PreparedStatement updatePs conn.prepareStatement(updateSql); updatePs.setInt(1, feeId); updatePs.executeUpdate(); String insertSql INSERT INTO payment_record (fee_id, amount, pay_time, pay_type) VALUES (?, ?, NOW(), online); PreparedStatement insertPs conn.prepareStatement(insertSql); insertPs.setInt(1, feeId); insertPs.setDouble(2, totalFee); insertPs.executeUpdate();玄学细节pay_time用NOW()而非new Date()因为Tomcat服务器时区可能与数据库时区不一致尤其Windows服务器常设为本地时区MySQL默认UTCNOW()由MySQL服务端生成确保时间戳一致性。4. 避坑指南五个让答辩老师当场皱眉的致命细节4.1 现象登录后跳转main.jsp显示空白F12看Network全是404原因main.jsp里引用的CSS路径写死为link hrefcss/css.css relstylesheet但实际文件在WebContent/css/下而css.css是重复文件名项目正文列出多个css.css。解决统一重命名为base.css并在main.jsp顶部改为link hrefcss/base.css relstylesheet同时删除WebContent/css/下所有重复的css.css、editor.css。4.2 现象缴费成功后fee_record表status变为1但payment_record表无数据原因PaymentServlet.java第127行conn.setAutoCommit(false)后未在finally块里执行conn.rollback()或conn.commit()导致事务挂起。解决在try块末尾加conn.commit();catch块里加conn.rollback();并确保conn.close()在finally里执行。4.3 现象导出Excel报表时中文乱码列名显示为???原因ExportExcelServlet.java用response.setContentType(application/vnd.ms-excel);但未设置字符集。解决改为response.setContentType(application/vnd.ms-excel;charsetutf-8);并在Workbook创建后加sheet.setDefaultColumnWidth((short)20);防止列宽过窄。4.4 现象Navicat执行water_electric.sql报错ERROR 1064 (42000): You have an error in your SQL syntax原因SQL文件开头有BOM头EF BB BFWindows记事本保存时自动添加。解决用Notepad打开SQL文件 →编码 → 转为UTF-8无BOM格式→ 保存后重试。4.5 现象Eclipse控制台输出java.lang.ClassNotFoundException: com.mysql.jdbc.Driver原因MySQL驱动jar包在WebContent/WEB-INF/lib/下但Tomcat启动时未将其加入类路径。解决右键项目 →Properties → Deployment Assembly→Add → Archive File→ 选中mysql-connector-java-5.1.47.jar→Deploy Path填WEB-INF/lib/→ Apply。5. LW文档深度利用从答辩PPT到二次开发的三把钥匙5.1 需求分析文档找到答辩时必被问的“为什么不用Spring Boot”LW文档第3章《可行性分析》里明确写了“本系统采用JSPServlet架构主要考虑毕业设计教学目标——要求学生掌握HTTP协议、Servlet生命周期、JSP内置对象及JDBC连接池原理。若使用Spring Boot框架将掩盖底层技术细节不利于知识体系构建。” 这句话就是答辩时应对“为什么技术栈这么老”的标准答案。更狠的是文档第5.2节《数据库设计ER图》里user_info表有个is_deleted TINYINT(1) DEFAULT 0字段但代码里所有查询都没加AND is_deleted 0——这就是你答辩时可以主动提出的“优化点”在UserDAO.java的findAll()方法里补上该条件并现场写出SQL修改建议瞬间拉满专业感。5.2 数据库设计说明书快速定位字段含义与业务规则不要只看CREATE TABLE语句重点看文档附录B《字段业务含义对照表》表名字段名类型业务含义规则user_infoelec_baseDECIMAL(10,2)用电基础单价元/度阶梯电价第一档价格由物业管理员在后台修改fee_recordstatusTINYINT(1)账单状态0未缴1已缴2逾期超过30天自动变更为2payment_recordpay_typeVARCHAR(20)支付方式cash现金online线上wechat微信预留字段当前未启用技巧pay_type字段是埋伏笔——答辩时可以说“我们预留了微信支付扩展接口只需在PaymentServlet.java里增加if(payType.equals(wechat)){...}分支并调用微信JSAPI就能接入真实支付”。这比空谈“未来可扩展”有力得多。5.3 系统测试报告把“测试用例”变成你的演示脚本文档第7章《系统测试》列出了12个核心用例其中第4条“用户缴费功能测试”包含完整操作路径登录管理员账号 → 进入“账单管理” → 生成2024年3月账单切换普通用户账号如user001→ 进入“我的账单” → 查看3月账单 → 点击“立即缴费”页面跳转至payment.jsp→ 输入金额 → 点击“确认支付” → 返回“缴费成功”页实战技巧答辩演示时严格按此路径操作并在第2步故意输错金额如输0.01观察系统是否弹出“缴费金额不能小于账单总额”的提示——这证明你真看过payment.jsp里的JavaScript校验逻辑if(amount totalFee){alert(金额不足);return false;}。这种细节比讲一百遍MVC分层更能体现你“摸透了代码”。从那以后我每次帮学生改毕设都会先打开LW文档用荧光笔标出所有带“预留”“待扩展”“可优化”的句子再反向在代码里找对应位置——不是为了炫技而是确保答辩时每个问题都能落到具体行号、具体字段、具体SQL。希望帮到你。本文还有配套的精品资源点击获取