做毕业设计选型的时候最怕的不是不会写代码而是不知道写什么、写到什么程度能过、出了问题怎么收场。这篇我直接用“基于Spring Boot的房产交易系统”这个题目展开把设计思路、功能拆解、核心实现、调试部署到论文整理一条线讲清楚。这篇文章里提到的做法和代码基本都是我在真实项目中验证过、也被学生实打实用来交毕设的方案。你不一定要照搬但跟着这条线走能少走很多弯路。1. 项目整体设计与技术选型思路1.1 为什么是Spring Boot而不是SSH或SSM先回答一个最常被问的问题这题目挂的是springboot为什么不是SSHSpring MVC Hibernate或者传统SSMSpring Spring MVC MyBatis核心原因有几个。第一Spring Boot把配置大幅简化不再需要一堆XML文件起步快这对毕设周期来说非常关键。做一个房产交易系统业务量级本身不大没必要在框架配置上浪费精力。第二Spring Boot内置Tomcat打包后一个jar直接跑部署演示的时候特别省事儿。第三现在企业里新项目基本都走Spring Boot这套体系你写在简历上面试官不会觉得你的技术栈过时。第四网上资料多遇到问题能搜到的解决方案也最多。如果选SSHHibernate的ORM虽然自动建表方便但对SQL控制能力弱后期做复杂查询和报表比如按小区统计成交量会很别扭。SSM里Spring MVC配置繁琐光是web.xml、springmvc.xml、applicationContext.xml这些配置就能劝退一半人。Spring Boot在这个题目里就是“性价比最高”的选择不是说别的框架不能用而是没有必要给自己增加成本。1.2 整体技术栈与前后端结构这个项目的标准技术栈我按“稳妥、够用、好解释”的原则推荐后端Spring Boot 2.7.x不建议一上来就上3.x后面说原因 MyBatis Plus Spring Security可选或者用JWT自己写拦截器 校验框架Validation前端后台管理用Thymeleaf模板 Bootstrap或者用Vue 2 Element UI做前后端分离数据库MySQL 5.7或8.05.7兼容性更好8.0功能强但要注意连接驱动版本文件存储如果涉及户型图、房产证图片、合同附件上传用本地存储即可也可以引入MinIO做对象存储这个在热词里出现了属于加分项构建工具Maven不推荐用Gradle在毕设里折腾具体怎么选前端要看你的真实水平。如果你对原生JS和JQuery不陌生那用Thymeleaf渲染页面最直接整个项目就是一个完整工程调试、打包、部署都简单。如果你前端基础不错愿意折腾那Vue Spring Boot前后端分离更能体现工作量论文也好写。但有一说一多数人做毕设的时间有限前后端分离意味着你要同时维护两套工程联调遇到跨域问题、接口对接问题、打包问题任何一个都能卡你好几天。我的建议是以完成系统的完整功能为主要目标前端手段只是工具不是亮点本身。1.3 系统角色与模块划分房产交易系统不是简单的“挂房源、打电话”这种信息发布网站它要体现的是“交易”两个字。所以我在设计系统时会明确划分三类角色管理员用户管理、房源审核、经纪公司管理、成交数据统计、系统公告经纪人或中介机构发布房源、管理自己的房源上下架、跟进看房记录、提交成交订单、处理客户留言普通客户注册用户浏览房源、搜索筛选房源、预约看房、发起咨询、查看自己的交易订单对应到功能模块就是用户模块、房源模块、预约看房模块、交易订单模块、留言反馈模块、数据统计模块、公告模块、权限管理模块。这里的核心是“房源模块”和“交易订单模块”论文里重点写这两块答辩的时候也能围绕这两块深挖。我不建议再做额外的“资讯新闻模块”或者“友情链接管理”这类凑数功能因为毕设答辩老师基本都会问“这些功能和系统的核心业务有什么关系”。你答不上来反而扣分。系统宁可是功能少而精深也不要功能多而粗糙。2. 核心细节解析与实操要点2.1 数据库表设计一张图说清表关系做房产交易系统数据库设计是第一个硬骨头也是论文里的重头戏。先想清楚表与表之间的关系再动手写SQL能避免后边开发到一半改表结构。我实际用下来比较稳定的表结构至少有下面这些t_user用户表字段包括id、username、password、real_name、phone、email、id_card、user_type管理员/经纪人/客户、status、create_timet_house房源表字段包括id、title、cover_image、images多图用逗号拼接或关联子表、area、room_count、hall_count、bathroom_count、floor、total_floor、build_year、orientation、decoration、rent_or_sale出租/出售、price、unit_price、description、publisher_id、audit_status、status、view_count、create_timet_house_image房源图片表如果不想在房源表里拼接图片就单独拆一张表t_appointment预约看房表字段包括id、house_id、user_id、agent_id、appointment_time、remark、status、create_timet_order交易订单表字段包括id、order_no、house_id、buyer_id、seller_id、agent_id、deal_price、deposit、contract_file、status、create_time、pay_time如果只做出售流程可以忽略租赁部分如果你想同时做出租和出售建议用trade_type区分外键要不要建我的建议是逻辑外键就可以不建物理外键约束。这在企业项目里很常见因为物理外键会影响插入性能和后续分表扩展而且你在删除用户或房源的时候物理外键会一直拦着你。你可以在实体类里用关联查询的方式表示关系论文里说明这是“保持表之间松耦合”的设计即可。2.2 权限控制不是每个页面都要写死判断很多毕业设计在处理权限时喜欢在每个Controller方法里写“if (user.getType() 1) ...”。这是最直接但也是最难维护的方式。每新增一个接口就要重复判断改权限逻辑就得全局搜索替换而且容易漏判给后面留下越权漏洞。更好的做法是用拦截器HandlerInterceptor或Spring Security做统一的权限控制。我习惯的做法是定义一个角色枚举然后自定义注解RequireRole在需要权限的接口上直接加注解。拦截器里统一校验当前登录用户的角色是否匹配。这样代码干净答辩时还能主动解释“这是基于AOP思想的权限设计”比较加分。如果不想引入Spring SecurityJWT配合拦截器是最轻量的方案。登录成功后生成Token前端每次请求带上拦截器解析Token并塞到ThreadLocal里。用户信息在Controller里通过一个BaseController基类的方法直接获取。整套逻辑写下来也不过几百行但系统整体观感会很不一样。2.3 房源审核状态机的处理房产交易系统和普通论坛不同房源信息是有合规审核要求的。所以发布房源不能直接显示到前台必须要有一个“提交审核 - 审核通过/驳回 - 上架”的流程。这个流程看似简单但状态字段的设计要提前想清楚。我在设计时把房源表的audit_status和status分开。audit_status表示审核状态0待审核、1审核通过、2审核驳回、3已下架status表示上下架状态0下架、1上架。为什么分开因为“审核通过但临时下架”和“待审核”是两种完全不同的情况你不能用一个字段表达两个维度。后边写查询条件的时候前台展示是“audit_status1 and status1”后台管理是“audit_status0”逻辑就特别清晰。驳回房源一定要填驳回理由不然用户不知道为什么被拒这是做产品的基本素养。这个理由字段在论文里也可以作为一个小亮点来写“通过驳回原因促进房源信息规范化”。3. 实操过程与核心环节实现3.1 从零搭建工程一步步来的关键操作环境准备阶段建议统一用这版配置JDK 1.8 或 JDK 11不要用JDK 17除非你特别熟悉新特性Maven 3.6.3 或 3.8.xIDEA 2023.x 或 2024.xMySQL 5.7在创建Spring Boot工程的时候用IDEA自带的Spring Initializr。Group填com.exampleArtifact填house-trade或你自己的项目名。依赖选择上基础就勾选Spring Web、MyBatis Framework、MySQL Driver、Validation。如果你用Thymeleaf还要勾上Thymeleaf。不用一次性选完后面在pom.xml里加依赖也行。pom.xml核心依赖大致是这个样子dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency这里需要回答一个热搜词里的问题为什么Spring Boot版本别太高我见过太多人直接用了Spring Boot 3.x结果MyBatis Plus、某些第三方工具的兼容性出问题折腾几天。3.x要求JDK 17而很多学校的机器、学生自己的旧电脑未必装了或者装了但IDEA版本太老识别不了JDK 17。2.7.x是最后一个支持JDK 1.8的大版本生态成熟网上几乎能搜到所有踩坑案例稳妥是第一位的。3.2 后端的核心配置与通用代码application.yml建议这样配置注意数据库密码不要明文写在代码里至少用环境变量占位server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/house_trade?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: ${DB_USERNAME:root} password: ${DB_PASSWORD:123456} servlet: multipart: max-file-size: 10MB max-request-size: 50MB mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0统一返回体这层不能省。我见过太多人Controller直接返回一个Map或者Object代码写起来乱前后端对接也容易出错。定义一个R或者Result类包含code、message、data三个字段所有接口都走这个包装类。Data public class RT { private int code; private String message; private T data; public static T RT ok(T data) { RT r new R(); r.code 200; r.message success; r.data data; return r; } public static T RT fail(int code, String message) { RT r new R(); r.code code; r.message message; return r; } }另外要统一处理全局异常。用RestControllerAdvice配合ExceptionHandler捕获业务异常、参数校验异常、兜底异常不要在每个Controller里写try-catch。业务代码里只需要在出错的时候抛出RuntimeException的子类比如BizException。统一异常处理的优势一是代码瘦身二是日志好查问题三是返回给前端的错误信息结构统一。这些细节都是论文的加分项。3.3 房源模块的完整实现思路房源模块是整个系统的核心它的增删改查不能是简单的CRUD。我只挑几个关键点说。模糊查询与条件筛选。房产交易的房源查询最常见的是按区域、户型、价格区间、面积区间筛选。如果直接用MyBatis Plus的QueryWrapper条件拼起来会很长。我建议把查询条件封装成一个HouseQueryDTO然后用MyBatis XML写动态SQL或者用LambdaQueryWrapper。实测下来LambdaQueryWrapper的可读性比QueryWrapper好不容易写错字段名。LambdaQueryWrapperHouse wrapper new LambdaQueryWrapper(); wrapper.eq(House::getAuditStatus, 1) .eq(House::getStatus, 1) .eq(StringUtils.hasText(query.getDistrict()), House::getDistrict, query.getDistrict()) .ge(query.getMinPrice() ! null, House::getPrice, query.getMinPrice()) .le(query.getMaxPrice() ! null, House::getPrice, query.getMaxPrice()) .like(StringUtils.hasText(query.getKeyword()), House::getTitle, query.getKeyword()) .orderByDesc(House::getCreateTime);注意一个坑价格区间查询的时候必须同时判断最小值和最大值不为空否则会生成错误的SQL条件。这是代码审查时容易被打回的地方。图片上传。房产房源必须要有图片展示所以文件上传是刚需。上传图片时我建议做一个简单的UploadUtils工具类用于生成新的文件名为UUID加后缀保存到本地磁盘指定目录然后把访问路径存到数据库。本地文件存储的优点是不依赖外网服务适合毕业设计答辩的现场演示环境。如果机房断网那些依赖云存储的图片全挂本地存储反而是最稳的。注意一个细节不要把文件保存在Spring Boot工程的src目录下因为打成jar包之后代码资源在jar内部文件路径会出问题。常见做法是在服务器上定义一个独立目录比如/opt/house-images然后通过WebMvcConfigurer配置虚拟路径映射。这样即使项目重新打包部署图片文件也不会丢。Configuration public class WebMvcConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadPath); } }3.4 交易订单模块状态流转是答辩常客交易订单表是整个系统业务闭环的终点也是答辩老师最可能深挖的模块。我的建议是订单状态设计为0待付款买家提交订单但还没付款1已付款付款成功等待双方确认2已完成交易完成3已取消买家或经纪人取消订单4退款中申请退款后进入的中间状态这个状态机并不复杂但你要在Service层写清楚状态流转方法。比如取消订单只允许待付款状态下的订单取消完成订单只允许已付款状态下的订单完成。这些校验写在每个状态流转方法里能避免出现非法状态跳跃。订单号生成也很讲究不要用数据库自增ID直接展示给用户。我常用的方案是“yyyyMMddHHmmss 4位随机数”用SimpleDateFormat格式化后拼接加上一个全局唯一标识防止高并发重复。毕设不追求分布式ID的复杂方案能用就行。public String generateOrderNo() { String time LocalDateTime.now().format(DateTimeFormatter.ofPattern(yyyyMMddHHmmss)); String random String.format(%04d, ThreadLocalRandom.current().nextInt(10000)); return time random; }3.5 前端页面实现要点Thymeleaf版如果你是Thymeleaf模板方案页面结构大概这样首页/房源列表页展示通过审核且已上架的房源卡片提供区域、价格、户型的筛选栏房源详情页大图展示、基本信息表格、经纪人信息、预约看房入口用户中心个人资料、我的预约、我的订单经纪人后台房源管理发布、编辑、上下架、查看审核状态、预约管理、订单管理管理后台用户列表、房源审核、成交统计、公告发布模板渲染时要注意Thymeleaf里对时间格式的处理直接在页面上用${#temporals.format(house.createTime, yyyy-MM-dd)}。图片路径用img th:src${house.coverImage}。分页推荐用MyBatis Plus的IPage配合PageHelper前端传入页码和页大小返回总记录数和当前页数据。分页组件可以自己写一个简化版的也可以直接用Bootstrap的分页样式拼HTML。如果你选择的是前后端分离方案Vue这边请求数据时统一封装axios实例设置baseURL、超时时间、请求拦截器里带上Token。响应拦截器里判断code非200的统一弹出错误提示并跳转到登录页遇到401时。这些代码企业项目里都是标准写法写出来反而显得你懂工程实践。4. 常见问题与排查技巧实录4.1 Spring Boot启动不了找不到数据源这是最恐怖但也最容易解决的问题。报错一般是“Failed to configure a DataSource”。大多数情况就三种原因第一个application.yml里数据源配置写错了或者数据库没启动。第二个pom.xml里引入了mybatis依赖但没加mysql驱动导致Spring Boot自动配置找不到DataSource。第三个你的配置文件后缀是yaml但写成了yml的格式不对缩进错了导致属性没解析到。这类问题不要慌首先看控制台最下面的几行异常信息注意关键词是“URL”还是“Driver”分别对应连接地址问题还是驱动缺失问题。其次去IDEA的Services窗口看MySQL数据库连接是否正常用自带的Database工具直接测试连接。第三步把mybatis-plus的log-impl配置打开看日志里SQL执行到哪一步。经验之谈八成是配置细节问题剩下两成是端口被占用或jar包冲突。4.2 图片上传之后无法访问图片显示404是高频问题。排查思路先确认上传文件是否真的保存在本地目录了如果保存了但访问不到那大概率是虚拟路径映射没生效。在WebMvcConfig里配置了/upload/**映射之后记得检查一下你的上传路径最后有没有以/结尾否则映射会少了一段路径。比如addResourceLocations(file: D:/images)这里如果路径不带斜杠访问的时候就会拼成file:D:/images2024/...这种错误路径。另外前端显示图片的地址要用相对路径/upload/xxx.jpg不要用http://localhost:8080/upload/xxx.jpg因为换机器部署时域名和端口一变代码里的绝对地址就失效了。4.3 远程调试怎么做题目里写了“远程调试”这是很多学生不知道怎么下手的功能。我解释一下远程调试不是远程桌面而是在你本地IDEA里连接部署在服务器上的Java进程然后像调试本地代码一样打断点、看变量。Spring Boot项目打jar包后启动命令加一段JVM参数java -jar -Xdebug -Xrunjdwp:transportdt_socket,servery,suspendn,address5005 house-trade-0.0.1-SNAPSHOT.jar然后在IDEA里配置一个Remote JVM Debug的运行配置Host填服务器IPPort填5005选择和你工程源码匹配的模块。点Debug按钮就能连上远程进程。注意一个前提本地代码和服务器上运行的jar包必须来自同一个版本否则行号对不上断点位置容易错乱调试结果也没有参考价值。这个功能在帮同学排查线上问题时特别好用能在答辩前把问题“看得清清楚楚”。4.4 答辩前远程部署的注意事项如果答辩现场要用自己的电脑演示那提前准备好环境是必须的。我建议用以下清单做一次完整走查数据库脚本能一键执行包括表结构和初始化数据。不要在答辩场上手动建表本地启动不依赖外网。如果你的页面引用了CDN的Bootstrap或jQuery一旦现场断网页面样式会全部乱掉。建议把静态资源下载到本地或者打包进项目打包用mvn clean package -DskipTests生成的jar包放到一个固定目录启动前确认端口未被占用重要数据备份一份SQL放U盘里。万一现场数据库出问题能马上恢复如果现场只能用学校的机器这台机器上也要装好JDK、MySQL、IDEA或者至少装好JDK并跑起来jar包外部MySQL这几条看起来简单但每年都有学生折在这里。有一回线上评阅一个同学现场演示时页面全是乱的最后发现是学校电脑不能访问外网而他的页面引用了BootCDN的Bootstrap样式。他把静态资源改成本地引入后整个演示顺利多了。这种小问题提前三十分钟检查就能发现可是在那样的场合遇到还是很影响心态。4.5 论文和文档撰写的节奏源码和文档是这套系统的另一半工作量。文档一般包含开题报告、任务书、毕业论文、答辩PPT、演示视频。写论文时建议按以下章节节奏来第一章绪论背景和意义重点写房地产交易信息化的趋势和现存问题第二章相关技术介绍Spring Boot、MyBatis Plus、MySQL、Bootstrap/Vue。这部分别写太长技术介绍不是论文核心第三章需求分析从用户角色出发画用例图、业务流程图、功能需求和非功能需求第四章系统设计总体架构图、功能模块图、数据库ER图和表结构说明。数据库表设计能写好几页这是最容易凑字数也是最体现工作量的部分第五章系统实现按模块写截核心代码片段配上页面截图。重点是房源发布流程和交易订单流程这两块第六章系统测试功能测试用例表、测试结果。可以把远程调试过程中遇到的问题和解决方案写进去显得测试环节有依据论文最忌讳的是“全文都是在介绍Spring Boot和MyBatis”。老师拿到论文想看到的是你的系统设计了什么、怎么设计的、怎么验证设计的。所以我在写系统实现章节时每一小节都会落脚到“这段代码解决了什么问题”而不是把大段代码贴上去不加解释。5. 最后的实操心得我个人带过不少学生完成这个题目最大的体会是这类系统的难度不在某个技术点上而在整体节奏的把控。前三天别急着写代码先把表结构理清楚把页面的跳转流程画出来。表设计一旦定下来后端的CRUD就是体力活页面连接一旦理清楚前端和后端的联调就不会频繁返工。再分享一个小技巧不要把密码直接用明文存数据库。即使毕设要求不高至少用Spring自带的BCryptPasswordEncoder哈希一下。论文里写“采用哈希加盐方式保证用户数据安全”答辩老师会觉得你的安全意识比大多数同学强。有些同学在项目展示里看到别处用了MD5也跟着复制如果论文认真一点这反而是减分项。还有一个细节容易被忽略房源列表里的价格筛选要说明是“每平方米单价”还是“总价”。这个业务定义不清晰前后端做出来可能完全不同。我在实际项目里看到过真实案例前端按总价筛选后端按单价排序结果数据全是错的。业务字段的歧义一定要在设计阶段消灭这比任何框架技巧都重要。这个项目做完你对Spring Boot的整个开发链路——工程搭建、配置管理、ORM映射、拦截器、异常处理、文件上传、打包部署——都会有一个完整的认识。这比单纯跟着视频敲一个电商项目学到的扎实很多因为你是带着业务问题在做设计而不是照着代码在抄功能。后续想扩展的话可以考虑加入消息推送通知房东刷新房源时提醒意向客户、或者引入Redis做热点房源的浏览量缓存这些都是不错的增量方向放在论文的展望部分也非常自然。