1. 项目概述与核心需求拆解格子铺管理系统说白了就是把一个物理空间切分成几十上百个独立编号的小格子然后租给不同的商家或个人售卖自己的商品。我当年做毕业设计的时候导师给的题目方向是“基于Spring Boot的中小规模商铺管理系统”我自己调研了一圈市面上的选题最终敲定了格子铺这个场景。为什么选它因为格子铺管理系统本质上是一个集“空间租赁管理 商品销售管理 会员运营”于一体的复合型业务系统它的数据模型天然涉及租户、合同、格子、商品、订单等多个实体比单纯的图书管理系统要丰富又比完整的电商平台要简单可控。这种“中间难度”恰好是毕业设计最喜欢的区间——既有足够的业务复杂度来体现工作量又不至于让同学们半年憋不出一个像样的东西。从实际运营场景来看实体格子铺的痛点非常明确格子出租状态靠纸质台账登记租户续租信息经常漏掉商品上架下架没有电子记录每天卖出多少货全靠人工盘点。我调研了好几家常州的格子铺发现大部分店铺老板还是用Excel表格管理所有格子这给我提供了清晰的业务流程参照。系统最终承担的硬功能包括格子信息管理出租、空闲、维修三种状态实时更新、租户信息管理商家入驻、退租、租赁合同管理起止日期、租金、保证金、商品上架下架、订单记录与统计、管理员登录与权限控制。所有功能都围绕一个核心问题格子铺老板如何用最少的成本把铺子管清楚。这个项目适合什么人参考一种是像我当年一样需要完成Java方向毕业设计的本科生另一种是想给自家格子铺或小型商场做内部管理工具的非程序员——虽然后者更大概率会直接买现成的但理解了这套系统的设计逻辑后你会发现所谓的“管理系统”并没有那么高深。2. 技术栈选型与项目架构设计2.1 Spring Boot 到底解决了我什么问题选题确定之后第一步不是在IDE里新建项目而是想清楚“用什么框架、为什么用这个框架”。很多同学第一步就栽在框架选择上今天听说Spring Boot方便就学Spring Boot明天看到教程里讲SSM就又犹豫了。我的建议很直接没有特殊原因毕业设计一律用Spring Boot。理由不难理解。Spring Boot最核心的价值是“自动装配 约定优于配置”。打个比方传统SSM整合的时候光Spring和SpringMVC的XML配置文件就能写几百行各种bean之间的依赖关系稍不留神就配错而Spring Boot把这一堆繁琐的配置全部自动化了。你用idea新建一个Spring Initializr项目勾选Web、MyBatis、MySQL这些依赖框架直接给你生成一个能跑起来的空壳你只需要往里面填业务代码就行。很多人会问选Spring Boot 2.x还是3.x这里我得说个比较现实的建议如果你用的Java版本是8或者11老老实实选Spring Boot 2.7.x只有你确定用的是JDK 17以上才考虑Spring Boot 3.x。这是因为3.x全面转向了Jakarta命名空间很多老版本的依赖和教程里的代码都不兼容对于毕业设计这种有时间节点压力的项目没必要在版本兼容性上给自己埋雷。2.2 项目整体架构的分层设计技术选型锁定Spring Boot之后我采用的是经典的四层架构Controller层负责接收前端请求和参数校验Service层负责业务逻辑处理Mapper层数据访问层负责与数据库交互Entity层对应数据库表的实体类。这种分层方式的好处是职责清晰、后期维护方便论文里的架构图和代码能一一对应上。前端部分我选了Thymeleaf模板引擎加一套轻量级后台管理模板没有用前后端分离的Vue。为什么一个很实际的原因毕业设计的重点是后端业务逻辑的完整性和数据库设计的合理性如果引入Vue Spring Boot前后端分离你不仅需要多维护一套Node环境还要解决跨域、token鉴权、多环境部署等问题这些内容每一项都能写进论文但每一项都不是格子铺管理系统这个选题的核心。当然如果你本身前端基础很好用Vue做一个漂亮的管理界面确实更加分这个要根据自己的时间安排来权衡。依赖管理用的是Maven而不是Gradle。原因很朴素Maven的生态更成熟网上的资料多遇到问题搜索出来的解决方案基本都是Maven的。而且学校机房里的开发环境普遍配置了Maven容易保持一致。2.3 技术选型对照表技术点我的选型备选方案选择理由后端框架Spring Boot 2.7SSM、Spring Boot 3.x配置简单、生态成熟、兼容JDK 8ORM框架MyBatis-PlusMyBatis、JPA单表CRUD可以少写大量XML数据库MySQL 8.0PostgreSQL、SQL Server环境搭建容易、国内资料多前端方案Thymeleaf AdminLTEVue3 Element Plus无需单独部署前端工程权限方案Sa-TokenShiro、Spring Security配置简洁支持RBAC模型构建工具MavenGradle生态成熟团队协作依赖稳定这套组合总体的感受是“稳”字当头。我不会在毕业设计里用那些特别新的框架来证明自己因为一旦新框架的某个API在教程里找不到答案工期就会受到影响。毕业设计的核心目标是按时交付而不是技术炫技这个认知我希望所有同学都尽早建立起来。3. 数据库设计与关键表结构说明3.1 需求分析阶段的实体梳理数据库设计是整个系统的基础也是我在答辩时被导师问得最多的地方。格子铺管理系统的数据库设计并不复杂但一定要做到“每个字段都有业务来源”这样答辩时才能站住脚。我梳理之后一共抽出六个核心实体管理员Admin、租户Tenant、格子Grid、租赁合同LeaseContract、商品Product、销售订单Order。围绕这六个实体我建立了E-R图关系如下一个管理员可以管理多个格子一个租户可以租用多个格子一个格子可以对应多个租赁合同但任何时刻只能有一个“生效中”的合同一个格子可以上架多个商品一个租户名下的商品会产生多个销售订单。这里面有个细节需要特别说明格子和租户之间为什么不是直接关联而是要通过租赁合同我当时处理这个问题经历了一番思考。最开始的设计是格子表里加一个tenant_id字段表示“当前这个格子被谁租着”。后来我意识到如果直接把tenant_id写在格子表里租户历史租约记录就丢了——你没法知道他上个月租的是哪个格子、租金是多少。引入租赁合同表后格子和租户的关系变成了“多对多通过关联表”不仅保留了历史数据还为后续统计每个格子的历史出租率提供了可能。这也是数据库设计中“违反直觉但正确”的一个经典案例。3.2 核心表的字段定义与索引设计第一个是格子表字段包含格子编号唯一索引、位置描述、面积、月租金、当前状态0空闲、1已出租、2维修中、创建时间、更新时间。格子编号我用的是“区域-楼层-序号”的组合方式比如A区-1层-03号这样管理员在后台列表里一眼就能定位物理位置。第二个是租赁合同表字段包含合同编号、租户id、格子id、合同开始日期、合同结束日期、月租金、押金金额、合同状态0履行中、1已到期、2已终止、签订时间。这里我加了一个非常重要的逻辑同一个格子同一时间段内不允许存在两份“履行中”的合同。这个约束不仅在代码层面做了判断还在数据库层面加了唯一索引最大程度防止了“一个格子租给两个人”的数据事故。第三个是销售订单表字段包含订单编号、商品id、格子id、租户id、销售数量、单价、订单金额、下单时间。为什么订单表里既要存商品id又要存格子id和租户id因为这三个分别是不同的维度商品id代表卖的是什么东西格子id代表商品在哪个位置被卖出租户id代表这笔钱算在哪个商家头上。分析报表的时候可以从任意维度切片统计非常方便。3.3 添加索引与数据初始化脚本创建表的时候一定要养成加索引的习惯哪怕是毕业设计这种数据量不会很大的系统。我在租户表的手机号字段、订单表的租户id和下单时间字段上都建立了索引因为这几个字段是查询频率最高的。不要觉得数据量小就不用索引——等到论文答辩时被问到“你的系统在数据量大时如何保证查询性能”有索引至少说明你考虑过这个问题。初始化数据方面我在resources目录下放了一个data.sql文件里面预置了三套基础数据一个默认管理员账号admin/admin123、十个测试格子模拟不同的位置和租金档位、三个示例租户。这样系统一启动就能直接看到页面效果不用自己手动往数据库里一条一条插数据。4. 核心功能模块的实现与关键代码解析4.1 登录认证与权限拦截这个模块我用了Sa-Token轻量级认证框架。相比Spring SecuritySa-Token的最大优势是“半小时能上手”。它的核心API只有login、logout、checkLogin这几个而Spring Security哪怕是最简单的表单登录也要配置过滤器链、UserDetailsService、PasswordEncoder等一堆东西。我在LoginController中定义了登录接口接收用户名和密码后先通过Service层校验用户存在且密码匹配成功后调用StpUtil.login(userId)签发会话令牌前端将令牌存入Cookie后续请求通过拦截器统一校验。拦截器只拦截/admin/**路径静态资源和首页放行。这样设计能够保证未登录用户无法访问管理页面但首页作为宣传展示页面仍然对外开放。密码加密这块必须单独拿出来说。我用的是BCrypt算法这是当前的主流方案生成出来的密文自动带随机盐同一个密码两次加密得到的密文都不一样能够有效防止彩虹表攻击。很多同学图省事直接用MD5存储密码这在答辩时会被重点提问“MD5加密后的密码同样可以被彩虹表破解你如何防御”所以与其到时支支吾吾不如现在就花二十分钟把BCrypt整合进来。4.2 格子管理模块状态流转与前端渲染格子管理模块是最核心的部分也是涉及业务逻辑最直接的地方。它需要提供格子信息的增删改查但真正的业务重点在于“状态流转”空闲格子可以被租下状态变为已出租已出租格子合同到期后自动变回空闲维修中的格子不能被租用。页面实现上我用了一个卡片式的布局来展示所有格子每张卡片显示格子编号、位置、月租金和当前状态并且用不同颜色的状态标签来区分绿色代表空闲、红色代表已出租、黄色代表维修中。前端通过Thymeleaf的th:each标签遍历格子列表配合th:style动态绑定颜色样式整个格子铺的“铺面感”一下就出来了演示效果非常直观。后端实现上状态修改走的是一个单独的接口不允许前端直接修改格子状态字段而是通过“出租”、“退租”、“报修”、“修复”这四个业务操作来驱动状态变化。这样做的原因是为了保证流程一致性比如退租操作不仅要修改格子状态为空闲还需要同步把相关租赁合同的状态更新为已到期如果前端只是改了一个status字段那合同表里的数据就是错乱的。注意这里有一个很多人容易犯错的地方。在“退租”业务中一定要先更新租赁合同状态再修改格子状态并且整个过程包在一个事务里。如果顺序反了万一合同状态更新失败格子已经变成空闲就可能发生“格子被其他人租走但原租户合同还未终止”的冲突。事务保证了这两个操作要么都成功要么都失败。4.3 租赁合同生成与租金计算租赁模块是整个系统里最具业务感的部分。当管理员选择某个格子点击“出租”时前端弹出表单要求选择租户、填写租期按月、填写押金。后端收到请求后执行一个完整的“签合同”事务校验格子状态是空闲校验同一格子在同一时间段没有冲突合同根据格子月租金乘以租期月数计算合同总金额插入租赁合同记录更新格子状态为已出租。租金计算这个逻辑看起来简单实际有两个容易忽略的问题第一个是跨月计算天数比如从9月15日租到10月14日如果简单用“结束日期减开始日期除以30”算出来的天数不准确租金就会出问题。我最后的处理方式是合同按整月签开始日期和结束日期格式化为“YYYY-MM”直接计算月份差规避了日粒度的问题。第二个问题是续租场景合同到期后租户要继续租我采用的是“原合同终止新合同重新创建”的方式而不是修改原合同的结束日期因为这样能保留完整的合同历史方便后续查账。这个模块写完之后我自己测试时发现了几个边界情况比如合同结束日期早于开始日期、租金金额为负数等都一一加了前端校验和后端校验。这部分的经验就是写完业务逻辑后一定要自己穷举边界条件不要等到测试阶段被同学或老师找出问题。4.4 商品与销售订单的数据流转商品管理相对简单就是常规的增删改查加图片上传。这里的核心难点其实是订单数据的统计维度因为格子铺运营方非常关心两类报表一是“每个租户卖了多少货”二是“每个格子创造了多少销售额”。所以我做了一个简单的维度统计接口支持按照格子、租户、时间段三个维度进行销售汇总。实现上用SQL的GROUP BY子句配合SUM、COUNT聚合函数三个维度通过不同的Mapper方法来处理。这里有一个技巧是我写了一个基础的订单查询SQL然后用MyBatis动态SQL的if标签根据前端传入的查询条件动态拼接WHERE子句实现了三合一统计而不是写三个几乎相同的大查询。代码量减少了三分之一维护起来也更轻松。商品图片上传这一块我用了本地磁盘存储方案文件保存在项目外的upload目录下数据库中只记录文件访问路径。这里必须提醒的是不要将上传的图片直接保存在项目的src/main/resources目录下因为重新打包部署的时候resources目录会被覆盖辛苦上传的图片全部丢失这是我亲身踩过的坑。5. 源码使用与本地运行指南既然标题里写着“附源码”那源码怎么跑起来必然是要重点讲的。我拿到手这个项目的源码时第一步不是急着启动而是先整体了解项目结构和配置信息因为一个陌生的Spring Boot项目直接跑往往会出现各种意想不到的问题。5.1 导入项目与环境准备先把环境确认好JDK版本这个项目用的是JDK 8对应Spring Boot 2.x非常稳妥、Maven版本3.6以上都可以、MySQL版本5.7或8.0都可以我使用8.0。用IntelliJ IDEA导入项目时选择“Open or Import”定位到项目的pom.xmlIDE会自动识别为Maven项目并下载依赖。这里有个实战经验很多同学导入项目后等了五分钟依赖都下载不完大概率是Maven的中央仓库网络问题。解决方法是把Maven的镜像源换成国内仓库在settings.xml里配置阿里云镜像速度能快十倍。5.2 数据库初始化与配置修改项目里如果带了数据库脚本文件通常放在sql目录下就先用你的数据库管理工具执行这个脚本。执行完毕后打开项目根目录下的application.yml文件按顺序检查几个关键配置spring.datasource.url改成你自己的数据库地址和库名spring.datasource.username / password改成你本地的数据库账号密码server.port启动端口默认是8080如果被占用可以改掉。确认无误后直接运行主类里的main方法。看到终端输出“Started Application in x seconds”这样的日志说明启动成功了。浏览器访问http://localhost:8080输入初始化数据中设置好的管理员账号就能看到管理后台的登录页。5.3 启动失败的常见场景我帮同学排查启动失败问题不下十次总结下来无非就是四类第一类是JDK版本不匹配项目要求JDK 8但你装了JDK 17启动时会报UnsupportedClassVersionError第二类是端口被占用本地可能已经跑了一个应用占着8080换个端口就能解决第三类是数据库连接失败大概率是密码填错或者数据库脚本没执行成功第四类是依赖缺失Maven没有正确刷新在IDEA里执行一下“Reload All Maven Projects”基本能搞定。提示如果你运行的主类是“xxxApplication”启动时发现没有任何报错但页面打不开先去查端口是否正确再去查项目上下文路径context-path。很多项目的访问路径并不是根目录“localhost:8080/xxx”这样的路径才是正确的后台入口。6. 常见问题与调试经验记录6.1 问题速查表问题现象可能原因解决方案启动报“UnsupportedClassVersionError”JDK版本过低或过高切换到项目指定的JDK版本页面能打开但登录后跳到404拦截器放行了错误路径检查Sa-Token拦截器注册的路径匹配规则数据库中文乱码连接URL缺少编码参数在JDBC URL后加characterEncodingutf8图片上传后无法预览静态资源映射未配置重写WebMvcConfigurer添加资源映射路径Maven依赖下载慢未配置国内镜像settings.xml添加阿里云镜像修改了代码但没生效未重启或IDEA缓存直接重启应用或清掉target后重新编译6.2 比较隐蔽的三个坑第一个坑是MyBatis-Plus的字段自动填充失效。我本来想用它的自动填充功能来自动写入create_time和update_time但发现只有新增的时候生效更新的时候update_time不会自动变化。排查半天发现原因是实体类里没有加上TableField(fill FieldFill.INSERT_UPDATE)注解加上就好了。这个坑很隐蔽因为编译不会报错日志也看不出来只能靠数据的实际变化来定位。第二个坑是统一返回结果类的类型擦除问题。我定义了一个Result 类型来统一返回JSON但前端拿到的时间字段全部变成了时间戳而不是格式化字符串。查了之后发现是Jackson配置里没开启时间格式化的全局配置。我直接在application.yml里配置了spring.jackson.date-format: yyyy-MM-dd HH:mm:ss再配合时区配置问题解决。第三个坑比较有意思是数据库字段名使用了“desc”导致的。我在设计格子表时给“位置描述”字段取了名叫description结果倒是没问题但另一个同学用了“desc”而这其实是MySQL的保留字导致SQL语句直接报语法错误。所以强烈建议取数据库字段名时凡是能想到的保留字比如desc、order、group、key一律避开可以加上前缀f_或s_来避免冲突。6.3 答辩准备方面的经验除了代码本身答辩也是毕业设计的重要一关。我当时的经验是给系统准备一份“功能演示脚本”按顺序展示核心模块每一步都提前模拟好数据。演示的时候不要照本宣科地一张张翻页面而是围绕着业务流程来讲先讲格子怎么来的再讲怎么租出去然后讲租户的商品怎么卖最后讲月底如何统计账目。把评委当成你的用户引导他们跟着你的业务逻辑走答辩的效果会好很多。另外把系统里遇到的坑和解决方案整理成文档答辩时主动提一两个。比如就说“我在设计租赁合同时一开始考虑直接在格子表里存租户id后来发现这样做丢失了合同历史所以才引入合同表”。这种话术比任何华丽的功能介绍都更能体现你的独立思考能力和实际动手经验。7. 最后的个人实操心得分享这个项目做完之后我对“管理系统”这类选题的理解已经完全不同了。做之前觉得它无非是“增删改查”做之后才发现任何一个看起来简单的管理系统把细节抠到数据库层面之后都会暴露出大量的业务设计决策。就拿“退租”这一个操作来说涉及格子状态更新、合同状态终止、押金退还记录、商品下架提醒四件事每一件事漏掉都是真实业务事故。我想给选题还犹豫不决的同学一个建议如果你没有特别强烈的兴趣方向像格子铺管理系统、便利店管理、健身房会员管理、校园二手交易平台这类“实体业务数据流转”的选题是性价比最高的选择。它们的业务逻辑足够清晰实体关系不会复杂到让人崩溃又有充分的扩展空间——你可以加图表统计、可以加消息通知、可以加权限分级上限很高。最后再分享一个小技巧写代码之前先找一个真实的格子铺老板聊半个小时。我就是通过一次闲聊搞清楚了“押金”和“租金”是两个完全不同的钱“续租”和“新签”在运营者眼里也是两件完全不同的事这些认知让我避免了在设计数据库时把它们混为一谈。好的毕业设计系统不是技术的堆叠而是对业务真实运转的理解与还原——这句话等你答辩通过之后大概就能真正体会到了。