简介这份资源是面向计算机专业毕业设计场景的SSM小区人口管理系统完整程序包适合正在准备Java方向毕设的本科生或需要参考SSM框架实战项目的开发者可解决从需求分析到功能测试全流程缺少可运行范例的问题。压缩包共305个文件约1.04MB以70个java源文件与70个class编译文件为核心配合67个vue前端页面、29个xml配置、14个js脚本及properties、sql等资源覆盖后端控制层、实体层与前端界面另附数据库脚本一份按说明配置环境即可运行。已有155人学习下载。项目围绕人口、费用、出入登记、疫情黑名单等模块展开包含需求分析、总体设计、数据库访问实现与关键代码读者可据此理解SSM分层结构、模块划分与测试思路作为毕设参考或二次开发基础较为实用。1. 从一份“能跑起来的毕设”说起ssm小区人口管理系统到底解决什么问题每年毕业季后台被问得最多的一句话不是“怎么写论文”而是“有没有一个能跑起来、能改、答辩时讲得清楚的 SSM 项目”。ssm小区人口管理系统就是冲着这个场景来的它把小区住户登记、人口信息维护、楼栋房屋关联、迁入迁出记录这几件社区管理里最琐碎的事做成了一套基于 Spring SpringMVC MyBatis 的增删改查闭环。别小看这套 CRUD真正动手时你会发现人口表和房屋表怎么关联、一户多人的数据结构怎么设计、分页查询和条件筛选怎么写才是血泪经验集中的地方。这份程序适合两类人一是需要一份结构完整、能本地跑通、能对着讲清分层的毕设参考二是刚接触 SSM、想找一个业务不复杂但链路完整的项目练手。下面我按“它是什么 → 怎么跑起来 → 核心代码长什么样 → 怎么改成自己的东西”这条线把它拆开讲。2. 技术栈与工程结构一个标准 SSM 分层项目是怎么搭起来的2.1 技术选型与依赖关系这套系统的骨架是经典的 SSM 三件套外加 JSP 做视图层、MySQL 做持久化、Maven 做依赖管理。选这套组合的原因很实际Spring 负责 Bean 管理和事务SpringMVC 负责请求分发和视图解析MyBatis 负责 SQL 映射三者职责边界清晰答辩时每一层都能单独讲。常见做法是 Spring 4.x MyBatis 3.x MySQL 5.7JDK 用 1.8Tomcat 用 8.5 或 9这套版本组合在本地环境里最不容易翻车。依赖层面pom.xml 里通常会有这几组关键坐标spring-context、spring-webmvc、spring-jdbc、spring-tx 构成 Spring 核心mybatis 和 mybatis-spring 负责与 Spring 整合mysql-connector-java 是驱动druid 或 c3p0 做连接池jstl 和 standard 支撑 JSP 标签log4j 或 slf4j 做日志。版本对齐是第一个坑mybatis-spring 的版本必须和 MyBatis 主版本匹配否则启动时会出现NoClassDefFoundError或者 Mapper 注入失败。!-- pom.xml 关键依赖片段 -- properties spring.version4.3.30.RELEASE/spring.version mybatis.version3.4.6/mybatis.version mybatis.spring.version1.3.2/mybatis.spring.version /properties dependencies !-- Spring 核心与 Web -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency !-- MyBatis 与 Spring 整合包版本必须匹配 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version${mybatis.spring.version}/version /dependency !-- MySQL 驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version /dependency /dependencies上面这段里spring.version和mybatis.spring.version是最容易出问题的地方。mybatis-spring 1.3.x 对应 MyBatis 3.4.x如果你把 MyBatis 升到 3.5 而整合包没动Mapper 扫描可能静默失败表现为启动不报错但注入的 Mapper 是 null。参数上mysql-connector-java用 5.1.49 是为了兼容 MySQL 5.7 的旧驱动协议如果本地装的是 MySQL 8驱动要换成 8.0.x 并调整连接串的时区和 SSL 参数。2.2 目录结构与分层职责工程目录是标准的 Maven Web 结构理解每一层的职责后面改代码才不会乱放。典型结构如下src/main/java/com/community/ ├── controller/ # SpringMVC 控制器接收请求、返回视图 ├── service/ # 业务接口 │ └── impl/ # 业务实现事务边界在这里 ├── mapper/ # MyBatis Mapper 接口 ├── entity/ # 实体类与数据库表对应 └── util/ # 分页、日期、结果封装等工具 src/main/resources/ ├── spring-core.xml # Spring 容器配置 ├── spring-mvc.xml # SpringMVC 配置 ├── mybatis-config.xml # MyBatis 全局配置 ├── jdbc.properties # 数据库连接参数 └── mapper/ # Mapper XMLSQL 写在这里 src/main/webapp/ ├── WEB-INF/ │ ├── web.xml # 前端控制器与监听器注册 │ └── views/ # JSP 页面 └── static/ # css、js、图片controller 层只做参数接收和视图跳转不写业务逻辑service 层承担事务和业务校验mapper 层只负责 SQL 映射。这个分层不是形式主义答辩时老师最爱问的就是“你的事务加在哪一层”答案必须是 service 层因为一个业务动作可能涉及多张表的写操作比如新增住户的同时要更新房屋的入住状态。2.3 配置文件之间的协作关系SSM 项目启动时web.xml 是入口它注册了ContextLoaderListener加载 Spring 根容器同时注册DispatcherServlet加载 SpringMVC 子容器。根容器管 service、mapper、数据源子容器管 controller两者通过父子容器关系共享 Bean。常见配置如下!-- web.xml 核心片段 -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-core.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mappingcontextConfigLocation指向根容器配置DispatcherServlet的init-param指向 MVC 配置url-pattern用/而不是/*是为了让静态资源交给默认 Servlet 处理否则 JSP 里的 css、js 会 404。这个细节很多人第一次搭项目时都会踩表现为页面样式全丢但接口正常。3. 核心模块拆解人口信息从录入到查询的完整链路3.1 实体设计与数据库表关联人口管理的核心是“人”和“房”的关系。一个小区有若干楼栋楼栋有若干房屋房屋里住着若干人口。表设计上通常拆成building楼栋、house房屋、resident人口三张主表外加move_record迁入迁出记录做流水。resident 表通过house_id外键关联房屋房屋通过building_id关联楼栋。实体类用最朴素的 POJO字段与表列一一对应日期用java.util.Date数值用包装类型避免默认值干扰。// Resident.java 实体片段 public class Resident { private Integer id; private String name; // 姓名 private String idCard; // 身份证号唯一 private String gender; // 性别 private Integer age; private String phone; private Integer houseId; // 关联房屋 private String houseNo; // 冗余房屋编号便于列表展示 private Date moveInDate; // 迁入日期 private Integer status; // 1 在住 0 迁出 // getter/setter 省略 }这里houseNo是冗余字段严格范式下不该存在但列表页要显示房屋编号如果每次都 join 房屋表SQL 会变复杂、分页也麻烦。我一般会在插入时同步写入这个冗余字段查询时直接取代价是房屋编号变更时要同步更新属于用一点一致性换查询性能的常见取舍。status用整型而不是布尔是为了后续扩展“暂住”“已迁出”“待审核”等多状态。3.2 Controller 层的请求处理Controller 负责把前端表单参数接住调用 service再把结果放回 Model 跳转 JSP。人口列表页通常带条件筛选和分页参数包括姓名关键字、楼栋、页码。写法上要注意参数绑定和空值处理Controller RequestMapping(/resident) public class ResidentController { Autowired private ResidentService residentService; // 分页 条件查询 RequestMapping(/list) public String list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(required false) String name, RequestParam(required false) Integer buildingId, Model model) { PageInfoResident page residentService.queryPage(pageNum, 10, name, buildingId); model.addAttribute(page, page); model.addAttribute(name, name); // 回显查询条件 model.addAttribute(buildingId, buildingId); return resident/list; // 视图解析器拼成 /WEB-INF/views/resident/list.jsp } // 新增人口 RequestMapping(value /add, method RequestMethod.POST) public String add(Resident resident, RedirectAttributes ra) { try { residentService.addResident(resident); ra.addFlashAttribute(msg, 新增成功); } catch (Exception e) { ra.addFlashAttribute(msg, 新增失败 e.getMessage()); } return redirect:/resident/list; } }RequestParam(defaultValue 1)保证页码不传时默认第一页required false让筛选条件可以为空。查询条件通过model.addAttribute回显否则翻页后筛选框会被清空这是列表页体验的关键细节。新增用RedirectAttributes的 flash 属性传递提示信息重定向后还能显示一次避免刷新重复提交。redirect:/resident/list是重定向到另一个请求不是直接返回视图这样浏览器地址栏干净也符合 PRG 模式。3.3 Service 层的事务与业务校验Service 层是事务边界也是业务规则落地的地方。新增住户时要校验身份证唯一、房屋是否存在、房屋是否已满员这些校验放在这里而不是 Controller是为了保证无论从哪个入口调用都生效。Service public class ResidentServiceImpl implements ResidentService { Autowired private ResidentMapper residentMapper; Autowired private HouseMapper houseMapper; Override Transactional(rollbackFor Exception.class) public void addResident(Resident resident) { // 1. 身份证唯一校验 int count residentMapper.countByIdCard(resident.getIdCard()); if (count 0) { throw new RuntimeException(该身份证已登记); } // 2. 房屋存在性校验 House house houseMapper.selectById(resident.getHouseId()); if (house null) { throw new RuntimeException(房屋不存在); } // 3. 写入人口同时更新房屋入住人数 resident.setStatus(1); residentMapper.insert(resident); houseMapper.increaseOccupancy(house.getId()); } }Transactional(rollbackFor Exception.class)是关键默认 Spring 只对 RuntimeException 回滚受检异常不回滚加上rollbackFor才能保证任何异常都回滚。方法里先查后写两步写操作插人口、更新房屋人数必须在同一事务里否则可能出现人口插进去了但房屋人数没加数据就对不上了。throw new RuntimeException在这里是业务异常实际项目里会换成自定义异常类但毕设规模用运行时异常足够。3.4 Mapper 层与动态 SQLMyBatis 的 Mapper XML 是这套系统里 SQL 最集中的地方。条件查询要用if动态拼 SQL分页用 limit 偏移。下面是一个典型的人口分页查询!-- ResidentMapper.xml -- select idqueryPage resultTypecom.community.entity.Resident SELECT r.*, h.house_no AS houseNo FROM resident r LEFT JOIN house h ON r.house_id h.id where r.status 1 if testname ! null and name ! AND r.name LIKE CONCAT(%, #{name}, %) /if if testbuildingId ! null AND h.building_id #{buildingId} /if /where ORDER BY r.id DESC LIMIT #{offset}, #{pageSize} /select select idcountPage resultTypeint SELECT COUNT(1) FROM resident r LEFT JOIN house h ON r.house_id h.id where r.status 1 if testname ! null and name ! AND r.name LIKE CONCAT(%, #{name}, %) /if if testbuildingId ! null AND h.building_id #{buildingId} /if /where /selectwhere标签会自动处理第一个AND避免WHERE AND的语法错误。LIKE CONCAT(%, #{name}, %)用#{}预编译防止 SQL 注入千万别图省事用${}拼接。分页的offset和pageSize由 service 层算好传进来offset (pageNum - 1) * pageSize。count 查询和 list 查询的条件必须完全一致否则会出现“总数 100 但翻到第 5 页是空的”这种玄学问题我一般把条件抽成sql片段复用减少不一致。4. 本地跑起来环境准备、建库与启动验证4.1 环境清单与版本核对跑这套项目之前先把环境对齐版本不匹配是启动失败的头号原因。需要准备JDK 1.8、Maven 3.6、MySQL 5.7、Tomcat 8.5 或 9、IDEA 或 Eclipse。JDK 别用 11 以上老版本 Spring 4.x 在 JDK 11 下会有反射相关的警告甚至报错。MySQL 字符集用 utf8mb4否则姓名里的生僻字会乱码。组件推荐版本说明JDK1.8Spring 4.x 兼容性最好Maven3.6.x依赖下载稳定MySQL5.7驱动 5.1.49 匹配Tomcat8.5 / 9Servlet 3.1 规范IDEIDEAMaven 项目导入方便4.2 建库建表与初始数据数据库脚本一般在src/main/resources/sql/下先建库再执行建表语句。库名常见为community_db字符集 utf8mb4。建表顺序有讲究先建 building再建 house最后建 resident因为有外键依赖。如果脚本里没写外键约束顺序无所谓但建议按依赖顺序执行方便排查。CREATE DATABASE community_db DEFAULT CHARACTER SET utf8mb4; USE community_db; CREATE TABLE building ( id INT PRIMARY KEY AUTO_INCREMENT, building_no VARCHAR(20) NOT NULL COMMENT 楼栋编号, unit_count INT DEFAULT 1 COMMENT 单元数 ); CREATE TABLE house ( id INT PRIMARY KEY AUTO_INCREMENT, building_id INT NOT NULL, house_no VARCHAR(20) NOT NULL COMMENT 房屋编号, capacity INT DEFAULT 4 COMMENT 可住人数, occupancy INT DEFAULT 0 COMMENT 已住人数 ); CREATE TABLE resident ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, id_card VARCHAR(18) UNIQUE NOT NULL, gender VARCHAR(4), age INT, phone VARCHAR(20), house_id INT, move_in_date DATE, status TINYINT DEFAULT 1 );id_card加了 UNIQUE 约束这是数据库层的最后一道防线即使 service 层校验漏了插入重复也会报错。occupancy字段和capacity配合做满员判断。初始数据建议插几条楼栋和房屋否则新增人口时选不到房屋页面下拉框是空的会让人误以为功能坏了。4.3 修改连接配置并启动jdbc.properties里的连接信息必须改成自己本地的jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/community_db?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password你的密码useUnicodetruecharacterEncodingutf8保证中文不乱码useSSLfalse避免旧驱动连接 MySQL 5.7 时的 SSL 警告。改完后在 IDEA 里配置 Tomcat部署 artifact 选war exploded应用上下文设成/community启动后访问http://localhost:8080/community/resident/list。如果页面 404先看 Tomcat 日志里 DispatcherServlet 有没有初始化成功如果 500 且报 Mapper 注入失败回去核对spring-core.xml里 MapperScannerConfigurer 的basePackage有没有写对。提示第一次启动前先执行mvn clean package确认依赖全部下载成功避免 IDE 里编译过了但 Tomcat 部署时缺 jar 包。5. 避坑与排查启动失败、乱码、分页错乱的典型现场5.1 启动报 Mapper 注入失败现象Tomcat 启动时报NoSuchBeanDefinitionException提示某个 Mapper 找不到。原因通常是 MapperScannerConfigurer 的扫描包路径写错或者 Mapper 接口和 XML 没在同一个包路径下。解决检查spring-core.xml里property namebasePackage valuecom.community.mapper/是否与实际包名一致XML 放在resources/mapper/下时确认mybatis-config.xml或mapperLocations配置了classpath:mapper/*.xml。两者缺一不可接口扫描和 XML 加载是两条独立配置。5.2 中文乱码从表单到数据库现象页面输入中文存进数据库变成问号。原因有三层JSP 页面没设pageEncodingUTF-8、web.xml 没配 CharacterEncodingFilter、数据库连接串没带 characterEncoding。解决JSP 头部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8%web.xml 里注册CharacterEncodingFilter并设forceEncodingtrue连接串补上characterEncodingutf8。三层都对齐才不会漏。5.3 分页总数和列表对不上现象列表显示 10 条但总页数算出来是 0 或者翻页后数据重复。原因多半是 count 查询和 list 查询的 where 条件不一致或者 offset 计算用了pageNum * pageSize而不是(pageNum - 1) * pageSize。解决把查询条件抽成sql idqueryCondition片段两个 select 都include它offset 在 service 里统一算别在 Controller 和 XML 里各算一遍。5.4 静态资源 404 导致页面样式丢失现象接口正常返回但页面没有样式F12 看到 css、js 请求 404。原因是 DispatcherServlet 的url-pattern配成了/*把所有请求都拦截了。解决改成/并在spring-mvc.xml里加mvc:default-servlet-handler/或mvc:resources映射静态目录。这个坑几乎每个手搭 SSM 的人都踩过改一个字符就能解决。5.5 事务不回滚导致数据半截现象新增人口时身份证重复抛了异常但房屋入住人数还是加了。原因是Transactional没生效常见于同类内部方法调用this 调用不走代理或者异常类型不在回滚范围。解决确认注解加在 public 方法上、由外部调用进入rollbackFor Exception.class别省Spring 配置里tx:annotation-driven/要开启。6. 二次开发改造从毕设 Demo 到能讲能改的自己的项目拿到这套代码最忌讳的是原封不动交上去。答辩老师一眼就能看出哪些是模板代码哪些是你自己的思考。改造的第一步是换业务外壳把“小区人口”换成“园区人员”或“宿舍住户”表名和字段跟着改但分层结构不动这样既保留可运行性又有了自己的业务语境。改的时候用全局替换要小心resident这种词可能出现在 SQL、JSP、Java 三处漏一处就编译不过我一般先改 entity 和 mapper再改 service最后改 controller 和 JSP按依赖顺序推。第二步是加一个能体现技术含量的功能。最省力的是把分页查询升级成带导出列表页加一个“导出 Excel”按钮Controller 里用 POI 把当前查询结果写成 xlsx。这个功能代码量不大但答辩时能讲“大数据量下的流式写出”和“查询条件复用”比单纯 CRUD 有说服力。核心思路是把 service 里的查询方法抽出来导出时传pageSize Integer.MAX_VALUE或者单独写一个不分页的查询避免导出只有当前页的尴尬。第三步是补权限。毕设项目常见做法是加一个简单的登录拦截器用 Session 存用户HandlerInterceptor 里判断未登录跳登录页。不用上 Shiro 或 Spring Security那会把项目撑得太重反而讲不清。拦截器注册在spring-mvc.xml的mvc:interceptors里排除登录和静态资源路径即可。验证改造是否成功别只看页面能点。我的习惯是每次改完跑三件事一是用 Postman 直接打接口确认返回 JSON 或视图名符合预期二是故意传非法参数空身份证、不存在的 houseId看异常提示是否友好、事务是否回滚三是翻到最后一页看分页边界很多人改完查询条件后最后一页会多出空数据。这三步走完基本能挡住大部分翻车。从那以后我每次接手这类 SSM 老项目都强制先把mvn clean package和一次完整的新增-查询-删除链路跑通再动任何一行代码后悔药这东西提前吃比事后找强。希望帮到你。本文还有配套的精品资源点击获取
简介这份资源是面向计算机专业毕业设计场景的SSM小区人口管理系统完整程序包适合正在准备Java方向毕设的本科生或需要参考SSM框架实战项目的开发者可解决从需求分析到功能测试全流程缺少可运行范例的问题。压缩包共305个文件约1.04MB以70个java源文件与70个class编译文件为核心配合67个vue前端页面、29个xml配置、14个js脚本及properties、sql等资源覆盖后端控制层、实体层与前端界面另附数据库脚本一份按说明配置环境即可运行。已有155人学习下载。项目围绕人口、费用、出入登记、疫情黑名单等模块展开包含需求分析、总体设计、数据库访问实现与关键代码读者可据此理解SSM分层结构、模块划分与测试思路作为毕设参考或二次开发基础较为实用。1. 从一份“能跑起来的毕设”说起ssm小区人口管理系统到底解决什么问题每年毕业季后台被问得最多的一句话不是“怎么写论文”而是“有没有一个能跑起来、能改、答辩时讲得清楚的 SSM 项目”。ssm小区人口管理系统就是冲着这个场景来的它把小区住户登记、人口信息维护、楼栋房屋关联、迁入迁出记录这几件社区管理里最琐碎的事做成了一套基于 Spring SpringMVC MyBatis 的增删改查闭环。别小看这套 CRUD真正动手时你会发现人口表和房屋表怎么关联、一户多人的数据结构怎么设计、分页查询和条件筛选怎么写才是血泪经验集中的地方。这份程序适合两类人一是需要一份结构完整、能本地跑通、能对着讲清分层的毕设参考二是刚接触 SSM、想找一个业务不复杂但链路完整的项目练手。下面我按“它是什么 → 怎么跑起来 → 核心代码长什么样 → 怎么改成自己的东西”这条线把它拆开讲。2. 技术栈与工程结构一个标准 SSM 分层项目是怎么搭起来的2.1 技术选型与依赖关系这套系统的骨架是经典的 SSM 三件套外加 JSP 做视图层、MySQL 做持久化、Maven 做依赖管理。选这套组合的原因很实际Spring 负责 Bean 管理和事务SpringMVC 负责请求分发和视图解析MyBatis 负责 SQL 映射三者职责边界清晰答辩时每一层都能单独讲。常见做法是 Spring 4.x MyBatis 3.x MySQL 5.7JDK 用 1.8Tomcat 用 8.5 或 9这套版本组合在本地环境里最不容易翻车。依赖层面pom.xml 里通常会有这几组关键坐标spring-context、spring-webmvc、spring-jdbc、spring-tx 构成 Spring 核心mybatis 和 mybatis-spring 负责与 Spring 整合mysql-connector-java 是驱动druid 或 c3p0 做连接池jstl 和 standard 支撑 JSP 标签log4j 或 slf4j 做日志。版本对齐是第一个坑mybatis-spring 的版本必须和 MyBatis 主版本匹配否则启动时会出现NoClassDefFoundError或者 Mapper 注入失败。!-- pom.xml 关键依赖片段 -- properties spring.version4.3.30.RELEASE/spring.version mybatis.version3.4.6/mybatis.version mybatis.spring.version1.3.2/mybatis.spring.version /properties dependencies !-- Spring 核心与 Web -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency !-- MyBatis 与 Spring 整合包版本必须匹配 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version${mybatis.spring.version}/version /dependency !-- MySQL 驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version /dependency /dependencies上面这段里spring.version和mybatis.spring.version是最容易出问题的地方。mybatis-spring 1.3.x 对应 MyBatis 3.4.x如果你把 MyBatis 升到 3.5 而整合包没动Mapper 扫描可能静默失败表现为启动不报错但注入的 Mapper 是 null。参数上mysql-connector-java用 5.1.49 是为了兼容 MySQL 5.7 的旧驱动协议如果本地装的是 MySQL 8驱动要换成 8.0.x 并调整连接串的时区和 SSL 参数。2.2 目录结构与分层职责工程目录是标准的 Maven Web 结构理解每一层的职责后面改代码才不会乱放。典型结构如下src/main/java/com/community/ ├── controller/ # SpringMVC 控制器接收请求、返回视图 ├── service/ # 业务接口 │ └── impl/ # 业务实现事务边界在这里 ├── mapper/ # MyBatis Mapper 接口 ├── entity/ # 实体类与数据库表对应 └── util/ # 分页、日期、结果封装等工具 src/main/resources/ ├── spring-core.xml # Spring 容器配置 ├── spring-mvc.xml # SpringMVC 配置 ├── mybatis-config.xml # MyBatis 全局配置 ├── jdbc.properties # 数据库连接参数 └── mapper/ # Mapper XMLSQL 写在这里 src/main/webapp/ ├── WEB-INF/ │ ├── web.xml # 前端控制器与监听器注册 │ └── views/ # JSP 页面 └── static/ # css、js、图片controller 层只做参数接收和视图跳转不写业务逻辑service 层承担事务和业务校验mapper 层只负责 SQL 映射。这个分层不是形式主义答辩时老师最爱问的就是“你的事务加在哪一层”答案必须是 service 层因为一个业务动作可能涉及多张表的写操作比如新增住户的同时要更新房屋的入住状态。2.3 配置文件之间的协作关系SSM 项目启动时web.xml 是入口它注册了ContextLoaderListener加载 Spring 根容器同时注册DispatcherServlet加载 SpringMVC 子容器。根容器管 service、mapper、数据源子容器管 controller两者通过父子容器关系共享 Bean。常见配置如下!-- web.xml 核心片段 -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-core.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mappingcontextConfigLocation指向根容器配置DispatcherServlet的init-param指向 MVC 配置url-pattern用/而不是/*是为了让静态资源交给默认 Servlet 处理否则 JSP 里的 css、js 会 404。这个细节很多人第一次搭项目时都会踩表现为页面样式全丢但接口正常。3. 核心模块拆解人口信息从录入到查询的完整链路3.1 实体设计与数据库表关联人口管理的核心是“人”和“房”的关系。一个小区有若干楼栋楼栋有若干房屋房屋里住着若干人口。表设计上通常拆成building楼栋、house房屋、resident人口三张主表外加move_record迁入迁出记录做流水。resident 表通过house_id外键关联房屋房屋通过building_id关联楼栋。实体类用最朴素的 POJO字段与表列一一对应日期用java.util.Date数值用包装类型避免默认值干扰。// Resident.java 实体片段 public class Resident { private Integer id; private String name; // 姓名 private String idCard; // 身份证号唯一 private String gender; // 性别 private Integer age; private String phone; private Integer houseId; // 关联房屋 private String houseNo; // 冗余房屋编号便于列表展示 private Date moveInDate; // 迁入日期 private Integer status; // 1 在住 0 迁出 // getter/setter 省略 }这里houseNo是冗余字段严格范式下不该存在但列表页要显示房屋编号如果每次都 join 房屋表SQL 会变复杂、分页也麻烦。我一般会在插入时同步写入这个冗余字段查询时直接取代价是房屋编号变更时要同步更新属于用一点一致性换查询性能的常见取舍。status用整型而不是布尔是为了后续扩展“暂住”“已迁出”“待审核”等多状态。3.2 Controller 层的请求处理Controller 负责把前端表单参数接住调用 service再把结果放回 Model 跳转 JSP。人口列表页通常带条件筛选和分页参数包括姓名关键字、楼栋、页码。写法上要注意参数绑定和空值处理Controller RequestMapping(/resident) public class ResidentController { Autowired private ResidentService residentService; // 分页 条件查询 RequestMapping(/list) public String list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(required false) String name, RequestParam(required false) Integer buildingId, Model model) { PageInfoResident page residentService.queryPage(pageNum, 10, name, buildingId); model.addAttribute(page, page); model.addAttribute(name, name); // 回显查询条件 model.addAttribute(buildingId, buildingId); return resident/list; // 视图解析器拼成 /WEB-INF/views/resident/list.jsp } // 新增人口 RequestMapping(value /add, method RequestMethod.POST) public String add(Resident resident, RedirectAttributes ra) { try { residentService.addResident(resident); ra.addFlashAttribute(msg, 新增成功); } catch (Exception e) { ra.addFlashAttribute(msg, 新增失败 e.getMessage()); } return redirect:/resident/list; } }RequestParam(defaultValue 1)保证页码不传时默认第一页required false让筛选条件可以为空。查询条件通过model.addAttribute回显否则翻页后筛选框会被清空这是列表页体验的关键细节。新增用RedirectAttributes的 flash 属性传递提示信息重定向后还能显示一次避免刷新重复提交。redirect:/resident/list是重定向到另一个请求不是直接返回视图这样浏览器地址栏干净也符合 PRG 模式。3.3 Service 层的事务与业务校验Service 层是事务边界也是业务规则落地的地方。新增住户时要校验身份证唯一、房屋是否存在、房屋是否已满员这些校验放在这里而不是 Controller是为了保证无论从哪个入口调用都生效。Service public class ResidentServiceImpl implements ResidentService { Autowired private ResidentMapper residentMapper; Autowired private HouseMapper houseMapper; Override Transactional(rollbackFor Exception.class) public void addResident(Resident resident) { // 1. 身份证唯一校验 int count residentMapper.countByIdCard(resident.getIdCard()); if (count 0) { throw new RuntimeException(该身份证已登记); } // 2. 房屋存在性校验 House house houseMapper.selectById(resident.getHouseId()); if (house null) { throw new RuntimeException(房屋不存在); } // 3. 写入人口同时更新房屋入住人数 resident.setStatus(1); residentMapper.insert(resident); houseMapper.increaseOccupancy(house.getId()); } }Transactional(rollbackFor Exception.class)是关键默认 Spring 只对 RuntimeException 回滚受检异常不回滚加上rollbackFor才能保证任何异常都回滚。方法里先查后写两步写操作插人口、更新房屋人数必须在同一事务里否则可能出现人口插进去了但房屋人数没加数据就对不上了。throw new RuntimeException在这里是业务异常实际项目里会换成自定义异常类但毕设规模用运行时异常足够。3.4 Mapper 层与动态 SQLMyBatis 的 Mapper XML 是这套系统里 SQL 最集中的地方。条件查询要用if动态拼 SQL分页用 limit 偏移。下面是一个典型的人口分页查询!-- ResidentMapper.xml -- select idqueryPage resultTypecom.community.entity.Resident SELECT r.*, h.house_no AS houseNo FROM resident r LEFT JOIN house h ON r.house_id h.id where r.status 1 if testname ! null and name ! AND r.name LIKE CONCAT(%, #{name}, %) /if if testbuildingId ! null AND h.building_id #{buildingId} /if /where ORDER BY r.id DESC LIMIT #{offset}, #{pageSize} /select select idcountPage resultTypeint SELECT COUNT(1) FROM resident r LEFT JOIN house h ON r.house_id h.id where r.status 1 if testname ! null and name ! AND r.name LIKE CONCAT(%, #{name}, %) /if if testbuildingId ! null AND h.building_id #{buildingId} /if /where /selectwhere标签会自动处理第一个AND避免WHERE AND的语法错误。LIKE CONCAT(%, #{name}, %)用#{}预编译防止 SQL 注入千万别图省事用${}拼接。分页的offset和pageSize由 service 层算好传进来offset (pageNum - 1) * pageSize。count 查询和 list 查询的条件必须完全一致否则会出现“总数 100 但翻到第 5 页是空的”这种玄学问题我一般把条件抽成sql片段复用减少不一致。4. 本地跑起来环境准备、建库与启动验证4.1 环境清单与版本核对跑这套项目之前先把环境对齐版本不匹配是启动失败的头号原因。需要准备JDK 1.8、Maven 3.6、MySQL 5.7、Tomcat 8.5 或 9、IDEA 或 Eclipse。JDK 别用 11 以上老版本 Spring 4.x 在 JDK 11 下会有反射相关的警告甚至报错。MySQL 字符集用 utf8mb4否则姓名里的生僻字会乱码。组件推荐版本说明JDK1.8Spring 4.x 兼容性最好Maven3.6.x依赖下载稳定MySQL5.7驱动 5.1.49 匹配Tomcat8.5 / 9Servlet 3.1 规范IDEIDEAMaven 项目导入方便4.2 建库建表与初始数据数据库脚本一般在src/main/resources/sql/下先建库再执行建表语句。库名常见为community_db字符集 utf8mb4。建表顺序有讲究先建 building再建 house最后建 resident因为有外键依赖。如果脚本里没写外键约束顺序无所谓但建议按依赖顺序执行方便排查。CREATE DATABASE community_db DEFAULT CHARACTER SET utf8mb4; USE community_db; CREATE TABLE building ( id INT PRIMARY KEY AUTO_INCREMENT, building_no VARCHAR(20) NOT NULL COMMENT 楼栋编号, unit_count INT DEFAULT 1 COMMENT 单元数 ); CREATE TABLE house ( id INT PRIMARY KEY AUTO_INCREMENT, building_id INT NOT NULL, house_no VARCHAR(20) NOT NULL COMMENT 房屋编号, capacity INT DEFAULT 4 COMMENT 可住人数, occupancy INT DEFAULT 0 COMMENT 已住人数 ); CREATE TABLE resident ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, id_card VARCHAR(18) UNIQUE NOT NULL, gender VARCHAR(4), age INT, phone VARCHAR(20), house_id INT, move_in_date DATE, status TINYINT DEFAULT 1 );id_card加了 UNIQUE 约束这是数据库层的最后一道防线即使 service 层校验漏了插入重复也会报错。occupancy字段和capacity配合做满员判断。初始数据建议插几条楼栋和房屋否则新增人口时选不到房屋页面下拉框是空的会让人误以为功能坏了。4.3 修改连接配置并启动jdbc.properties里的连接信息必须改成自己本地的jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/community_db?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password你的密码useUnicodetruecharacterEncodingutf8保证中文不乱码useSSLfalse避免旧驱动连接 MySQL 5.7 时的 SSL 警告。改完后在 IDEA 里配置 Tomcat部署 artifact 选war exploded应用上下文设成/community启动后访问http://localhost:8080/community/resident/list。如果页面 404先看 Tomcat 日志里 DispatcherServlet 有没有初始化成功如果 500 且报 Mapper 注入失败回去核对spring-core.xml里 MapperScannerConfigurer 的basePackage有没有写对。提示第一次启动前先执行mvn clean package确认依赖全部下载成功避免 IDE 里编译过了但 Tomcat 部署时缺 jar 包。5. 避坑与排查启动失败、乱码、分页错乱的典型现场5.1 启动报 Mapper 注入失败现象Tomcat 启动时报NoSuchBeanDefinitionException提示某个 Mapper 找不到。原因通常是 MapperScannerConfigurer 的扫描包路径写错或者 Mapper 接口和 XML 没在同一个包路径下。解决检查spring-core.xml里property namebasePackage valuecom.community.mapper/是否与实际包名一致XML 放在resources/mapper/下时确认mybatis-config.xml或mapperLocations配置了classpath:mapper/*.xml。两者缺一不可接口扫描和 XML 加载是两条独立配置。5.2 中文乱码从表单到数据库现象页面输入中文存进数据库变成问号。原因有三层JSP 页面没设pageEncodingUTF-8、web.xml 没配 CharacterEncodingFilter、数据库连接串没带 characterEncoding。解决JSP 头部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8%web.xml 里注册CharacterEncodingFilter并设forceEncodingtrue连接串补上characterEncodingutf8。三层都对齐才不会漏。5.3 分页总数和列表对不上现象列表显示 10 条但总页数算出来是 0 或者翻页后数据重复。原因多半是 count 查询和 list 查询的 where 条件不一致或者 offset 计算用了pageNum * pageSize而不是(pageNum - 1) * pageSize。解决把查询条件抽成sql idqueryCondition片段两个 select 都include它offset 在 service 里统一算别在 Controller 和 XML 里各算一遍。5.4 静态资源 404 导致页面样式丢失现象接口正常返回但页面没有样式F12 看到 css、js 请求 404。原因是 DispatcherServlet 的url-pattern配成了/*把所有请求都拦截了。解决改成/并在spring-mvc.xml里加mvc:default-servlet-handler/或mvc:resources映射静态目录。这个坑几乎每个手搭 SSM 的人都踩过改一个字符就能解决。5.5 事务不回滚导致数据半截现象新增人口时身份证重复抛了异常但房屋入住人数还是加了。原因是Transactional没生效常见于同类内部方法调用this 调用不走代理或者异常类型不在回滚范围。解决确认注解加在 public 方法上、由外部调用进入rollbackFor Exception.class别省Spring 配置里tx:annotation-driven/要开启。6. 二次开发改造从毕设 Demo 到能讲能改的自己的项目拿到这套代码最忌讳的是原封不动交上去。答辩老师一眼就能看出哪些是模板代码哪些是你自己的思考。改造的第一步是换业务外壳把“小区人口”换成“园区人员”或“宿舍住户”表名和字段跟着改但分层结构不动这样既保留可运行性又有了自己的业务语境。改的时候用全局替换要小心resident这种词可能出现在 SQL、JSP、Java 三处漏一处就编译不过我一般先改 entity 和 mapper再改 service最后改 controller 和 JSP按依赖顺序推。第二步是加一个能体现技术含量的功能。最省力的是把分页查询升级成带导出列表页加一个“导出 Excel”按钮Controller 里用 POI 把当前查询结果写成 xlsx。这个功能代码量不大但答辩时能讲“大数据量下的流式写出”和“查询条件复用”比单纯 CRUD 有说服力。核心思路是把 service 里的查询方法抽出来导出时传pageSize Integer.MAX_VALUE或者单独写一个不分页的查询避免导出只有当前页的尴尬。第三步是补权限。毕设项目常见做法是加一个简单的登录拦截器用 Session 存用户HandlerInterceptor 里判断未登录跳登录页。不用上 Shiro 或 Spring Security那会把项目撑得太重反而讲不清。拦截器注册在spring-mvc.xml的mvc:interceptors里排除登录和静态资源路径即可。验证改造是否成功别只看页面能点。我的习惯是每次改完跑三件事一是用 Postman 直接打接口确认返回 JSON 或视图名符合预期二是故意传非法参数空身份证、不存在的 houseId看异常提示是否友好、事务是否回滚三是翻到最后一页看分页边界很多人改完查询条件后最后一页会多出空数据。这三步走完基本能挡住大部分翻车。从那以后我每次接手这类 SSM 老项目都强制先把mvn clean package和一次完整的新增-查询-删除链路跑通再动任何一行代码后悔药这东西提前吃比事后找强。希望帮到你。本文还有配套的精品资源点击获取
