Spring Boot在线房屋出租系统毕设实战：从设计到部署全解析-北京尧图网络

做毕设选方向时我最后定在了基于Spring Boot的在线房屋出租系统。这个题目看起来常见但房屋出租天然包含用户、房源、订单、预约几条核心业务线既能覆盖常规的增删改查又能往权限控制、状态流转、文件上传、条件检索这些方向做深度拓展不管是应付答辩还是往简历上写都有东西可讲。这套系统我完整从零写了一遍从数据库设计到前后端联调再到打包部署中间踩了不少坑。今天把整个设计思路和落地过程整理出来给正在选型、开工或者已经写到一半的同学做一个完整参考。1. 项目定位与需求分析1.1 毕设选题的现实考量选“在线房屋出租系统”作为毕设题目理由其实很实在。房屋出租这个场景足够生活化不需要额外解释业务背景评委老师一看就懂。找房的人需要快速浏览房源、按价格和区域筛选、预约看房房东需要发布房源、管理上架下架、处理租客的预约和订单平台管理员负责审核房源、统计运营数据。这个三角色模型正好把系统分成了前台租房端和后台管理端功能边界非常清晰。更关键的是这个项目的技术点能刚好卡在“有难度但不至于失控”的位置上。纯CRUD显得单薄高并发分布式又不切实际。房屋出租系统只要把搜索筛选、预约流程、订单状态机、图片上传这几块做好技术上就已经能撑起一篇不错的毕设论文了。如果还能加上JWT登录鉴权、逻辑删除、数据统计那在答辩时谈技术亮点就有了充足素材。我最终的项目选型是前后端分离架构后端Spring Boot MyBatis-Plus MySQL前端Vue 3 Element Plus Axios。源码工程编号51207整体结构是标准的前后端分离目录开发时用Vite代理解决跨域部署时后端打包成jar包前端打包成静态资源交给Nginx托管。1.2 系统业务角色与核心流程系统一共有三类角色权限完全隔离登录后进入的页面也完全不同。租客用户注册登录、浏览房源、按条件筛选、收藏房源、在线预约看房、提交租赁订单。房东用户房源管理发布、编辑、上架、下架、查看预约请求并确认、处理订单签约和退租。平台管理员用户管理、房源审核决定是否允许上架、订单监督、租金成交数据统计、公告管理。三种角色的核心业务闭环是这样流转的房东发布房源 - 管理员审核通过 - 房源自动上架展示 - 租客搜索筛选并预约看房 - 房东确认预约 - 租客下单并支付定金模拟 - 系统生成正式租赁订单 - 到期退租。这个闭环把订单状态和房源状态绑在了一起比如房源被下单后不能再被其他人重复下单状态要自动变成“已租出”退租后又回到“上架中”。这一套状态联动是整个系统的业务核心也是答辩时最容易展现设计思路的地方。1.3 功能模块表模块功能点用户模块注册、登录、角色区分、个人信息维护房源模块房源发布、图片上传、房源编辑、上下架、审核检索模块关键词搜索、区域筛选、价格区间、户型筛选、租赁方式筛选预约模块提交看房预约、房东确认/取消、状态跟踪订单模块创建租赁订单、模拟支付、签约生效、退租关闭收藏模块收藏/取消收藏、收藏列表管理模块用户管理、房源审核、订单监管、数据统计模块列表看着多但每个模块并没有做得特别复杂都是在围绕“房子租出去”这条主链服务。2. 技术架构与核心设计2.1 为什么是Spring Boot而不是SSM或Spring Cloud一开始我也纠结过要不要用SSH那套老框架后来直接否了。Spring Boot最核心的价值就是自动配置和内置服务器让人能把精力放在业务逻辑上而不是XML配置上。对于一个毕设项目来说Spring Boot能大大缩短环境搭建时间出问题的概率也低。相比之下SSM框架光是配Spring和MyBatis的XML就要半天Spring Cloud对毕设来说又明显超纲微服务拆分、注册中心这些概念在单机演示环境下毫无意义。我使用的是Spring Boot 2.7.18配合JDK 8。这个版本组合在2024年依然是最稳妥的网上资料多遇到问题搜索时能找到大量现成答案。如果非要用Spring Boot 3.x那JDK版本必须升到17某些老版本的第三方依赖也会出现兼容性问题没必要给自己加风险。2.2 后端整体分层结构后端工程采用经典的三层架构在我在源码工程中是这样组织的com.house.rent ├── controller // 接口层接收请求参数并返回R对象 ├── service // 业务层处理核心逻辑 │ └── impl ├── mapper // 数据访问层继承BaseMapper ├── entity // 数据库实体类 ├── dto // 请求参数对象 ├── vo // 响应结果对象 ├── config // 配置类跨域、拦截器、资源映射、MyBatis-Plus分页 ├── common // 通用类R统一返回体、异常处理、常量 └── utils // 工具类JWT工具、文件上传工具controller层很薄只负责接收参数和调用service不允许直接写SQL或业务逻辑。service层承载核心业务比如下单时校验房源状态、生成订单号、更新房源状态这些都是事务方法需要加Transactional。mapper层就继承MyBatis-Plus的BaseMapper复杂查询用LambdaQueryWrapper构造特殊统计SQL就自己写注解SQL或XML。2.3 数据库表设计数据库设计是这套系统的地基我踩过最大的坑就是一开始把字段类型和状态字段设计得太随意导致后面前端显示和统计查询到处出问题。最后的表结构包含7张核心表。用户表 sys_user字段类型说明idbigint主键IDusernamevarchar(50)登录用户名唯一passwordvarchar(100)BCrypt加密后的密码real_namevarchar(30)真实姓名phonevarchar(20)手机号avatarvarchar(255)头像URLroletinyint1-租客 2-房东 3-管理员statustinyint1-正常 0-禁用create_timedatetime注册时间密码必须加密存储我在项目里用了Spring Security Crypto模块的BCryptPasswordEncoder不需要引入全套Spring Security拿过来就能用。明文密码入库这种事在答辩时被问到会很尴尬。房源表 house_info字段类型说明idbigint主键house_novarchar(50)房源编号唯一titlevarchar(100)房源标题descriptiontext房源描述pricedecimal(10,2)月租金areadecimal(10,2)房屋面积house_typevarchar(20)户型如两室一厅orientationvarchar(10)朝向floorvarchar(20)楼层信息addressvarchar(255)详细地址districtvarchar(50)所在区域rent_typetinyint1-整租 2-合租imagesvarchar(2000)图片URL逗号分隔或JSONowner_idbigint房东用户IDstatustinyint0-待审核 1-上架中 2-已下架 3-已租出browse_countint浏览数create_timedatetime发布时间房源状态字段用数字枚举而不是字符串理由很简单数字比较效率高、存储省空间、前端映射也方便。我在VO层统一做数值到文本的转换比如0转“待审核”1转“上架中”这样前端拿到的直接是可读文案。预约表 appointment、订单表 lease_order、收藏表 favorite 的设计核心是状态字段预约状态0-待确认 1-已确认 2-已取消 3-已完成订单状态0-待支付 1-生效中 2-已退租 3-已取消支付状态0-未支付 1-已支付订单号我用时间戳加随机数生成格式如“LO202405201530001234”保证唯一还方便用户和管理员快速识别。3. 核心功能模块详细拆解3.1 用户注册、登录与JWT鉴权登录模块如果只做一个简单的Session存取那答辩时基本没有亮点可讲。我在项目里用了JWT方案后端登录成功后签发一个token返回给前端前端把它存在localStorage里每次请求通过Authorization请求头带过来。后端写了一个拦截器拦截除登录、注册、房源列表、房源详情以外的所有接口校验token是否有效。JWT的核心配置就几行jwt: secret: house-rent-secret-key-2024 expire: 86400000拦截器里校验token时把解析出来的userId和role放进ThreadLocal或Request attribute里后续service层就能直接拿到当前登录人信息不需要每次从数据库查。要注意的是JWT的secret不要写得太短否则容易被暴力破解项目里这个只是演示用实际生产必须用足够长的随机字符串。密码加密的逻辑很简单String rawPassword 123456; String encoded new BCryptPasswordEncoder().encode(rawPassword); // 校验时 boolean matches new BCryptPasswordEncoder().matches(rawPassword, encoded);这个方案的好处在于即使数据库泄露攻击者拿到的也是不可逆的加密串无法反推出原始密码。答辩时老师如果问“密码安全怎么做的”这已经是一个合格的回答。3.2 房源发布与图片上传房东发布房源是这个系统里交互最重的功能。前端表单包括标题、描述、价格、面积、户型、朝向、区域、详细地址、租赁方式、房源图片一张表单提交后后端需要同时保存房源信息和图片URL。图片上传我采用本地磁盘存储方案在application.yml里配置上传路径file: upload-path: D:/house-rent/upload/ access-path: /images/**后端写一个FileUploadConfig通过WebMvcConfigurer把本地上传目录映射成虚拟访问路径。这样前端img标签可以直接使用/images/xxx.jpg访问图片不需要经过接口转发。上传接口接收MultipartFile按日期加UUID生成文件名避免重名覆盖。这里有个坑要注意Spring Boot默认上传文件大小限制是1MB随便一张手机照片就超了。必须在配置里放开spring: servlet: multipart: max-file-size: 10MB max-request-size: 20MB不配这个前端上传图片时总会莫名其妙报文件大小超限而且错误信息还不直观排查起来浪费时间。3.3 房源搜索与多条件筛选搜索筛选是前台的核心功能我做成了动态条件构造。用户可以在前端同时勾选区域、价格区间、户型、租赁方式还能输入标题关键词。这些条件全部通过GET请求参数传递后端用LambdaQueryWrapper动态拼接SQL条件。核心查询代码大致是这个形态LambdaQueryWrapperHouseInfo wrapper Wrappers.lambdaQuery(); wrapper.eq(HouseInfo::getStatus, 1); // 只查上架中 if (StringUtils.hasText(keyword)) { wrapper.like(HouseInfo::getTitle, keyword); } if (StringUtils.hasText(district)) { wrapper.eq(HouseInfo::getDistrict, district); } if (StringUtils.hasText(houseType)) { wrapper.eq(HouseInfo::getHouseType, houseType); } if (rentType ! null) { wrapper.eq(HouseInfo::getRentType, rentType); } if (minPrice ! null) { wrapper.ge(HouseInfo::getPrice, minPrice); } if (maxPrice ! null) { wrapper.le(HouseInfo::getPrice, maxPrice); } wrapper.orderByDesc(HouseInfo::getCreateTime);用LambdaQueryWrapper的好处是不用手写SQL而且字段名是强类型引用编译期就能发现字段名拼写错误这种查询在毕设项目里比写XML更不容易出bug。分页就交给MyBatis-Plus的Page对象PageHouseInfo page new Page(pageNum, pageSize);响应中返回总条数、总页数、当前页数据前端分页组件直接绑定即可。3.4 预约看房与租赁订单状态流转预约流程看起来只是插入一条记录其实要考虑状态联动。租客提交预约时系统要校验房源是否存在且处于“上架中”状态同时要检查当前用户是否已经预约过这套房源避免重复提交。房东端看到预约请求后可以选择确认或取消确认后租客就会收到状态更新同时系统自动生成一条待支付的租赁订单。订单创建这个操作非常典型涉及多张表的联动我用一个事务方法搞定Transactional public LeaseOrder createOrder(CreateOrderDTO dto) { // 1. 校验房源状态必须是上架中 HouseInfo house houseMapper.selectById(dto.getHouseId()); if (house null || house.getStatus() ! 1) { throw new BusinessException(房源不存在或未上架); } // 2. 计算租金总额 BigDecimal total house.getPrice().multiply(new BigDecimal(dto.getMonths())); // 3. 生成订单号 String orderNo generateOrderNo(); // 4. 创建订单记录 LeaseOrder order new LeaseOrder(); // ... 设置订单字段 leaseOrderMapper.insert(order); // 5. 更新房源状态为已租出 house.setStatus(3); houseMapper.updateById(house); return order; }注意Transactional在这里为什么重要如果订单插入成功但房源状态更新失败事务会回滚不会出现“订单存在但房子还能被其他人租”这种数据不一致的情况。这个设计在答辩时非常加分建议作为重点讲给评委听。订单状态流转我专门画了一张状态表不是流程图是一个简洁的文字描述创建订单待支付 - 租客点“模拟支付” - 已支付生效中生效中 - 租客申请退租 / 到期自动退租 - 已退租房源重新上架待支付超时或租客取消 - 已取消房源回到上架中每变更一次订单状态都要同步更新对应房源的状态。这个一致性约束是系统最关键的逻辑评审老师大概率会围绕它提问。4. 关键实操环节与部署配置4.1 环境准备与工程初始化后端开发环境我用了IDEA Maven 3.8 JDK 8 MySQL 5.7或8.0均可前端用VS Code Node 16 npm。项目初始化不需要从零敲代码直接在Spring Initializr选择Spring Boot 2.7.18勾选Web、MySQL Driver、MyBatis-Plus、Lombok依赖即可。如果你拿到的源码里没有初始依赖手动在pom.xml补上这几块核心依赖dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt/artifactId version0.9.1/version /dependency dependency groupIdorg.springframework.security/groupId artifactIdspring-security-crypto/artifactId /dependency dependency groupIdcn.hutool/groupId artifactIdhutool-all/artifactId version5.8.22/version /dependencyHutool这个工具包强烈建议加上生成随机验证码、日期格式化、ID生成、文件类型判断都有现成方法能省下很多重复代码。毕设项目追求的不一定是代码行数而是逻辑清晰能用成熟工具解决的问题不要自己造轮子。4.2 数据库初始化脚本源码里自带SQL脚本直接导入MySQL即可。如果没有脚本按前面章节的表结构建表注意几点所有表的主键用bigint自增不要用varchar当主键。金额字段必须用decimal不要用double或float不然算钱时出现0.10.2不等于0.3的问题会很尴尬。创建时间字段统一叫create_time更新时间叫update_time不要有的表叫createDate有的叫gmtCreate统一命名能少很多无谓的查错。状态字段统一加注释说明枚举含义不然半年后自己都看不懂0和1分别代表什么。4.3 application.yml 核心配置解析整个后端最关键的就是这个配置文件很多同学项目起不来、图片访问不了、时间格式不对都是配置问题server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/house_rent?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: root servlet: multipart: max-file-size: 10MB max-request-size: 20MB jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0datasource的URL里serverTimezoneAsia/Shanghai非常重要。数据库连接时如果时区不匹配查出来的时间会比实际时间少8小时。这个坑我踩过后来排查了很久才发现是时区问题。MyBatis-Plus的逻辑删除配置也在这里配好。给需要保留痕迹的表加上deleted字段执行delete操作时就会自动变成update这比物理删除更安全也方便以后做数据恢复和分析。4.4 前端Vue渐进配置与代理前端使用Vue 3 Vite Element Plus Axios。页面结构大致是登录注册页、首页房源列表、房源详情页、个人中心我的预约/我的订单/我的收藏、房东后台、管理后台。Vite开发服务器需要配置代理把前端的/api请求转发到后端8080端口export default defineConfig({ server: { port: 3000, proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } })Axios统一封装请求在每个请求的拦截器里读取localStorage中的token并添加到请求头axios.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers[Authorization] token } return config })后端接口路径统一带/api前缀这样代理和部署时的路径都很好配。4.5 项目打包与部署后端打包非常简单在Maven面板执行package命令或者命令行运行mvn clean package -DskipTests打包后在target目录生成一个可执行jar包服务器上安装JDK后直接运行java -jar house-rent-0.0.1.jar前端打包npm run build打包生成的dist目录就是纯静态文件交给Nginx托管配置一个localtion指向dist目录。如果是单台服务器演示还可以让Nginx把/api请求反向代理到8080端口实现前后端一体访问。如果只是本地跑一版用于演示和答辩完全可以跳过Nginx后端跑起来后前端用开发模式npm run dev通过Vite代理请求后端接口。这个方案最省事适合答辩现场的备用演示方案。5. 常见问题与避坑实录5.1 高频Bug排查清单现象原因解决方案前端接口请求后端报跨域前后端端口不一致缺少跨域配置后端加CorsFilter或前端配置Vite代理图片上传后前端打不开上传目录没有做虚拟路径映射配置资源映射/images/**指向本地上传目录查询时间比实际少8小时数据源URL缺少serverTimezone连接串加serverTimezoneAsia/ShanghaiJackson配置GMT8分页查询total为0没配置MyBatis-Plus分页插件添加MybatisPlusInterceptor并注册PaginationInnerInterceptor前端拿到的时间是数组Jackson序列化LocalDateTime问题统一用Date类型或引入jsr310模块token过期后接口报401拦截器统一处理全局异常捕获后返回特定错误码前端做跳转删除房源报外键约束错误关联表存在引用改用逻辑删除或先清理关联的预约和订单上传大图报错上传大小超限配置multipart大小上限其中跨域问题是最常见也最容易被忽视的。前端跑在3000端口后端跑在8080端口直接请求必然会有跨域限制。我的做法是后端统一加了一个CorsFilter允许所有来源前端开发时再用Vite代理双保险。5.2 为什么数据库时间格式显示异常之前提到过时区问题这里详细解释一下。MySQL连接的serverTimezone参数如果不设置默认使用的时区可能和本地时区不一致数据库里存的是UTC时间查询出来转换后就差了8小时。Spring Boot在返回JSON时Jackson序列化又把时间对象格式化成utc前端显示自然就错乱了。最稳妥的做法是三管齐下数据源URL加serverTimezoneAsia/ShanghaiSpring Boot配置里设置jackson的time-zone为GMT8MySQL建表时时间字段直接定义成datetime并交给后端处理只要这三处保持一致时间显示就不会出幺蛾子。5.3 代码规范与命名建议毕设代码虽然不需要达到生产级标准但命名规范做得好不好答辩老师扫一眼就知道态度。我的建议是类名用名词方法名用动词开头。比如HouseService、createOrder()、deleteAppointment()。接口返回统一用R对象结构为code、message、data三个字段。所有接口都遵循这个格式前端处理起来非常一致。controller方法的映射路径用复数资源名如/api/houses、/api/orders、/api/appointments。常量不要散落各处写魔法值统一放到常量类中管理。比如房源状态的1和3定义成公共常量后代码可读性会高很多。service方法必须写注释说明业务规则。比如创建订单方法要标明“校验房源上架中、计算总额、联动更新房源状态”这几个步骤。这些细节不会直接让系统跑得更快但会让代码看起来更像一个规范的工程而不是应付交差的demo。5.4 答辩高频问题准备清单答辩的时候老师最喜欢问的几个方向我把题库和参考答案都整理出来了。问为什么选择Spring Boot答Spring Boot的自动配置机制降低了项目搭建成本内置Tomcat让部署更简单开发时不用再像SSM那样写大量的XML配置。对于房屋出租这种业务边界清晰的系统Spring Boot能让我把主要精力放在核心业务逻辑上。问数据库表之间的关系是怎样的答用户和房源是一对多一个房东可以发布多套房源用户和预约是一对多一个租客可以预约多套房源预约和房源是多对一订单和房源和用户分别多对一。核心是房源表作为中间业务的载体订单和预约都通过外键关联到用户ID和房源ID。问如何保证订单数据的一致性答创建订单的操作使用Transactional事务注解Spring会在运行时把插入订单和更新房源状态放到同一个数据库事务中。任何一步失败整个事务回滚不会出现订单存在但房源状态没更新的情况。同时在下单前做了状态校验只有上架中的房源才能被下单。问系统如何防止SQL注入答项目使用MyBatis-Plus的LambdaQueryWrapper构造查询条件参数通过预编译绑定不会直接拼接SQL。对于自定义SQL也统一使用#{}占位符。这样从框架层面规避了SQL注入风险。问密码为什么用BCrypt加密答BCrypt算法内置随机盐相同密码每次生成的密文都不同而且算法本身设计为慢速哈希能有效抵抗彩虹表攻击和暴力破解。相比MD5直接加密安全性高很多。6. 项目延展方向与后续优化空间这套系统作为毕设自然没有问题但如果想在工作面试时把项目作为谈资还有几个方向可以继续优化。第一是引入Redis。目前预约时间和房源数据都是直接查数据库如果数据量上来热点房源的高频浏览会对数据库产生压力。可以把房源详情缓存到Redis设置过期时间预约状态变更时先更新数据库再删除缓存保证数据最终一致。第二是消息通知。目前的“房东确认预约”“订单创建成功”都是靠用户在页面上刷新才能看到。可以引入WebSocket或者使用Spring的事件机制在这个动作发生时主动推送通知让用户体验更好。第三是支付模块。现在模拟支付就是点一下按钮把支付状态改成已支付。如果要接近真实业务可以接入沙箱环境对接支付回调接口这里涉及签名验证和回调幂等处理含金量比模拟支付高不少。第四是数据可视化。管理后台目前只有表格和简单统计可以引入ECharts把每月成交订单量、热门区域房源数、租金价格分布做成折线图、柱状图和饼图一眼就能看懂运营情况。这个在答辩现场演示效果很好。我做这套系统最有价值的心得是不要追求技术栈的新和全而是把一个闭环业务真正跑通把每个关键决策都讲得出理由。Spring Boot在线房屋出租系统看起来是个常见的题目但只要把状态联动、事务一致性、权限控制、安全防护这些点讲透它完全有潜力成为一份高分毕设也能为后续的项目经验积累打下扎实基础。如果你们也在做类似的系统欢迎按这篇文章的思路试着重构一遍或者在做完后想一想那些延展方向体验会很不一样。

Spring Boot在线房屋出租系统毕设实战：从设计到部署全解析

相关推荐

dsh-skill-mcp-panel 排查三连：命令、MCP连接、面板缺失

需求缺陷闭环：2026年缺陷管理工具选型指南

大模型评测工具升级后必查的7个风险点：从Harness 0.2看评测一致性保障

更多资讯

数据结构——顺序表细致讲解

小白程序员必看：字节新岗位AI Agent开发火爆，如何精准入行？

AI中控与直播伴侣的联动配置和排查思路

用AI搭建一人调研团队：主编+三个AI工种+两本手册的实操框架

低代码平台岗位管理实战：用户角色权限体系的设计与落地

五大湖生态-经济耦合建模：Python实现水位、污染与渔业协同仿真

今日更新

Susi AI API实战指南：susi_alexa_skill如何用Node.js调用chat.json获取智能回答

换新电脑了？KeyStats 恢复码数据找回完全指南，端到端加密统计一键重建

重建二叉树：由前序与中序遍历序列还原二叉树的原理与 Java 实现（YCBlogs 剑指 Offer 精讲）

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？