简介在Web应用开发中后台管理系统是最常见的工程实践之一。Spring Boot作为主流Java开发框架凭借自动配置、内嵌容器等特性大幅降低了项目搭建门槛而MyBatis则把SQL控制权交还给开发者便于处理复杂查询与统计报表二者组合是Java后端毕业设计与中小型系统的通用选型。以小区物业管理为典型场景系统覆盖业主档案、在线报修、物业缴费、车位管理等核心业务线其源码分层规范、表结构清晰是学习真实项目结构的优质样本。围绕这套基于Spring Boot的物业管理系统从技术栈选择、数据库设计、环境配置到接口联调完整梳理了从源码导入到跑通的实操路径并拓展至访客登记模块的二次开发以及MySQL时区、端口占用、依赖版本等高频避坑点帮助开发者建立从基础框架到工程落地的系统认知。1. Spring Boot 小区物业管理系统这份源码为什么值得照着跑一遍手里这份《基于 Spring Boot 的小区物业管理系统》源码包不是那种只有 CRUD 空壳的演示项目而是把物业场景里真正高频的几条业务线都做了进去业主与房屋档案、在线报修、物业费缴费记录、车位管理、公告发布后台区分管理员和物业人员两类角色。我拆包后的第一个感受是它的表结构比很多培训班项目干净状态字段、创建时间、逻辑删除这些基本素养都有导师追问时不容易被问倒。适合两类人下载正在做 Spring Boot 毕业设计、又被导师反复要求“补充业务逻辑”的同学以及学完 SSM 但没见过完整项目结构的 Java 初学者。照着一遍源码跑下来比看十篇架构文章都实在。2. 系统与技术栈拆解Spring Boot MyBatis 的常规打开方式拿到源码先别急着点启动按钮我习惯先花半小时把技术栈、表结构、分层结构摸清楚。这套源码不是靠稀奇技术堆出来的恰恰是它“常规”才适合毕业设计——答辩时导师问的每一个点都落在你学过的基础知识范围内。2.1 技术栈选型为什么是 Spring Boot MyBatis 而不是 JPASpring Boot MyBatis 是 Java 后端毕业设计里出现频率最高的组合没有之一。Spring Boot 负责自动配置、内嵌 Tomcat、starter 依赖管理让你不用写一堆 XML 配置MyBatis 把 SQL 控制权留在开发者手里写复杂联查、统计报表时比 JPA 直观。我见过不少用 JPA 做毕设的同学答辩时被问“这段查询生成的 SQL 是什么样”当场答不上来——JPA 底层是黑匣子而 MyBatis 的 XML 里清清楚楚写着每条 SQL。对比维度MyBatisSpring Data JPA毕业设计场景里的选择理由SQL 可读性完全可控XML 里能看到完整 SQL由方法名派生复杂查询难读导师常问 SQLMyBatis 直接展示学习成本低会写 SQL 就会用中需要理解 ORM 映射生命周期论文好写自己也好讲性能调优可直接改 SQL、加索引需要懂 Hibernate 缓存机制系统数据量小但答辩要有话说周边资料毕业设计项目存量极多存量也不少但排错难网上相似项目多踩坑方便这套源码的骨架比较标准Spring Boot 2.7.x MyBatis MySQL Thymeleaf Maven后端按 Controller / Service / Mapper 三层切分前端用 Thymeleaf 模板渲染管理后台。pom.xml 里核心依赖是这样的parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency /dependencies注意 mybatis-spring-boot-starter 的 2.3.2 版本适配的是 Spring Boot 2.x。如果你用 Spring Initializr 新建项目时选了 Spring Boot 3.x那 starter 要升级到 3.0 系后面避坑章我会专门说这个翻车点。这里先记住这份源码的 pom 不要在未确认版本关系的情况下乱升。2.2 数据库设计六张核心表与状态字段这套系统的数据库核心是六张业务表外围还有几张关联表。我拆包后建了表字段命名风格统一主键都是自增 id每张表都带 create_time删除敏感数据用状态字段而不是物理 DELETE。这种设计在毕业设计里是加分项因为它贴近真实项目的软删除习惯。表名业务含义关键字段building楼栋信息id, building_no, floors, create_timehouse房屋信息id, building_id, room_no, area, statusowner业主信息id, house_id, name, phone, wechat, statusrepair业主报修id, house_id, owner_id, content, status, create_timepayment物业费缴费id, house_id, period, amount, status, pay_timenotice公告发布id, title, content, publisher, create_time拿报修表 repair 举例建表 SQL 大致是这样的结构CREATE TABLE repair ( id INT NOT NULL AUTO_INCREMENT COMMENT 报修单ID, house_id INT NOT NULL COMMENT 房屋ID关联house表, owner_id INT NOT NULL COMMENT 业主ID关联owner表, content VARCHAR(500) NOT NULL COMMENT 报修内容, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待处理 1处理中 2已完成 3已取消, handler VARCHAR(50) DEFAULT NULL COMMENT 处理人, handle_time DATETIME DEFAULT NULL COMMENT 处理时间, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 报修时间, PRIMARY KEY (id), KEY idx_house_id (house_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT业主报修表;这里最值得学的是状态字段的设计status 用 TINYINT 存数字代码里用常量或枚举映射含义而不是直接存“待处理”这种中文字符串。好处是数据库体积小、查询快改状态文案不用动数据库。我一般会在实体类里写一组常量比如public static final int STATUS_PENDING 0;业务代码里可读性也够。house_id 加索引是因为报修查询基本都走“某个房屋 → 历史报修”这条路没有索引的话数据量过万就会明显变慢答辩时这也是一个能主动讲的优化点。2.3 后端分层一次报修请求从 Controller 到 SQL 的完整链路搞清楚表结构之后我建议顺着一个具体功能把后端代码走一遍。这比逐个类读效率高得多。以“业主提交报修”为例调用链是前端表单提交 → RepairController 接收参数 → RepairService 处理业务 → RepairMapper 执行 SQL → MySQL 落库再返回结果给前端。RestController RequestMapping(/repair) public class RepairController { Autowired private RepairService repairService; PostMapping(/add) public Result add(RequestBody Repair repair) { // 参数校验报修内容和房屋ID必填 if (repair.getHouseId() null || repair.getContent() null) { return Result.error(房屋ID和报修内容不能为空); } // 初始状态强制置为0防止前端传入非法状态 repair.setStatus(Repair.STATUS_PENDING); return repairService.addRepair(repair) ? Result.ok() : Result.error(提交失败); } }Controller 只做三件事收参数、做基础校验、调 Service。业务规则放在 Service 里SQL 放在 Mapper 层这是最不容易被导师挑毛病的分层方式。注意repair.setStatus(Repair.STATUS_PENDING)这一行我刻意提一下从外部传入的状态值一律不信任这是真实项目里防止越权的常见做法。Service 层再往下RepairMapper 的接口和 XML 配合完成 SQL 执行public interface RepairMapper { int insertRepair(Repair repair); ListRepair selectRepairList(Param(houseId) Integer houseId, Param(status) Integer status); }对应 XML 里写 insert 语句时关键点是使用useGeneratedKeys让数据库生成的自增 ID 回填到实体里这样前端立刻能看到新单号insert idinsertRepair useGeneratedKeystrue keyPropertyid INSERT INTO repair (house_id, owner_id, content, status, create_time) VALUES (#{houseId}, #{ownerId}, #{content}, #{status}, NOW()) /insertuseGeneratedKeystrue配合keyPropertyid执行完 insert 之后 repair.getId() 就有值了省的再查一次。写双层列表查询时MyBatis 的动态if配合where可以按条件拼 SQL这是它比 JPA 灵活的地方。3. 从 IDEA 导入到一键启动先跑通再改代码技术栈心里有数了就进入实操环节。这一章的目标是让零基础的读者也能在半小时内把这个系统跑起来。我按自己排错的经验把从环境核对到登录验证的每一步都拆开讲参数给你原因也给你。3.1 环境核对JDK、MySQL、Maven 版本怎么搭配我先给一份环境清单照着配基本不会出问题。这套源码用的是 Spring Boot 2.7最低要求 JDK 8但实测 JDK 8 和 JDK 11 都能跑我推荐 JDK 8 是因为和毕设论文里写的环境一致答辩时不会被追问“为什么不用 17”。软件推荐版本说明JDK1.88u202Spring Boot 2.7 完全兼容高版本需改配置MySQL5.7 或 8.0源码对两者兼容但连接串 driver 有区别Maven3.6.3 以上IDEA 自带即可命令行需要独立装IDEA2021.1 以上Ultimate 或 Community 都行数据库客户端Navicat / DBeaver用来导入 sql 和看数据有人习惯用 VSCode 装 Spring Boot 插件跑项目不是不行但毕业设计阶段我不建议IDEA 对 Maven 依赖下载、Spring Boot 运行配置、断点调试的支持更完整排错时少折腾环境问题。打开 IDEA 后选择File - Open定位到解压后的源码根目录等 Maven 把依赖拉完。第一次拉依赖会很久因为要下载几百 MB 的 jar这里放个提示。提示Maven 默认中央仓库在国内下载很慢建议先配置阿里云镜像。配置文件在~/.m2/settings.xml没有就新建一个。这是整个跑通流程里最省时间的操作。3.2 修改 application.yml数据源、端口与上下文路径依赖拉完后别急着启动先改配置文件。源码里配置文件位置是src/main/resources/application.yml整个项目能不能起来80% 取决于这一关。我把一个典型的配置帖出来每行都标注了参数含义server: port: 8080 servlet: context-path: /property spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/property?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 thymeleaf: cache: false mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.property.entity configuration: map-underscore-to-camel-case: trueserver.port是服务端口号默认 8080如果你本机 8080 被占用改成 8081 或 9090 都行改完访问地址要跟着变。context-path是上下文路径这里设置为 /property意味着所有接口地址都要带这个前缀完整访问地址是http://localhost:8080/property/。这个参数很容易漏漏掉的话登录页能打开但接口全部 404。数据源那块driver-class-name在 MySQL 8.x 下必须写com.mysql.cj.jdbc.Driver老版本的com.mysql.jdbc.Driver会打印弃用警告而且部分版本直接连不上。url里的serverTimezoneAsia/Shanghai是 MySQL 8 的硬性要求不写的话报时区错误这一点我在避坑章单独拿出来说因为太常见了。map-underscore-to-camel-case: true解决的是数据库下划线字段名到 Java 驼峰属性的自动映射比如house_id自动映射到houseId少写大量resultMap配置。3.3 初始化数据库与启动项目配置文件改完接下来建数据库、导表结构和初始数据。源码包里一般带property.sql里面是建表语句加初始管理员账号。我用命令行演示标准流程用 Navicat 的话就是右键执行 SQL 文件mysql -u root -p123456 CREATE DATABASE property DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE property; SOURCE /Users/yourname/Downloads/property/property.sql;utf8mb4字符集比utf8多支持 emoji 和特殊符号这是为什么我建议建库时不用默认字符集的原因。SOURCE后面的路径要写你本地实际解压路径路径里有空格的话用引号包住。数据库准备好后启动方式有两种。第一种是 IDEA 里直接运行主类主类一般在com.example.property包下名字形如PropertyApplication右上角绿色三角运行即可。第二种适合演示或部署给导师看用命令行打包运行mvn clean package -DskipTests java -jar target/property-0.0.1-SNAPSHOT.jar-DskipTests是跳过单元测试毕设项目里测试可能没写完整跳过能避免打包失败。jar 包名字以实际 pom 里artifactId和version为准命令里不要照抄。看到日志里出现Started PropertyApplication in x.xxx seconds就说明启动成功了。3.4 登录与验证初始数据启动成功后浏览器访问http://localhost:8080/property/会跳转到登录页。源码包里使用文档都会写明初始账号常见组合是 admin / admin123。这里我建议你登录后第一件事不是点功能而是打开浏览器开发者工具F12切到 Network 面板手动慢慢点一遍菜单观察每个操作对应哪个接口、传了什么参数、返回什么 JSON。这一步的价值是让你形成“页面操作 ↔ 后端接口 ↔ 数据库表”的映射关系。比如你点“报修处理”的时候Network 里会出现一个 POST/property/repair/update请求Payload 里带着 repairId 和 status数据库里对应 repair 表那行记录的 status 从 0 变成 1。把这张映射记清楚后面二次开发和答辩演示都靠它。整套系统里几个角色可以多切换着登录看看管理员能看到全部菜单物业人员只能看到报修和缴费处理界面这个权限差异会在后面二次开发时用到。4. 二次开发实战新增一个访客登记模块跑通是第一步毕业设计真正拉开差距的是你能不能“加新功能”。这一章我以“访客登记”为例把从建表到前端页面的完整流程走一遍。选这个模块是因为它在物业场景里逻辑自治、不依赖复杂流程适合作为答辩时展示“我独立开发了一个模块”的证据。4.1 建表与实体字段设计要点访客登记的业务是保安或管理员登记外来访客记录来访业主的房号和事由并跟踪访客进出状态。我先建表字段刻意模仿源码里的命名风格这样代码风格统一CREATE TABLE visitor ( id INT NOT NULL AUTO_INCREMENT COMMENT 访客登记ID, house_id INT NOT NULL COMMENT 拜访房屋ID关联house表, visitor_name VARCHAR(50) NOT NULL COMMENT 访客姓名, phone VARCHAR(20) DEFAULT NULL COMMENT 联系电话, plate_no VARCHAR(20) DEFAULT NULL COMMENT 车牌号可空, visit_reason VARCHAR(255) DEFAULT NULL COMMENT 来访事由, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待进入 1已进入 2已离开, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 登记时间, PRIMARY KEY (id), KEY idx_house_id (house_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT访客登记表;字段设计三个要点house_id外键加索引因为核心查询总是按房屋过滤status用数字状态机而不是枚举字符串与源码里 repair 表保持一致plate_no允许为空因为访客不一定是开车来的强制必填会导致录入反感。这条表建好后在 Navicat 里执行或者追加到源码的property.sql里统一管理。对应实体类新建com.example.property.entity.Visitorpublic class Visitor { public static final int STATUS_WAITING 0; public static final int STATUS_ENTERED 1; public static final int STATUS_LEFT 2; private Integer id; private Integer houseId; private String visitorName; private String phone; private String plateNo; private String visitReason; private Integer status; private Date createTime; private String houseRoomNo; // 联表查询出的房号非数据库字段 // getter / setter 省略 }实体类里我多写了一个houseRoomNo字段它不是 visitor 表的列而是联表查询 house 表带出来的房号。MyBatis 支持查询结果直接映射到这个字段不影响插入操作这在实际列表展示时非常常用。状态常量写在实体类里业务层引用时写Visitor.STATUS_WAITING比写魔法数字 0 可读性好得多。4.2 Mapper 接口与 XML写法边界与联表查询Mapper 接口放在com.example.property.mapper包下和源码里的 RepairMapper 放一起。接口定义了两个方法列表查询带条件插入登记记录public interface VisitorMapper { ListVisitor selectVisitorList(Param(houseId) Integer houseId, Param(visitorName) String visitorName); int insertVisitor(Visitor visitor); }XML 写在src/main/resources/mapper/VisitorMapper.xml注意mybatis.mapper-locations配置的是classpath:mapper/*.xml所以文件名和后缀不能改。核心查询是联表?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.property.mapper.VisitorMapper select idselectVisitorList resultTypecom.example.property.entity.Visitor SELECT v.id, v.house_id, v.visitor_name, v.phone, v.plate_no, v.visit_reason, v.status, v.create_time, h.room_no AS houseRoomNo FROM visitor v LEFT JOIN house h ON v.house_id h.id where if testhouseId ! null AND v.house_id #{houseId} /if if testvisitorName ! null and visitorName ! AND v.visitor_name LIKE CONCAT(%, #{visitorName}, %) /if /where ORDER BY v.create_time DESC /select insert idinsertVisitor useGeneratedKeystrue keyPropertyid INSERT INTO visitor (house_id, visitor_name, phone, plate_no, visit_reason, status, create_time) VALUES (#{houseId}, #{visitorName}, #{phone}, #{plateNo}, #{visitReason}, #{status}, NOW()) /insert /mapper这个 XML 里有两个边界点值得说。第一where标签会自动去掉第一个if条件前面的 AND所以拼条件时不要在if内部 SQL 前写 WHERE这是 MyBatis 动态 SQL 用法的常见误区。第二LIKE 查询用CONCAT(%, #{visitorName}, %)而不是直接在 XML 里写%${visitorName}%${}是字符串拼接存在 SQL 注入风险#{}是预编译参数毕设里写$被导师看到大概率会被指出安全问题。4.3 Service 与 Controller事务与路由按源码的分层习惯VisitorService 负责业务逻辑VisitorController 负责接收 HTTP 请求。Service 里我演示一个带事务的完整方法处理“登记访客”的完整流程Service public class VisitorService { Autowired private VisitorMapper visitorMapper; Transactional(rollbackFor Exception.class) public boolean registerVisitor(Visitor visitor) { // 默认待进入状态不允许外部指定 visitor.setStatus(Visitor.STATUS_WAITING); return visitorMapper.insertVisitor(visitor) 0; } public ListVisitor queryList(Integer houseId, String visitorName) { return visitorMapper.selectVisitorList(houseId, visitorName); } }Transactional(rollbackFor Exception.class)是事务注解意思是方法内任何异常都会触发回滚。现在registerVisitor只有一次 insert事务看不出价值但如果你后面扩展成“插入访客记录 发送通知给业主”第二条失败时第一条必须撤销这时事务就发挥作用了。答辩时导师如果问“你怎么保证数据一致性”指着这个方法讲就行。注意rollbackFor一定要写默认 Spring 事务只对 RuntimeException 回滚对自定义异常不回滚这是很多老手都会踩的细节。Controller 层对应两个接口RestController RequestMapping(/visitor) public class VisitorController { Autowired private VisitorService visitorService; GetMapping(/list) public Result list(RequestParam(required false) Integer houseId, RequestParam(required false) String visitorName) { return Result.ok(visitorService.queryList(houseId, visitorName)); } PostMapping(/add) public Result add(RequestBody Visitor visitor) { return visitorService.registerVisitor(visitor) ? Result.ok() : Result.error(登记失败); } }RequestParam(required false)表示查询参数可传可不传不传就查全部RequestBody接收前端 POST 过来的 JSON 对象字段名和实体属性对应。Result是源码里统一封装好的返回对象结构一般是{code, message, data}前端拿到后根据 code 判断成功失败。新增接口后启动项目访问/visitor/list应该能看到空的 JSON 数据数组。4.4 前端联动页面与接口对接后端接口跑通后需要在前端管理后台加一个访客登记页面。源码的前端是 Thymeleaf 模板页面模板放src/main/resources/templates我这里给一个最简可用的页面片段表达清楚对接思路就够了!DOCTYPE html html xmlns:thhttp://www.thymeleaf.org head title访客登记/title script srchttps://cdn.jsdelivr.net/npm/jquery3.6.0/dist/jquery.min.js/script /head body input typetext idvisitorName placeholder访客姓名 button onclickloadData()查询/button table idvisitorTable border1 thead tr th访客姓名/th th房号/th th来访事由/th th状态/th /tr /thead tbody/tbody /table script function loadData() { var name $(#visitorName).val(); $.get(/visitor/list, { visitorName: name }, function (res) { var rows ; $.each(res.data, function (i, item) { var statusText item.status 0 ? 待进入 : item.status 1 ? 已进入 : 已离开; rows trtd item.visitorName /td td item.houseRoomNo /td td item.visitReason /td td statusText /td/tr; }); $(#visitorTable tbody).html(rows); }); } loadData(); /script /body /html这个页面里关键调试点在接口地址。源码配置了context-path: /property所以完整请求地址是/property/visitor/list我在示例里写的是/visitor/list实际运行时如果 404八成是漏了上下文路径。解决办法有两个一是在页面里写死/property/visitor/list二是用 Thymeleaf 的[[{/visitor/list}]]动态拼接后者更规范升级部署时不用改代码。状态字段映射成中文在页面模板里用三元表达式搞定不要在后端拼好再返回前端展示逻辑就该留在前端。5. 避坑与常见问题跑不起来先查这五个位置这一章是血泪经验合集。我在拆这套源码和帮人调试的过程中遇到的最多的问题基本集中在这五个位置。每一条都按“现象 → 原因 → 解决”的方式给你讲清楚排查时照着顺序来能省小半天时间。5.1 MySQL 8 驱动、时区与 SSL 校验现象项目启动或首次访问数据库时报错日志里出现Loading class com.mysql.jdbc.Driver. This is deprecated.或The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。原因MySQL 8.x 把 JDBC 驱动类从com.mysql.jdbc.Driver改成了com.mysql.cj.jdbc.Driver旧驱动类虽然保留兼容但会告警部分 8.0.x 版本直接报错。同时 MySQL 8 要求客户端显式指定时区否则拿不到系统时区就抛异常。还有 SSL 默认开启本地连接没配证书也会告警甚至失败。解决把application.yml里的driver-class-name改成com.mysql.cj.jdbc.Driverurl 里补上serverTimezoneAsia/Shanghai和useSSLfalse。如果 MySQL 是 5.7驱动类可以保持不变但建议统一用新驱动类兼容两种版本。注意url 里不要用serverTimezoneGMT8这种写法“东八区”和“Asia/Shanghai”在有夏令时的地区处理结果不同写Asia/Shanghai最稳。5.2 端口占用与上下文路径导致前端 404现象启动时控制台报Web server failed to start. Port 8080 was already in use.或者启动成功但访问http://localhost:8080/打开的是别的页面登录后跳转全是 404。原因8080 是开发机高频端口被 Nginx、其他 Spring Boot 实例或某个后台服务占用。404 则是context-path配置不一致导致的源码配了/property但前端页面里静态资源引用写的是相对路径漏掉了前缀。解决端口占用就改server.port比如8081改完访问地址同步换成http://localhost:8081/property/。如果是 404先看浏览器地址栏确认 URL 里有没有/property再看 Network 面板请求的完整路径缺前缀就统一在模板里加。我习惯的做法是把context-path直接去掉注释掉全部用根路径访问本地开发少一层前缀少一层错。但如果论文截图里已经写了带前缀的地址就别改保持和文档一致。5.3 MyBatis XML 中特殊字符与 resultMap 不对应现象列表查询接口报bad SQL grammar或者 SQL 执行成功但返回结果里某个字段一直是 null。原因XML 里写 SQL 时用了或比如WHERE create_time 2024-01-01XML 解析器把当成标签开始符导致 SQL 语法错误。字段 null 则是因为表里是house_id下划线命名实体属性是houseId驼峰命名如果没开启驼峰映射且没写 resultMapMyBatis 映射不上就返回 null。解决比较符号用转义字符写lt;写gt;更长的比较逻辑用 CDATA 包裹。字段映射问题推荐直接开启全局驼峰映射map-underscore-to-camel-case: true比每个 XML 写 resultMap 省事这也是我推荐在 3.2 节理由里保留这项配置的原因。开启后仍然为 null 的话再去检查实体类字段名是不是拼写不一致。5.4 中文乱码与 Thymeleaf 静态资源 404现象页面上中文全部变成??或插入的数据在数据库里显示乱码另一种是页面样式丢失、JS 文件 404。原因乱码有两条链路。数据库连接串没带characterEncodingutf8的话Java 到 MySQL 的传输用默认字符集中文必乱建表时如果用了DEFAULT CHARSETutf8而不是utf8mb4部分特殊字符会存不进去。静态资源 404 是 Spring Security 或拦截器把/css/**、/js/**这类路径拦掉了常见于源码里配了登录拦截器但白名单漏了静态资源。解决连接串补characterEncodingutf8建库建表统一utf8mb4。IDEA 里还要检查 File → Settings → Editor → File Encodings三处编码全部改成 UTF-8否则源码文件本身可能以乱码编译。静态资源 404 就去 WebMvc 配置类里看addResourceHandlers确认/static/**映射到classpath:/static/如果有拦截器白名单加上/css/**,/js/**,/img/**。5.5 依赖版本冲突Spring Boot 2.x 与 3.x 分不清楚现象IDEA 新建项目或从网上下载脚手架后源码一导入就报红错误集中在javax.servlet找不到、SpringApplication.run无法解析或者 MyBatis 的Mapper注解无效。原因Spring Boot 3.x 从 JavaEE 规范切到了 JakartaEE包名从javax.*全部改成jakarta.*同时底层要求 JDK 17。这套源码基于 Spring Boot 2.7用的是javax.*如果把 parent 版本改成 3.x或者用了 Spring Initializr 默认生成的 3.x 骨架两套包名混在一起就编译不过。MyBatis 官方 starter 在 Spring Boot 3.x 下也要用 3.0 版本2.3.2 对不上。解决以源码 pom 的 parent 版本为准不要手贱升级。如果一定要用 Spring Boot 3.x全局替换javax.servlet→jakarta.servlet升级mybatis-spring-boot-starter到3.0.3JDK 换到 17并检查所有依赖有没有不兼容 Spring Boot 3 的第三方库。这个工程量不大但属于“做一次知道值不值不想折腾就别动”的操作。6. 答辩演示技巧用 Spring Boot Admin 把运行状态放在大屏上功能跑通了模块也加了最后一步是让答辩现场的效果拉满。很多毕设演示是打开浏览器点几个页面就结束导师看完记不住细节。我建议花一小时接入 Spring Boot Admin把你系统的运行状态可视化这是“监控都有哪些需求和功能”最好的实战回答。在 pom.xml 里加两个依赖一个作为监控端一个作为被监控端dependency groupIdde.codecentric/groupId artifactIdspring-boot-admin-starter-server/artifactId version2.7.5/version /dependency dependency groupIdde.codecentric/groupId artifactIdspring-boot-admin-starter-client/artifactId version2.7.5/version /dependency被监控端在 application.yml 里配置 Admin 服务地址spring: boot: admin: client: url: http://localhost:8080/admin启动后访问http://localhost:8080/admin你能看到当前应用的堆内存使用曲线、GC 次数、线程数量以及所有对外暴露的 HTTP 接口列表。答辩时把这块打开指着堆内存曲线说“系统启动后内存稳定在 X 百 MB没有明显泄漏”比口头说“我的系统很稳定”有说服力得多。再点开接口列表能直接展示你新增的/visitor/list和/visitor/add接口证明访客登记模块是真实注册在 Spring MVC 体系里的。我还习惯在演示前做一次“清场操作”清空数据库业务数据只留初始账号关闭浏览器无关标签页把 IDEA 日志窗口调小只留 Spring Boot 启动日志在终端里先mvn clean package -DskipTests打一次包确保无报错。这些琐事不影响功能但直接影响现场节奏。做毕设这几年我总结出一条经验源码跑通只是及格线能让导师在十分钟内看到“你会分层、会建表、会排错、会扩展”才是高分的关键。从那以后我每次拿到一套新的 Spring Boot 毕设源码第一件事不是读业务代码而是先把配置摸一遍、把一个模块跑通、再加一个自己的功能三步走完心里就有底了。希望这套流程对你也有用祝答辩顺利。本文还有配套的精品资源点击获取