SSM乡镇自来水收费系统毕设源码全解析：从部署到答辩加分

简介：一套基于SSM框架与JSP技术实现的乡镇自来水收费系统源码，面向Java毕业设计及课程设计场景，完整覆盖管理员端与用户端核心业务。管理员可管理水表信息、审核换表申请、录入抄表数据并处理水费缴费，发布公告、管理留言与用户资料；用户端支持换表申请、在线缴费、公告查看、留言发布及个人信息维护，业务闭环清晰，便于答辩演示与二次开发。压缩包共1942个文件，约42.56MB，主要包含java源码、jsp页面、css/js前端资源、xml配置文件、sql数据库脚本及说明文档，另有大量png/jpg/gif图片用于界面图标与展示，jar包支撑SSM框架和Mysql运行环境。目前已有60人学习/浏览，适合需要参考完整项目结构、梳理SSM整合细节或进行功能扩展的高校学生，配合说明文档可快速理解建表逻辑与接口调用流程。

1. 一套SSM乡镇自来水收费系统源码包，装的是什么、能不能直接用

又到毕设季，你会发现“乡镇自来水收费系统”这类标题反复出现在各种源码打包分享里，配着“ssm+jsp+mysql+说明文档+LW”的字样。它面向的不是哪个乡镇水司的数字化改造，而是两类人：一类是要交毕设的在校生，需要一套能讲清楚、能演示、能过查重的系统；另一类是刚学完SSM、想找一个完整业务闭环练手的Java后端开发者。这套系统的技术栈是典型的Java Web老配方——SSM框架（Spring+SpringMVC+MyBatis）做后端，JSP做页面渲染，MySQL存业务数据，说明文档撑起论文素材。它解决的核心问题是：怎么用一个不太复杂、但业务链条完整的案例，把 Java Web 开发里的表结构设计、增删改查、权限登录、报表统计这些技能串起来。这套东西值不值得装进你的简历，关键看你会不会把它跑起来、改出差异化。这篇文章我就按自己调试这类毕设项目时的经验，把从解压到部署、再到答辩加分的关键步骤和踩过的坑完整过一遍。

2. 自来水收费的核心业务模型：水费不是简单的“单价×用量”

2.1 业务角色和数据流：一张图看懂收一次水费要经过几个环节

乡镇自来水收费和城市供水计费在业务上差别不大，但乡镇场景有两个特点：一是用户分散、表计老旧，很多还是人工抄表；二是水价结构复杂，居民、经营、工业、特种行业水价不一样，还可能叠加污水处理费。所以收费系统的核心不是“录一笔钱”，而是要管住“建档—抄表—计费—收费—统计”这条完整链路。

拿到源码后，我的习惯是先不急着开Tomcat，而是把所有SQL脚本里的建表语句拉出来看一遍数据流。一个正常的乡镇自来水收费系统至少要包含四张核心表：用户档案表（存户号、户名、地址、用水类别）、抄表记录表（存本次表底、上次表底、抄表日期）、水费账单表（存账单周期、用水量、应收金额）、缴费记录表（存实收金额、缴费时间、操作员）。有的项目还会多加一张水价表，把不同用水类别和阶梯水价单独存起来，这样调整水价就不用改Java代码。

这块有个很容易踩的坑：很多毕设源码的建表脚本里，表名字段名中英混杂，甚至直接用中文做字段名。MySQL默认情况下是允许中文列名的，但JSP页面里做表单提交、MyBatis做结果映射时，编码稍有不一致就会查出空值。我一般会先把所有字段名改成拼音或英文，顺便把字符集统一成utf8mb4，后面能少折腾很多。

2.2 阶梯水价的计算逻辑：用一条SQL还是用Java判断

水费计算的难点不在数据库操作，而在阶梯计价规则。很多乡镇实行的是“月用量阶梯累进”，比如居民用水一个月20吨以内按1.5元/吨，超过20吨的部分按2.3元/吨，再超过30吨按3.0元/吨。这种规则看起来简单，但如果用水类别多、违约金规则再插进来，写出来的if-else就非常难看。

我见过几种做法。第一种是在Java Service层里写阶梯判断，这是可读性最好的，也方便答辩时讲业务逻辑；第二种是在MySQL里用CASE WHEN写计算字段，SQL会短一些，但遇到复杂规则（比如季节性水价）就非常难维护；第三种是我自己比较喜欢的——把阶梯规则抽成一张水价配置表，每条记录包含用水类别、阶梯下限、阶梯单价，计费时先查出该用户类别的所有阶梯，再按用量逐级累加。这样换水价不用改代码，直接改数据库记录就行。

下面这段Java代码是阶梯水价计算的常见实现，核心是用“对阶梯列表循环、逐级扣减用量”的方式避免多层if嵌套：

public BigDecimal calcAmount(String userType, BigDecimal usage) { // 查出该用水类别下的所有阶梯，按 minUsage 升序排列 List<PriceStep> steps = priceStepMapper.selectByType(userType); BigDecimal remain = usage; BigDecimal total = BigDecimal.ZERO; for (int i = 0; i < steps.size() && remain.compareTo(BigDecimal.ZERO) > 0; i++) { PriceStep step = steps.get(i); BigDecimal maxUsage = step.getMaxUsage() == null ? remain : step.getMaxUsage(); // 落在当前阶梯内的用水量 = min(剩余用量, 当前阶梯上限-下限) BigDecimal currentUsage = remain.min(maxUsage.subtract(step.getMinUsage())); total = total.add(currentUsage.multiply(step.getPrice())); remain = remain.subtract(currentUsage); } return total; }

这里要注意的是BigDecimal的subtract和multiply都返回新对象，不能直接改原值；以及阶梯上限为null时要用remaining来代替，表示“无上限”。很多毕设源码直接用double算钱，这在答辩时是硬伤——面试官或评委会追问“金额精度为什么不用BigDecimal”，一个数据库DECIMAL加上BigDecimal的改动就能把这个加分项拿在手里。

价格配置表和计算逻辑的分离，也直接影响到后面要讲的统计报表模块。如果计算逻辑写在SQL里，月底汇总时每个用水类别的应收、实收都各写一套SQL，极容易出错；但有了配置表和统一的计费入口，报表只需要GROUP BY用户类别和月份，一个简单的聚合查询就够用了。

2.3 关键SQL：抄表、计费和欠费查询怎么写才能被答辩评委认可

业务模型立住之后，再回头看不难发现：抄表和计费这两步是系统最核心的两个事务。抄表的核心SQL是根据户号查询“上次表底”，再决定是否生成新账单；计费则是把2.2里算出的金额写回账单表。很多毕业设计会在这两步之间留一个很微妙的坑：抄表录入成功后没有立刻生成账单，而是等某个定时任务去批量生成。如果源码里注释和文档没写清楚，第一次看代码的人会以为功能丢了。

欠费查询是最常见的报表需求，它需要把账单表和缴费记录表做关联，找出“账单金额未被完全核销”的用户。这里我列一条参考SQL，后面部署调试时也能用得上：

SELECT u.user_name, u.user_addr, b.bill_month, b.amount, IFNULL(p.paid_amount, 0) AS paid_amount FROM t_user u JOIN t_bill b ON u.user_id = b.user_id LEFT JOIN ( SELECT bill_id, SUM(real_amount) AS paid_amount FROM t_payment WHERE pay_status = 'success' GROUP BY bill_id ) p ON b.bill_id = p.bill_id WHERE b.amount > IFNULL(p.paid_amount, 0) ORDER BY b.bill_month DESC;

这条SQL的思路是：先按账单分组求和已缴金额，再用外连接关联回来，最后在WHERE里过滤掉已缴清的记录。用LEFT JOIN而不是INNER JOIN，是为了把“一分钱都没交过”的欠费用户也捞出来——很多新手在这里用INNER JOIN，导致从未缴费的账单丢失，这是欠费报表“缺人”的经典原因。ORDER BY按月份倒序，展示最新一期的欠费，这也是业务上一个很讨巧的细节。

3. SSM框架整合与核心代码：从Mapper到Controller的完整调用链

3.1 SSM整合的骨架：web.xml、spring-mvc.xml和mybatis-config.xml三件套

SSM项目解压之后，第一件事就是看配置文件的完整度。一个能直接跑起来的SSM项目，WEB-INF下至少要有web.xml、spring-mvc.xml、applicationContext.xml和mybatis-config.xml。标题里后缀写着“ssm+jsp+mysql”，意味着前端不是前后端分离，而是JSP在服务端直接渲染后响应用户。

web.xml是整个项目的入口，它既要配置Spring的上下文加载监听器，又要配置SpringMVC的DispatcherServlet。常见的套路是：ContextLoaderListener监听器加载applicationContext.xml，负责组装Service层和Mapper层；DispatcherServlet加载spring-mvc.xml，负责扫描@Controller和URL映射。这两个Spring容器一定要区分清楚，否则会出现一个常见的报错：Service类同时被两个容器加载，事务注解失效。

mybatis-config.xml里通常只做两件事：开启驼峰命名映射（mapUnderscoreToCamelCase）和配置类型别名。很多毕设源码里没有这个文件，而是把这些配置塞到applicationContext.xml的SqlSessionFactoryBean里。两种写法都能跑，但在答辩时建议能说清楚：typeAliasesPackage的作用是让Mapper.xml里写resultType时可以直接用类名，不用写完整包名。这个小配置对代码整洁度的提升是立竿见影的。

3.2 Mapper、Service、Controller的分层边界：哪些注解是必须背下来的

SSM最常被问到的就是“常用注解有哪些”。这套系统里的注解使用是很好的范本，同时也是最常见面试题的出处。Controller层用@Controller标记类、@RequestMapping标记URL映射、@ResponseBody标记返回JSON的方法（不过这个系统里JSP为主，@ResponseBody通常只出现在Ajax接口里）。Service层用@Service标记业务类、@Resource或@Autowired注入依赖。事务则通过@Transactional标注在Service实现类的方法上，这个注解的位置是有讲究的：放在方法上表示只给当前方法开事务，放在类上表示给类下所有public方法开事务。

下面是SSM里典型的Controller与Service交互方式，一个水费账单查询功能：

@Controller @RequestMapping("/bill") public class BillController { @Resource private BillService billService; @RequestMapping("/list") public String list(@RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize, Model model) { // 这里的PageHelper.startPage只对下一条查询生效，注意顺序 PageHelper.startPage(pageNum, pageSize); List<BillVO> billList = billService.listBillWithUserInfo(); PageInfo<BillVO> pageInfo = new PageInfo<>(billList); model.addAttribute("pageInfo", pageInfo); return "bill/list"; } }

@RequestParam上的defaultValue必须写清楚，因为JSP分页链接第一次进来时通常不带pageNum参数。PageHelper的startPage有一个很容易踩的坑：它通过ThreadLocal将分页参数绑定到当前线程的下一条SQL查询，所以startPage之后必须紧跟着执行Mapper查询，中间不能穿插其他数据库操作，否则分页会被“下一个查询”抢走。这是PageHelper最著名的翻车点，前置Maven依赖引入的是pagehelper-spring-boot-starter还是pagehelper（配合手动配置的拦截器插件），也会影响排错方向。

Service层这时的职责不只是调用Mapper，还要负责把多表数据组装成View Object后返回给页面。很多毕设源码里Service直接返回Entity，JSP页面里取字段还要自己拼接，比如bill对象里没有用户名，要再拿userId去查user表——这就是典型的过度使用关联查询、代码不够清晰。我在改这类代码时，一般会在Service里组装一个VO（View Object），把需要展示的字段直接打包好，Controller连Model的代码都会简化很多。

3.3 MyBatis的Mapper.xml：resultMap、动态SQL和一对多映射

SSM项目里最吃功夫的部分是Mapper.xml。很多毕设系统的复杂查询都靠它撑起来，它不是JPA那种“全自动”的ORM，而是“半自动”——SQL要自己写，但结果映射可以替你做。常见做法是：单表查询用resultType直接映射，多表关联或字段名与属性名对不上时，用resultMap精确指定每一列的对应关系。

下面这段演示了一个带查询条件的水费流水Mapper：

<select id="selectPaymentRecord" resultType="com.example.vo.PaymentVO"> SELECT b.bill_month, b.amount, p.real_amount, p.pay_time, u.user_name FROM t_bill b LEFT JOIN t_payment p ON b.bill_id = p.bill_id LEFT JOIN t_user u ON b.user_id = u.user_id <where> <if test="userName != null and userName != ''"> AND u.user_name LIKE CONCAT('%', #{userName}, '%') </if> <if test="billMonth != null"> AND b.bill_month = #{billMonth} </if> </where> ORDER BY p.pay_time DESC </select>

<where>标签会自动去掉多余的AND或OR，这是MyBatis动态SQL最常用的技巧，比手写WHERE 1=1看着干净得多。#{userName}是预编译占位符，能有效避免SQL注入；用${userName}做字符串拼接则会直接嵌入SQL，参数里写“1; DELETE FROM t_user”就直接炸了。这也是面试官常问“MyBatis里#和$的区别”的出处——这道题值得在本系统里作为例子讲给答辩评委听，因为很多毕设代码确实因为赶工用的是$，一查一个准。

3.4 数据库连接配置：jdbc.properties里的四个关键参数

最后落到配置文件上。一个能连上MySQL的jdbc.properties至少要有四个要素：driver、url、username、password。driver根据MySQL版本有两种写法，5.x用com.mysql.jdbc.Driver，8.x用com.mysql.cj.jdbc.Driver。

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/water_system?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai jdbc.username=root jdbc.password=root

url里的useUnicode和characterEncoding不配置的话，中文写入数据库后读出来就是问号，这是毕设系统最常见的乱码根源；useSSL=false是为了省去MySQL8的SSL握手报错；serverTimezone=Asia/Shanghai是解决MySQL8.0以上时区差8小时的问题——如果不加，查询出来的时间字段会比实际少了8个小时。如果是MySQL 5.7.44，不需要serverTimezone也不会报错，但加上也没有副作用；而MySQL8则必须加，这是从老毕设源码迁移到新环境时最典型的配置坑。密码明文写在properties里是开发阶段的常见做法，不讨论生产安全性，但答辩时可以说“生产环境会用配置中心加密”来应对追问。

4. 把系统在本地跑通：IDEA+Tomcat+MySQL 的部署实录

4.1 前置环境：JDK、Maven、Tomcat 的版本怎么搭配才不会第一秒报错

拿到源码包后，我先看三样东西：pom.xml里的依赖版本、web.xml里的Servlet版本、以及项目是war包还是jar包。SSM毕设项目基本都是war包，部署到Tomcat而不是内嵌容器。版本搭配上，常见的稳妥组合是：JDK 8 + Tomcat 8.5 + Maven 3.6.x + MySQL 5.7。MySQL 8.0也能用，但要同步改驱动和url中的serverTimezone，这一点在第3章已经强调过。

Tomcat版本和JDK版本有强对应关系，Tomcat 8.5支持JDK 7及以上，Tomcat 9要求JDK 8及以上。如果电脑装的是JDK 11，一些老毕设源码里的cglib、javax.servlet依赖会报“模块不可见”的错误。所以我一般建议：你到手的源码如果pom.xml里写着spring 4.x、javax.servlet-api 3.x，那直接用JDK8去跑，别折腾升级。JDK版本不对，根本轮不到看代码逻辑就会在编译阶段卡住。

4.2 建库建表：SQL脚本导入MySQL 5.7.44 的完整过程

MySQL的安装过程比较繁琐，选择5.7.44还是8.0，取决于源码里的驱动和URL写法，这个在第3.4节有对应说明。下面直接说建库建表步骤。源码包里有一个.sql结尾的初始化脚本是MySQL的常见做法，我把它用命令行导入：

mysql -u root -p < water_system.sql # 如果用的图形化工具，在Navicat里新建数据库water_system，再右键运行SQL文件

导入完成之后，马上做两件事：第一，查看所有表是否创建成功；第二，查看初始化数据是否灌入（管理员账号、水价表数据是否都在）。很多毕设脚本里水价表是空的却没人发现，结果登录后去录入抄表记录，计算出金额为0。管理员密码通常是明文或MD5加密，如果源码文档里没写明管理员密码，就去t_user表里直接看，有的项目甚至默认密码就是admin。

4.3 IDE里的部署配置：Artifact、Tomcat Server、JRE三处必改

以IntelliJ IDEA为例，导入项目后要检查三处配置。第一处是Project Structure里的Artifacts，确认是Web Application Exploded的war包模式，并且Output Layout里lib目录下要有所有Maven依赖——如果启动时总是报ClassNotFoundException，十有八九是Artifact里没把Web-INF/lib加进去。第二处是Run Configuration里的Tomcat Server，需要在Server选项卡里选择本地安装的Tomcat目录，Deployment选项卡里把Artifact加入，并把Application Context设为/water（这个名称会出现在访问URL里）。第三处是JRE设置，选已安装的JDK8，如果一个都用不了，请回去看4.1的版本搭配。

配置完成后启动Tomcat，正常会在控制台看到“已启动”信息，然后访问http://localhost:8080/water就能看到系统的登录页。

4.4 第一次启动要改的三处代码：端口冲突、上下文路径、静态资源带不带版本号

第一次顺利启动的概率不到一半。最常遇到的几个问题：Tomcat默认端口8080被占用，我一般在Server.xml里改成8081或者按说明文档里指定的端口写；项目上下文路径不是/water而是空，访问首页的URL就不同；静态资源（CSS、JS、图片）里如果写了带版本号路径，一旦二次开发改了静态文件名而没同步修改JSP引用，页面就白屏。

还有一种很隐蔽的问题：JSP页面里favicon.ico请求报404，虽然不影响功能，但强迫症看着难受，我在路径上也处理过。这些改动都不涉及业务逻辑，但能快速排除“代码到底有没有跑起来”的干扰项。等登录页能正常展示，再去走“管理员登录—用户建档—抄表录入—生成账单—缴费登记”这条主流程，这时候系统才算真正在你的环境里立住了。

5. 避坑指南：SSM毕设最常见的五个翻车现场

5.1 中文乱码：表单提交后JSP页面全是问号

现象：录入用户姓名“张伟”，点击保存后列表页显示“????”。

原因：这一般不是数据库的问题，而是请求编码过滤器缺失或字符集不一致。SSM项目处理POST表单中文，必须在web.xml里配置一个编码过滤器：

<filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter>

解决：确认这个过滤器在web.xml里且位于所有过滤器最前面。同时检查JSP页面头部的pageEncoding="UTF-8"，数据库连接url的characterEncoding是否配置。三处都对，再清一次Tomcat的缓存，中文乱码问题基本能根治。只改一处往往表面好了，下个页面又出现，这是最典型的“玄学”问题，本质是三处字符集没有对齐。

5.2 MyBatis的“Invalid bound statement (not found)”报错

现象：点击某个查询功能，浏览器抛出异常，提示Mapper接口方法找不到对应的SQL语句。

原因：Mapper接口和Mapper.xml没有做Binding。SSM集成MyBatis时，在applicationContext.xml里配置了MapperScannerConfigurer，它会扫描某个包下的所有Mapper接口；而这些接口的XML文件如果不在同名包下，或者XML的namespace没有指向接口全限定名，就会绑定失败。

解决：把Mapper.xml放在resources目录下与接口相同的包路径中，并且确保XML的namespace写的是接口的完整类名。检查mybatis-config.xml里是否配置了mapperLocations，或者applicationContext.xml中sqlSessionFactoryBean的mapperLocations是否覆盖了classpath*:mapper/*.xml。

5.3 事务注解不生效：@Transactional没作用，数据回滚不了

现象：删除用户的同时应该删除其账单和缴费记录，但只删掉了用户表数据，关联表数据还在。

原因：最常见的是Service被new出来的，而不是通过Spring容器注入，事务代理没有生成；或者是被事务方法调用时，是在同类内部调用另一个方法，绕过了代理对象——“事务自调用失效”是Spring AOP的经典坑，这个问题的底层逻辑和“Spring事务管理原理”面试题直接相关。

解决：务必定义在Service实现类上，由Controller注入Service接口；如果事务方法中还要调同类方法，用注入自身的代理对象调，或把被调方法拆到另一个Service里。重启后测试删除操作，看控制台是否有“Creating new transaction”日志，没有就说明事务还没生效。顺便检查事务是否只加了类上但MySQL表引擎是MyISAM——MyISAM不支持事务，MySQL里CONVERT到InnoDB才行。

5.4 JSP编译错误或者页面报500但控制台没有任何异常输出

现象：JDK版本没问题、配置没问题，但JSP一访问就报错，控制台还看不到具体错误。

原因：Tomcat编译JSP的临时目录没有写入权限（Windows上常见），或者JSP页面调用的方法签名和Java后端的Bean方法名不一致。更难排查的是EL表达式里属性名拼写错误，EL表达式取不到值时不抛异常，只显示空字符串，看起来像“系统Bug”实际上是页面取值键名写错。

解决：先看Tomcat的logs目录下localhost日志，JSP编译报错会写在这里；然后检查JSP中所有EL表达式的键名与Model中addAttribute的键名是否一致。页面白屏排错用浏览器F12看网络请求，控制台看不出问题时优先看响应体内容，而不是干瞪控制台。

5.5 每次修改JSP不生效，重启N次还是老页面

现象：改了JSP页面的标题或者表格样式，刷新浏览器看不到变化，反复重启也没用。

原因：JSP文件被Tomcat编译后缓存到了work目录下，如果IDE没有同步到部署目录，或者浏览器本地缓存了旧页面，就会反复看到旧内容。这个坑普遍存在，尤其是用Tomcat8.5以后，对JSP的重新编译机制更“聪明”，但也更容易让你误以为自己没保存文件。

解决：IDEA里清理Tomcat的work目录，再重新构建Artifact；浏览器F12打开Network勾选Disable cache。JSP改完不必每次重启Tomcat，重新编译生效需要等待几秒，刷新页面多试几次。如果项目里用了JSP的 jsp:include 嵌套页面，改的是被包含文件，那么外层页面可能因为缓存没失效而看不到变化，这是JSP开发的老毛病。

6. 让这套系统能在答辩里“讲出亮点”：从能跑到会讲的三步改造

系统能在本地跑通之后，真正的差距在于能否讲出差异化。我的建议是选三个方向做改造，一个是性能或并发相关（模拟欠费催缴），一个是报表相关（导出Excel），一个是权限相关（Shiro或拦截器），总改造量不大，但背书效果足够。

第一个改造，给缴费模块加一个简单的模拟催缴接口。乡镇水务很常见的业务是逾期欠费催缴，代码上只需要在缴费Service里加一个查询欠费用户的方法，写个定时任务或者手动触发接口，给它生成“催缴记录”，用到封装好的业务逻辑，这处改动被追问的概率极低，但能体现你对“事务”概念的理解。

第二个改造，把月度统计报表改成可导出的Excel。用Apache POI生成xls文件，在Controller里返回ResponseEntity让浏览器下载。这一步工作量不大，但答辩演示效果很好，评审专家眼里的“毕设系统”就不是简单的CRUD了。导出Excel的同时，把“导出数据超1万条会有内存问题”讲到可以了，用SXSSFWorkbook流式写入，这又是一层加分。

第三个改造，给系统加一个拦访问面的登录过滤器，让没登录的用户访问任意JSP都自动跳登录页。这个可以用SpringMVC的Interceptor实现，代码量二三十行，时机上比用Shiro更贴切SSM课设的定位，也更容易讲清楚。做完这三个改造，你在答辩陈述时最好从真实业务角度切入：乡镇用户散、表计老、催缴难，系统是如何用串起“建档—抄表—计费—收费”这个链条来解决的，而不是干讲SSM怎么整合、注解怎么用。

我自己的习惯是：任何毕设项目拿到手，第一周先把数据流彻底读透，第二周改装，第三周专门练习“讲故障”——故意把配置改错、观察报错、再恢复，这个过程会让你的答辩底气完全不一样。别贪多，改一个惊艳的点胜过列一堆做不到的功能。这套乡镇自来水收费系统能不能变成你的加分解，不在于源码本身，而在于你有没有把每一步的为什么都弄明白。希望帮到你。

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