SSM商铺租赁管理系统实战：从框架整合到毕设答辩全攻略

做毕设的同学如果看到这个标题，大概率已经开始头痛了。“SSM商铺租赁管理系统”这个题目，在毕业设计里属于非常典型的Java Web方向，看起来不难，但真要做得漂亮、答得顺、跑得稳，还是有不少门道。这篇文章我就把自己折腾这个项目的过程、拆解思路、踩过的坑，以及怎么在这个基础上做出亮点，一次性讲清楚。

不管你是刚拿到题目还一头雾水，还是已经跑起来但卡在某一步，又或者是想在这个系统上做二次定制，这篇内容都可以作为一份完整参考。我会尽量说得直白一点，少绕弯子，把那些“老师不会在课堂讲、但实际做项目一定会遇到”的东西都翻出来。

1. 项目整体定位与设计思路

1.1 为什么选SSM而不是Spring Boot

先说一个很多人会问的问题：现在企业里Spring Boot都用得满天飞了，为什么毕设还要用SSM？答案很简单：因为教学大纲还在用，而且SSM能帮你把底层原理看得更透。

SSM是Spring + SpringMVC + MyBatis这套组合的缩写。Spring管对象和事务，SpringMVC管请求分发，MyBatis管数据库操作。相比Spring Boot那种“约定大于配置”的风格，SSM需要你手动写大量XML配置，这个过程很烦，但恰恰能逼着你理解Spring的IoC容器是怎么工作的、Mapper代理是怎么被扫描进去的、事务拦截器又是怎么起作用的。

我当时做完这个项目最大的感受是：Spring Boot写起来确实爽，但一旦出问题，排查思路完全依赖经验；而用SSM把配置一行行写过去之后，很多报错自己一眼就能看出是哪个环节的问题。对于答辩来说，老师问到底层原理你也能接得住，而不是只知道“加个注解就行”。

1.2 商铺租赁的业务需求到底有哪些

拿到题目先别急着写代码，第一步一定是把业务需求掰开揉碎。商铺租赁管理系统，核心角色无外乎三类：管理员、商户（租户）、还有可能存在的财务或运营人员。

站在业务角度，这个系统要解决的是商铺租赁全流程的线上化管理，而不是普通的增删改查。比如：商铺信息要能维护（位置、面积、租金单价、状态）；租户要能登记入驻，跟商铺建立租赁关系；合同要有起止时间、押金、租金、支付方式；到了收费节点要能生成账单，记录是否已缴；商铺和租户之间还有退租、续租、换铺这些状态流转。

如果你只做一张表搞到底，那答辩基本会凉。合理的做法是把租赁业务拆成几个核心模块：商铺管理、租户管理、租赁合同管理、租金账单管理，还有为了支撑这些数据而存在的系统管理模块（用户、角色、菜单权限）。这套模块划分，既符合实际业务逻辑，也方便后续在论文里画功能结构图。

1.3 完整功能模块拆解

我最终确定的功能结构是这样一层层铺开的：

• 登录与权限：管理员和商户两类角色，登录后展示不同菜单，敏感操作要有权限拦截。
• 商铺管理：商铺编号、名称、位置、面积、租金单价、状态（空置/已租/维修），支持条件查询。
• 租户管理：租户可以是个人也可以是企业，记录联系方式、证件信息、历史租赁记录。
• 合同管理：创建合同时选择商铺和租户，自动带出商铺租金信息，填写租期、押金、付款周期，合同状态可变更。
• 账单管理：根据合同周期生成应收账单，支持手动录入实收金额、生成收据编号。
• 数据统计：统计当前空置率、出租率、月度租金收入，用柱状图或表格展示。

这套功能模块看着多，但落到数据库层面其实也就六七张表的事情。关键是表之间的关系要理清：一个商铺同一时间只能有一个有效合同，一个租户可以有多份合同（不同时期），一份合同可以对应多个月度账单。

2. 核心环节拆解：数据库设计、框架整合与代码实现

2.1 数据库表设计与关系建模

数据库设计是整个项目的地基，表结构没设计好，后面写代码全是折磨。我当时用MySQL 5.7，字符集选utf8mb4，避免后面存特殊符号乱码。

核心表大致这样设计：

• 用户表（sys_user）：用户ID、用户名、密码（MD5加密存储）、角色ID、创建时间。
• 角色表（sys_role）：角色ID、角色编码、角色名称。
• 商铺表（shop）：商铺ID、商铺编号、名称、位置、面积、月租金单价、状态、备注。
• 租户表（tenant）：租户ID、姓名/公司名称、电话、证件号码、地址、创建时间。
• 合同表（contract）：合同ID、合同编号、商铺ID、租户ID、起租日期、结束日期、每月租金、押金、状态。
• 账单表（bill）：账单ID、合同ID、账单月份、应收金额、实收金额、缴纳状态、缴费日期。

有几点容易被忽略，我说一下：

第一，合同表和商铺表之间不是简单的一对多。因为合同存在续租、退租这些情况，同一商铺会关联多条历史合同。所以在查询“当前哪些商铺已出租”时，不能直接join合同表，而是要按“合同状态为生效中”这个条件过滤。我建议在合同表里加一个状态字段，用0/1/2表示生效中/已到期/已退租，查询时筛status=0。

第二，账单表不要设计成一张大表记所有费用明细。按月份拆分记录，好处是统计某月收入时直接按账单月份group by，效率高，逻辑也清晰。

第三，所有表都加上create_time和update_time字段，哪怕你觉得用不上。答辩时老师经常问“这个系统怎么审计数据变更”，有这两个字段至少能证明你考虑过。

2.2 SSM三层架构与调用链

SSM项目的标准结构是Controller -> Service -> Mapper三层。我按包名把项目分成controller、service、mapper、entity、dto、util几个目录，代码结构一目了然。

各层职责要分清楚：

• Controller层：接收前端请求，做参数校验，调用Service，返回ModelAndView或JSON数据。别把业务逻辑写在Controller里，这是大忌。
• Service层：处理业务规则，比如创建合同时需要校验商铺当前状态、计算押金金额、初始化首期账单，这些都是Service的活。
• Mapper层（DAO）：只负责数据库的增删改查，一个方法对应一条SQL，不掺业务判断。

这里有个很多新手会犯的错误：直接在Controller里new一个Mapper去调用数据库。这样做虽然能跑通，但事务控制基本没法做——比如“创建合同的同时生成账单”这个操作，如果第二次插入失败，合同已经写进数据库了，数据就不一致了。

正确的做法是在Service方法上加@Transactional注解，让Spring帮你管理事务。一旦中途抛出RuntimeException，所有已执行的SQL都会回滚。这是我强烈建议你在答辩时主动展示的一个细节。

2.3 MyBatis多表查询与动态SQL

MyBatis是SSM里最需要花功夫的部分。商铺列表一般要显示“当前租赁状态”和“当前租户名称”，这就涉及多表查询。我推荐用关联查询写一个扩展的ResultMap，而不是在Java代码里循环查库。比如：

<select id="selectShopWithTenant" resultMap="ShopWithTenantResultMap"> SELECT s.*, c.id AS current_contract_id, t.name AS tenant_name FROM shop s LEFT JOIN contract c ON s.id = c.shop_id AND c.status = 0 LEFT JOIN tenant t ON c.tenant_id = t.id <where> <if test="shopName != null and shopName != ''"> AND s.name LIKE CONCAT('%', #{shopName}, '%') </if> <if test="status != null and status != ''"> AND s.status = #{status} </if> </where> ORDER BY s.id DESC </select>

这条SQL的核心技巧在LEFT JOIN的ON条件里：c.status = 0。这样能保证只有“生效中”的合同才会被关联进来，避免一份旧合同干扰当前状态的判断。

动态SQL是MyBatis的精髓，尤其是查询条件不固定的时候。<where>结合<if>标签能很好解决“有值就过滤，没值就忽略”的问题。我在做租户查询和账单筛选时大量用了这个方式，免去拼接SQL的麻烦，也规避了SQL注入风险。

2.4 SpringMVC请求流程与前端渲染

SSM项目的前端大多使用JSP + JSTL，个别会用Vue做前后端分离。我建议毕设还是用JSP更稳妥，因为SSM官方教程、老师指导、论文参考一致性强，排查问题也更容易。

SpringMVC的调用链简单说就是：前端发起请求 -> DispatcherServlet拦截 -> HandlerMapping找到对应Controller方法 -> 方法返回ModelAndView -> ViewResolver解析JSP并渲染。理解了这个流程，以后遇到404或者莫名渲染出错，就能快速定位是Controller映射错了、还是JSP路径配错了。

在Controller里我习惯这么写：

@RequestMapping("/shop/list") public String list(Model model, ShopQuery query, Integer pageNum, Integer pageSize) { PageHelper.startPage(pageNum == null ? 1 : pageNum, pageSize == null ? 10 : pageSize); List<ShopVO> list = shopService.queryShopPage(query); PageInfo<ShopVO> pageInfo = new PageInfo<>(list); model.addAttribute("pageInfo", pageInfo); return "shop/list"; }

这里用到了PageHelper分页插件。它原理很简单，通过MyBatis拦截器在SQL执行前自动拼接LIMIT语句，前端只需要把页码和每页条数传进来就行。用PageHelper能给答辩加分不少，因为它是业界主流方案，不是自己造轮子。

3. 实操记录：源码导入、调试运行与定制扩展

3.1 环境搭建与工具链

工欲善其事，必先利其器。我在做这个项目时用的工具版本如下，你们可以照着配：

• JDK 1.8（不要用太高版本，SSM老项目对JDK版本敏感，JDK17有时候会出奇怪问题）
• Maven 3.6.3（用Maven管理依赖，省去手动导jar包的痛苦）
• Tomcat 8.5（和JDK1.8搭配最稳）
• MySQL 5.7（8.0也行，但要注意驱动版本和连接串的变化）
• IDEA 2020+（建议用Ultimate版，对Web项目支持更好）

如果你的机器上已经装了更高版本的工具，跑不起来不要慌，大概率是版本不兼容的问题，优先降级Tomcat和JDK，比调试代码省时间得多。

3.2 项目导入与配置修改的关键步骤

拿到源码之后，第一步是检查配置文件。SSM项目的核心配置有四份：jdbc.properties、mybatis-config.xml、spring-context.xml、spring-mvc.xml。每一份都可能有需要改的地方。

先说jdbc.properties，这里最重要的是数据库连接信息：

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

注意这个serverTimezone参数，MySQL 8.0版本不加的话会报时区错误。还有useSSL要设成false，否则控制台一堆证书警告。

spring-context.xml里主要配置了组件扫描、事务管理、SqlSessionFactory和数据源。你需要重点检查两点：

第一，<context:component-scan base-package="com.xxx.shop"/>这个包路径是否正确，必须指向你项目实际的Java包路径。

第二，事务管理器和<tx:advice>的配置，注意事务切点表达式对不对。如果切点配错，Service里的@Transactional就形同虚设。

spring-mvc.xml里有几处容易踩坑：注解驱动要开启，静态资源要放行。这台项目所有的JSP、JS、CSS都可能受这里影响。

<mvc:annotation-driven/> <mvc:resources mapping="/static/**" location="/static/"/>

如果不写静态资源放行，页面访问CSS、JS会被DispatcherServlet拦截，导致样式完全丢失。

3.3 调试运行过程中最常见的异常与处理

这部分我专门整理成表格，都是当初一个个踩出来、又一个个排查掉的：

还有一个小坑：测试数据库连接时，如果报了Access denied for user 'root'@'localhost'，先检查密码是不是真的对了，密码没问题就检查用户权限。因为很多开发者的MySQL是自带的初始密码，长时间没改会忘记。

3.4 新增需求怎么改：定制开发实例

题目里提到“定制”两个字，这个确实很常见。很多同学拿到的源码不能直接匹配自己的需求，需要改掉一部分功能或加上一个模块。我举三个很实际的例子。

第一个是加一个“到期提醒”功能。很多商铺租赁系统需要提前一个月提醒管理员某些合同快到期了。这个功能在SSM里实现起来很简单：合同表里已经有结束日期，在Service层写一个查询，筛选出结束日期在30天内的status=0的合同，再用ScheduledExecutorService或者直接在Controller里把提醒结果返回到首页dashboard。如果想做得更标准一点，可以用spring-context.xml里配的定时任务功能，加一句<task:annotation-driven/>，然后Service方法上标注@Scheduled(cron = "0 0 8 * * ?")。

第二个是用例是修改租金计算规则。有的系统不是按月固定收租，而是按季度递增，比如每季度涨5%。这种情况下，你不能在合同里只存一个固定月租金，要走一个计算策略。我当时做的时候是把租金增长方式拆成两个字段：增长比例、增长周期，然后写到一个租金计算方法里，在生成账单时动态计算当期应收金额。

第三个是导出Excel报表。答辩的时候能导出月度租金统计表特别加分。这个需求不需要重造轮子，直接用Apache POI写一个导出工具类，把List数据转成Workbook，通过HttpServletResponse输出到前端下载。核心代码如下：

@RequestMapping("/bill/export") public void export(HttpServletResponse response, Integer month) { List<BillVO> bills = billService.selectByMonth(month); HSSFWorkbook workbook = new HSSFWorkbook(); HSSFSheet sheet = workbook.createSheet("租金账单"); // 设置表头、填充数据... response.setContentType("application/vnd.ms-excel"); response.setHeader("Content-Disposition", "attachment;filename=bill_" + month + ".xls"); workbook.write(response.getOutputStream()); workbook.close(); }

定制开发的核心思路不是从零写，而是明确改动点和影响范围。改数据库表的时候一定要把老数据的兼容想清楚，改接口的时候要留意前端JSP里是不是引用了这个接口。

4. 文档、答辩演示与上线部署的隐藏要点

4.1 如何把文档写出答辩优势

源码能跑通只是及格，文档和答辩演示才是决定成绩上限的东西。很多同学源代码写得不错，但论文一塌糊涂，最后白白丢分。

写论文时最核心的是一张系统架构图和几张功能流程图。系统架构图建议画三层：表现层（JSP页面）、业务层（Spring管理Service事务）、持久层（MyBatis操作数据库），每层之间标注调用关系和数据流向。

功能流程图至少要画：登录验证流程、商铺租赁流程、退租处理流程。这些图不需要多复杂，但一定要把关键条件和兜底分支画出来，比如“商铺已出租时不能再次出租”“合同结束后自动关闭关联账单”这种逻辑节点，画上去之后老师会觉得你考虑问题很全面。

还有一个很有效的文档技巧：把表结构设计说明写成一张张表格，字段名、类型、长度、是否为空、说明，一目了然。老师翻论文时不用去看你的建表语句，直接就明白你的数据模型。

4.2 答辩演示的节奏和细节

演示操作时最忌手忙脚乱。建议提前把演示脚本背熟，按照这个顺序来：

先演示登录和权限控制——用管理员账号登录，进后台看菜单；然后故意用商户账号登录，让老师看到菜单变少，借此引出权限设计思路。

接着演示商铺管理——添加一个商铺，再在列表里搜索它，演示条件查询和分页。

再演示租赁合同的整个生命周期——创建合同、根据合同自动生成账单、模拟缴费、修改合同状态。这一步能展示你对业务流的把控，不是单纯的CRUD。

最后演示统计报表——展示每月收入柱状图和出租率，顺带把这些数据的SQL写法讲给老师听。

要注意，演示时如果遇到临时报错，千万别慌。绝大部分异常都是数据问题或环境问题，你先看控制台，再判断要不要现场修。老师一般不会因为一次环境故障否定你的项目，但如果你手足无措，印象分会大打折扣。

4.3 上线部署时最容易翻车的三个问题

把项目从本机搬到云服务器，有很三个容易被忽略的点：

第一个是端口没开。云服务商的安全组规则、服务器的防火墙都可能拦截8080端口。部署之前一定要把端口放行，否则浏览器一直转圈，你以为是Tomcat没起来，其实是流量被挡在门外。

第二个是数据库初始化。生产环境的MySQL连字符集、时区都可能跟本机不一样，导入SQL之后务必确认表的注释没有乱码，数据能正常读写。

第三个是日志排查。本机调试可以看IDEA控制台，但部署到服务器后必须通过日志文件定位问题。建议修改Tomcat的logging配置，把异常日志单独输出到一个文件，方便排查。

4.4 快速跑通的自动化小技巧

如果时间特别紧，来不及一行行核对配置，有些同学会选择直接把项目丢到IDEA里用一键部署。但我想提醒的是，SSM项目用嵌入式Tomcat插件跑和在外部Tomcat跑是有区别的。

我个人的习惯是用外部Tomcat，因为和学校机房环境一致，避免答辩时换个环境就挂掉。你用IDEA配置好Tomcat之后，每次启动前一定要先在Maven面板执行clean，把target清理干净，不然改过的Java文件有时候不会重新编译，启动的仍是旧代码。

再有就是数据库脚本，推荐拆成两个文件：01_schema.sql专门存建表语句，02_data.sql存初始化数据。后面想重置环境，直接重新执行两个脚本即可，不需要一条条删表。

5. 常见问题与排查技巧实录

5.1 启动报错篇

5.2 数据问题篇

5.3 性能问题篇

如果老师问“系统数据量大了怎么办”，光说加索引是不够的。你要能讲出这几个层次：

第一，给核心查询建索引。比如合同表的shop_id、status字段，账单表的contract_id、month字段。建索引之前先看执行计划，确认哪些SQL查询慢。

第二，用数据统计时避免全表扫描。月度租金收入可以维护一张按月汇总表，账单表只做流水记录，各模块都能用上。

第三，如果有跨表的复杂统计，可以直接在SQL里做JOIN加GROUP BY，效果比Java代码内存计算好得多。

还有一点提醒一下，PageHelper虽然好用，但大分页的时候会偏移比较长。比如第1000页的数据，LIMIT 9990,10这种写法，在数据量上百万之后会明显变慢。可以在SQL里先用子查询锁定ID范围，再做JOIN。

5.4 论文查重避坑

写论文时尽量别大段摘抄网上的博客或现成文档。老师年年都看这个题目，哪些内容是从哪个地方抄来的，一眼就能看出来。我个人的经验是：把业务流程、设计思路、遇到的问题和解决方案用自己的话重新组织一遍，尤其把自己改过的代码贴进论文，这部分的原创性天然就高。

6. 从“能用”到“好看”：体验优化与扩展思路

6.1 前端体验的细节打磨

系统交付的时候，除了功能完整，页面美观也是一项隐性评分。哪怕是SSM项目，页面不一定非得是十年前的老样子。

我建议前端至少优化这几个方面：在表格操作列加上状态标签（出租中显示橙色、空置显示绿色），使用自定义弹窗而不是浏览器自带alert，列表页顶部加上统计卡（总商铺数、已出租数、待收账单金额），这些改动不影响后端代码，只要JSP和CSS改动即可。

另外一个常见体验问题是按钮权限。有的系统在页面里把所有操作按钮都渲染出来，比如商户账号也能看到“删除商铺”按钮。真正的做法是，在Controller里把当前用户有权限的操作按钮列表传到前端，前端做条件判断，没有权限的按钮直接不渲染。这在答辩时可以重点展示，说明你懂“越权风险”这个概念。

6.2 可以扩展的新模块

如果你时间充裕，想在毕设里做得更出彩，下面几个方向可以考虑：

• 报修管理：租户提交商铺报修工单，管理员分配处理，处理完成后更新状态。
• 公告发布：管理员在系统里发布公告，商户登录后首页能看到最新公告。
• 数据可视化：使用ECharts在地图上展示各区域商铺分布，或者按月度做租金趋势曲线。
• 合同到期批量处理：用定时任务每日检查合同状态，自动把到期合同改为已到期，同时释放商铺状态。

扩展模块不要贪多，选择一两个做透就够了。像报修管理这种模块，只需要两张表（报修单、报修记录），再加一对JSP页面，成本不高，但功能上跟“租赁管理”的贴合度很高，比生硬加一个“物流管理”要自然得多。

6.3 性能和安全性需要注意的细节

最后提醒几个容易被老师问倒、但实际又很关键的点：

• 密码存储：一定不能明文存数据库。我当时用的是MD5加盐的方式，简单说就是把用户名和密码拼接后再做MD5，加了固定盐值，这样即使数据库泄露，密码也不容易被逆向。
• SQL注入：MyBatis的#{}默认是预编译的，安全性没问题。但要警惕手写拼接SQL的地方，这类代码在答辩时很容易被老师盯上。
• XSS攻击：在显示租户名称、备注等文本时，注意做HTML转义，防止恶意脚本执行。
• 文件上传：如果系统里有商铺照片上传功能，要校验文件扩展名和大小，并把上传文件放到WebContent外层的独立目录，避免被当成脚本执行。

写在最后的一点个人经验

这个项目我从拿到题目到完全跑通、再到打磨成答辩版本，陆陆续续花了两周左右时间。回头总结，最大的体会是：SSM最难的不是某个技术点，而是把Spring、SpringMVC、MyBatis这三套东西协调起来的过程。任何一个环节配置没对上，就会报出各种莫名其妙的错误。

如果你拿到的是源码，先别急着改功能，一定要把项目完整跑通一遍，把所有菜单点一遍，搞清楚每个页面背后的数据流。我是强烈建议在跑通之后，自己动手写一遍——不是重复所有代码，而是写一个最简单的模块，比如商铺管理，从建表到Controller、Service、Mapper、JSP页面完整走一遍，这个过程比看一百遍资料都有用。

还有个小技巧：调试SSM项目时，多利用日志。项目启动时如果Spring的Bean装配报错，先把ERROR行截图保存，然后逐行往上翻Look for Caused by内容。大部分问题都能通过这种方式解决。别一报错就重装环境，那样反而浪费时间。

宿舍机房和云的配置、Tomcat版本、MySQL版本、Maven仓库这些外部因素，往往比代码本身的bug更容易让你卡住。如果代码看着没问题但就是跑不起来，先问一下“环境是不是和原来不一样了”，再去怀疑代码，会省掉非常多折腾。

希望这篇文章能帮你少踩几个坑，顺利把SSM商铺租赁管理系统做出来，答辩拿个好成绩。后面如果遇到具体问题，也欢迎一起讨论。