简介：乡镇自来水收费系统源码是一套适合Java毕业设计、课程设计及SSM框架实战练习的完整项目。系统基于Spring+SpringMVC+MyBatis与JSP构建，使用MySQL 5.7实现数据持久化，业务覆盖管理员端的水表管理、抄表缴费、更换水表审批、公告与留言处理，以及用户端的在线缴费、换表申请、公告查看和个人信息维护，角色权限划分清晰，业务闭环完整。资源包共1942个文件，以Java源文件、JSP页面、XML配置、JavaScript/CSS前端资源、依赖Jar包和SQL数据库脚本为主体，整体约42.56MB；压缩包内目录结构完整，另附说明文档，便于按模块阅读和二次开发。运行环境要求JDK1.8、Tomcat7、Maven3.3，可使用Eclipse或IDEA直接导入，数据库脚本可通过Navicat11快速初始化。目前已有60人浏览学习，对于需要参考完整管理业务和SSM整合流程的毕业设计者，具有很强的借鉴意义。

1. 乡镇自来水收费系统：一套能直接复现的SSM毕业设计源码

乡镇自来水收费系统不是什么新概念，但真正能跑通前后端、能拿去答辩或实训的成品源码，比想象中少。这份基于SSM（Spring+SpringMVC+MyBatis）+JSP+MySQL5.7的毕业设计项目，覆盖了水表档案管理、抄表计费、换表审核、缴费、公告留言五大块业务，核心Controller类（YonghuxinxiController、ShuifeixinxiController、UserController等）和数据库脚本都在包里。适合正在做Java课程设计、毕业设计的人直接拿来复现改功能，也适合想搞懂SSM传统三层结构怎么组织代码的初学者。我拆完这套项目的第一感受是：它不是花架子，业务逻辑是闭环的，抄表、计费、缴费、换表审核这条链路从头到尾能走通，拿来改一改就能当自己的东西。

2. SSM分层与运行链路：从Eclipse导入到浏览器出数据

2.1 代码包结构：Controller、Service、Mapper的责任划分

这套乡镇自来水收费系统的代码按SSM标准三层组织：Controller层负责接收请求和返回视图，Service层处理业务逻辑，Mapper层（DAO）直接操作MySQL数据库。从项目正文里的class文件能看出来，YonghuxinxiController处理用户信息相关请求，ShuifeixinxiController管水费业务，UserController做登录注册，CommonController承载通用方法。

// ShuifeixinxiController 的典型方法签名 @Controller @RequestMapping("/shuifeixinxi") public class ShuifeixinxiController { @Resource private ShuifeixinxiService shuifeixinxiService; @RequestMapping("/save") public R save(@RequestBody ShuifeixinxiEntity shuifeixinxi, HttpServletRequest request) { // 默认状态 0：未缴费 shuifeixinxi.setStatus(0); shuifeixinxiService.insert(shuifeixinxi); return R.ok(); } }

这段代码的核心在setStatus(0)，它把新生成的水费记录默认置为“未缴费”状态。后面所有缴费、滞纳金判断都是围绕这个状态位做的。@Resource注入Service，@RequestBody接收前端传来的JSON，R.ok()是统一返回体，前端拿到这个对象判断成功与否。

2.2 Eclipse导入与Tomcat7发布流程

项目环境是JDK1.8 + Maven3.3 + Eclipse/IDEA + Tomcat7 + MySQL5.7，这套组合是2018年前后SSM毕业设计最常见的配置。导入时注意别直接用Open导入，要用Import > Existing Maven Projects，否则依赖不会自动下载。

导入后先执行maven clean再maven update，等依赖下载完看Project Facets里Dynamic Web Module是不是3.0。Tomcat7对应Servlet3.0，要是默认变成4.0，启动时会报NoClassDefFoundError。

2.3 数据库初始化与配置文件对应关系

数据库文件需要手动导入MySQL。用Navicat新建一个库，名字按项目里jdbc.properties配置来，然后运行项目的.sql文件。导入后能看到用户表、水表信息表、水费信息表、换表申请表、公告表、留言表，表与表之间靠用户ID和水表ID关联。

# jdbc.properties 数据库连接配置 jdbc.driverClass=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/water?useUnicode=true&characterEncoding=utf8&useSSL=false jdbc.username=root jdbc.password=123456

useSSL=false必须显式写，MySQL5.7在连接时会警告SSL握手失败，虽然不报错，但日志非常难看。characterEncoding=utf8解决中文乱码，JSP页面编码和数据库编码必须统一。密码改成你自己的数据库密码，这个文件是全局的，改错一处整个项目连不上库。

3. 水费计费实现：抄表、阶梯定价与缴费状态流转

3.1 水表表底数字段设计与抄表接口逻辑

水费计算的前提是把每次抄表读数存下来。表里最关键的两个字段是last_num（上次抄表数）和current_num（本次抄表数），用水量就是两个数相减。这套系统把抄表动作放在管理员端，管理员录入本期读数，系统自动算钱。

// 抄表计费核心逻辑 public R chaoBiao(@RequestBody HashMap<String, Object> params) { Integer shuifeiId = Integer.parseInt(params.get("shuifeiId").toString()); Double currentNum = Double.parseDouble(params.get("currentNum").toString()); ShuifeixinxiEntity shuifeixinxi = shuifeixinxiService.selectById(shuifeiId); double yongshuiliang = currentNum - shuifeixinxi.getLastNum(); double money = calcMoney(yongshuiliang); shuifeixinxi.setCurrentNum(currentNum); shuifeixinxi.setMoney(money); shuifeixinxi.setStatus(0); // 待缴费 shuifeixinxiService.updateById(shuifeixinxi); return R.ok(); }

calcMoney是计费核心，按用水量套阶梯价格。这里要留意：如果currentNum比lastNum小，说明是换过表或读表器异常，直接算出负数费用，我在实际的系统里会加一个if (yongshuiliang < 0)的异常判断，避免脏数据进入缴费单。

3.2 阶梯水价的计算实现

阶梯水价是乡镇水费系统的刚需，居民用水、商业用水价格不同，超出基础额度后单价上涨。这套系统用简单的if-else实现三档阶梯，逻辑直观，适合毕业设计答辩时现场讲清楚。

// 阶梯水价计算 private double calcMoney(double yongshuiliang) { double price1 = 2.8; // 第一档单价 double price2 = 4.2; // 第二档单价 double price3 = 6.0; // 第三档单价 int limit1 = 15; // 第一档上限 int limit2 = 30; // 第二档上限 if (yongshuiliang <= limit1) { return yongshuiliang * price1; } else if (yongshuiliang <= limit2) { return limit1 * price1 + (yongshuiliang - limit1) * price2; } else { return limit1 * price1 + (limit2 - limit1) * price2 + (yongshuiliang - limit2) * price3; } }

参数全部硬编码在方法里，想调价格直接改数字。这是毕业设计能接受的做法——讲清楚逻辑比搞个数据库配置表更得分。如果你要扩展成正式系统，建议把price和limit提到数据库字典表，用配置驱动，但这套项目里不需要。

3.3 缴费状态如何流转

费用状态是这套系统另一个关键设计：status字段从0到1再回到0的闭环。生成水费单时status=0（未缴），用户缴费后status=1（已缴），到下个周期抄表生成新账单时又重置为0。

-- 水费信息表核心字段 CREATE TABLE shuifeixinxi ( id INT PRIMARY KEY AUTO_INCREMENT, yonghu_id INT COMMENT '用户ID', shuibiao_id INT COMMENT '水表ID', last_num DOUBLE COMMENT '上次抄表数', current_num DOUBLE COMMENT '本次抄表数', money DOUBLE COMMENT '应缴金额', status INT DEFAULT 0 COMMENT '0未缴 1已缴', create_time DATETIME COMMENT '生成时间' );

status字段用整数不用枚举，在MyBatis里映射最简单。JSP页面的缴费按钮根据这个值渲染，c:if test="${status==0}"显示缴费按钮，否则显示“已缴”。这套设计把业务状态和页面展示解耦了，你改状态分支不会影响SQL查询。

4. 换表审核与权限控制：管理员与用户两条操作链路

4.1 管理员端：水表审核、公告、留言管理

系统管理员登录后进入后台，核心操作是审核用户的换表请求。用户提交换表申请后，管理员在huanbiaoController看到待审核列表，确认后分配新表号，旧表归档。这套流程里有个小细节：换表后last_num要重置为0，否则新表读数直接减旧表读数，会算出天文数字水费。

// 换表审核通过逻辑 public R shenHe(Integer id, HttpServletRequest request) { HuanbiaoEntity huanbiao = huanbiaoService.selectById(id); huanbiao.setStatus(1); // 审核通过 // 重置新表底数 ShuibiaoEntity shuibiao = shuibiaoService.selectById(huanbiao.getShuibiaoId()); shuibiao.setLastNum(0.0); shuibiaoService.updateById(shuibiao); huanbiaoService.updateById(huanbiao); return R.ok(); }

审核通过后水表底数重置，这一步在项目里是安全底线。不重置的话，下个月抄表计算用水量时会把旧表读数也算进去，账单直接爆炸。公告和留言管理就是常规的增删改查，公告表带create_time排序，留言表带reply_content回复字段。

4.2 用户端：换表申请、缴费入口、个人信息修改

用户端功能围绕自助服务设计：登录后看到自己的水费账单列表，每一条显示用水量、金额、状态，有缴费按钮；用户还能发起换表申请，填原因提交给管理员；个人信息页可以改电话和地址。这套系统的用户角色靠user表的role字段区分，管理员和普通用户共用一张表。

// 用户登录权限判断 public R login(YonghuEntity yonghu, HttpSession session) { YonghuEntity user = yonghuService.login(yonghu.getUsername(), yonghu.getPassword()); if (user != null) { session.setAttribute("userId", user.getId()); session.setAttribute("role", user.getRole()); return R.ok().put("role", user.getRole()); } return R.error("用户名或密码错误"); }

登录成功后把role存进Session，JSP页面用<c:if test="${sessionScope.role == 'admin'}">控制菜单显示。这就是最朴素的角色控制方式，没有Spring Security，但胜在代码好懂、答辩能讲明白。

4.3 JSP页面与Controller的传参映射

这套项目的前端是JSP+JSTL+EL表达式，页面放在WebContent/WEB-INF/jsp下。列表页用<c:forEach>遍历，表单页用${param.id}回填数据，提交走form action="xxx/save"。这里有个高频坑：请求路径上的shuifeixinxi是类上的@RequestMapping值，跟页面目录名不一致会导致404。

<!-- 水费列表页面片段 --> <c:forEach items="${pageInfo.list}" var="item"> <tr> <td>${item.lastNum}</td> <td>${item.currentNum}</td> <td>${item.money}</td> <td> <c:if test="${item.status == 0}"> <a href="pay?id=${item.id}" class="btn btn-primary">去缴费</a> </c:if> <c:if test="${item.status == 1}"> <span class="label label-success">已缴</span> </c:if> </td> </tr> </c:forEach>

页面通过EL表达式直接拿后端返回的对象属性。pageInfo.list是MyBatis分页插件PageHelper封装的数据，依赖里要引入pagehelper，版本必须跟MyBatis版本匹配，否则分页SQL不会自动拼加limit。

5. 二次部署前排错：SSM+MySQL5.7的六个高频坑

5.1 Maven依赖下载失败：私服路径与版本冲突

现象：Eclipse导入项目后大量红叉，Maven一直报Cannot resolve artifact xxx。

原因：国内访问Maven中央仓库不稳定，且项目用Maven3.3，跟上当前Eclipse版本自带的Maven插件（3.6+）行为不一致。

解决：检查pom.xml里Spring版本（常见是4.3.x）、MyBatis版本（3.4.x）、PageHelper版本（5.1.x），三者的兼容性一定要确认。然后打开settings.xml，加阿里云镜像：

<mirror> <id>aliyun</id> <mirrorOf>central</mirrorOf> <url>https://maven.aliyun.com/repository/public</url> </mirror>

改完执行maven clean重新下载。血泪经验：项目自带的Maven仓库目录和IDE里配置的本地仓库不一致时，依赖永远不会出现在你眼前。

5.2 Tomcat7启动后访问空白页：Servlet版本不一致

现象：部署成功但访问http://localhost:8080/项目名/显示404或500，控制台报java.lang.NoClassDefFoundError: javax/servlet/ServletException。

原因：Tomcat7是Servlet3.0规范，项目web.xml里web-app版本声明过高，或者pom.xml里引了Servlet4.0的依赖。

解决：打开web.xml，把web-app的version改为3.0，同时检查pom.xml的javax.servlet-api版本是3.0.1。改完重新发布，项目能正常进入登录页。

5.3 数据库连接报错：MySQL5.7的密码认证方式

现象：启动Tomcat后日志报Access denied for user 'root'@'localhost'，但Navicat用同样的账号密码能连上。

原因：项目里jdbc.properties的密码跟你MySQL实际密码不一致，或者MySQL的root账号指定了特定host。

解决：先确认jdbc.properties里的url主机名是localhost（有的项目写成虚拟机IP），再改密码。我用Navicat打开MySQL用户管理，把root的host设为localhost和127.0.0.1，然后重新连接。

5.4 中文乱码：JSP页面和数据库编码不统一

现象：页面上显示的水费用户姓名全是“???”，或者存入数据库后查询乱码。

原因：JSP文件本身是GBK编码，而数据库表和连接配置是utf8，两边不一致。

解决：把Eclipse的工作空间编码统一改为UTF-8（Window > Preferences > General > Workspace），重新导入项目，让所有.jsp文件都以UTF-8保存。数据库端用Navicat把表和字段的字符集改成utf8mb4，然后重新跑SQL脚本。项目里的characterEncoding=utf8参数要保持。

5.5 图片上传后页面不显示：静态资源路径问题

现象：管理员上传用户头像后，<img>标签显示裂图，浏览器F12看到请求地址404。

原因：SpringMVC默认拦截所有路径，静态图片请求被DispatcherServlet抢走了。

解决：SpringMVC配置文件里加静态资源放行：

<mvc:resources mapping="/uploads/**" location="/uploads/"/> <mvc:default-servlet-handler/>

然后把上传目录uploads放到WebContent根路径下，保证Tomcat能直接访问。这个问题一旦出现就是整片图片挂掉，不是单个路径拼错。

5.6 分页功能失效：PageHelper版本与MyBatis不匹配

现象：列表页点第2页，数据还是第1页的，或者SQL日志里完全没有limit关键字。

原因：PageHelper5.x对MyBatis3.4以下版本不兼容，分页拦截器没有正确注册。

解决：pom.xml统一使用PageHelper5.1.x，MyBatis用3.4.6，然后在MyBatis配置里加插件类com.github.pagehelper.PageInterceptor。确认方式是看控制台SQL输出，如果看到select count(0)和limit就说明生效了。这算是我在这套源码上踩得最深的一个坑，之前因为分页失效差点怀疑人生。

6. 源码迁移到IDEA：两处改动与一次验证

6.1 从Eclipse搬到IDEA的配置修改点

如果你准备用IDEA跑这套乡镇自来水收费系统，别直接Open项目后急着点运行，先改两处。第一处是web.xml里的welcome-file确认没问题，第二处是IDEA的Artifact配置，要选Web Application: Exploded，然后右下角Fix按钮把依赖加入WEB-INF/lib。IDEA社区版不带JavaEE插件，跑Web项目最好用IDEA Ultimate，不然部署入口找不到。

实际迁移时我还遇到过一个问题：Eclipse项目没有.idea目录，IDEA导入后Tomcat配置里的Application context是/，需要手动改成项目名，比如/water，否则访问路径全404。

6.2 一条命令验证项目可运行

项目能不能跑起来，只看启动日志是不够的。我会用一条命令做冒烟验证：

curl -i -X POST http://localhost:8080/water/yonghu/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"123456"}'

返回HTTP/1.1 200且Body里有role字段，说明Controller、Service、Mapper、数据库四条链路全通。如果返回500，先看Tomcat日志的Caused by，90%是数据库连接或MyBatis映射问题。

验证通过后再人工走一遍业务闭环：管理员创建水费单，用户缴费，用户申请换表，管理员审核通过，水表底数重置。这条流程走完，项目才算真正复现成功，而不是白屏一堆报错硬着头皮提交。

从那以后我每次拿到SSM毕业设计源码，第一件事就是先跑通登录再推进业务，普通用户登录、管理员登录各测一次，CURD功能逐个点，换表审核流程强制走完整一遍，避免答辩现场翻车。这个习惯帮我排查过不少隐藏的路径问题和数据库状态位错误，希望帮到你。

本文还有配套的精品资源，点击获取