尧图网页设计 
简介这份毕业设计资源包围绕《房屋租赁系统的设计与实现》展开面向计算机相关专业需要完成毕设的学生以及希望练习全栈开发与管理系统设计的开发者。项目融合程序设计、管理系统与人工智能三类知识点涵盖前端界面、后端业务逻辑、数据库表结构设计以及权限管理、房源发布查询、预约签约支付退租等租赁流程并涉及智能推荐、自然语言处理、图像识别等应用方向同时兼顾HTTPS、JWT身份验证、缓存与索引优化、Docker部署等工程实践。压缩包共578个文件约24.66MB以png、gif、jpg等图片资源和js、less、css、html等前端文件为主另有jsp、java、jar等后端与依赖文件以及xml、properties等配置项目录结构完整。已有117人学习可作为毕设选题参考与功能模块拆解样本帮助读者理解系统架构、梳理实现思路并对照完善自己的项目。1. 房屋租赁系统从一份毕业设计压缩包到能跑起来的完整项目每年到了毕设季计算机、软件工程、大数据方向的选题里房屋租赁系统几乎是出现频率最高的那一类。原因很直接业务场景人人能理解功能边界清晰数据库表关系不算复杂但又能塞进权限、搜索、订单、支付模拟这些足够写满论文的模块。你拿到一个名为“毕业设计-房屋租赁系统.zip”的压缩包第一反应大概率是里面是什么技术栈能不能直接跑查重能不能过答辩会不会被问穿这篇笔记不讨论某一份具体的源码而是把“房屋租赁系统”这个毕设题目当成一个工程对象来拆。我会按一线做项目的顺序把技术选型、数据库设计、核心功能实现、部署调试、以及答辩前必须自己动手改的地方讲清楚。适合正在做毕设的本科生也适合需要快速交付一个可演示系统的开发者。读完你应该能判断这个方向值不值得投入以及怎么在两周内把它从压缩包变成自己讲得明白的项目。2. 技术选型与项目结构为什么 SpringBoot Vue 是毕设最稳的组合2.1 三种主流技术栈的取舍逻辑房屋租赁系统在毕设语境下技术栈的选择不是追求先进而是追求三件事环境好装、代码好懂、答辩好讲。目前市面上能拿到的完整项目基本集中在三条路线上。第一条是 Java 路线SpringBoot MyBatis MySQL Vue。这是计算机毕业设计和 Java 毕业设计项目里占比最高的组合。后端分层清晰Controller、Service、Mapper 各司其职论文里画架构图、写模块设计都有现成的话术。前端用 Vue Element UI表格、表单、弹窗都是现成组件租赁系统里大量的列表页和审核页可以直接套。第二条是 Python 路线Django 或 Flask MySQL 前端模板。基于 Python 的毕业设计这两年热度上升很快代码量少适合想快速出效果的人。但缺点是如果指导老师偏 Java 体系答辩时容易被追问框架细节而 Django 的 ORM 和 admin 又太自动化反而不好展示“自己写了什么”。第三条是前后端不分离的 JSP 或 Thymeleaf 老式方案。这类项目在网盘里存量很大能跑但代码风格陈旧前端交互差答辩演示时观感吃亏。除非学校明确要求否则不建议选。我的建议很明确如果压缩包里是 SpringBoot Vue直接沿用如果是 JSP考虑把前端换成 Vue后端接口保留改造量可控但项目档次会明显提升。2.2 拿到压缩包后的目录体检解压之后不要急着导入 IDE先做一次结构体检。一个规范的房屋租赁系统项目根目录通常长这样house-rental/ ├── backend/ # 后端工程 │ ├── src/main/java/com/xxx/ │ │ ├── controller/ # 接口层 │ │ ├── service/ # 业务层 │ │ ├── mapper/ # 数据访问层 │ │ ├── entity/ # 实体类 │ │ └── config/ # 配置类 │ ├── src/main/resources/ │ │ ├── application.yml # 数据库、端口配置 │ │ └── mapper/ # MyBatis XML │ └── pom.xml ├── frontend/ # 前端工程 │ ├── src/views/ # 页面 │ ├── src/api/ # 接口封装 │ └── package.json ├── sql/ # 数据库脚本 │ └── house_rental.sql └── README.md体检重点看四个地方sql目录里有没有建表语句和初始数据application.yml里的数据库名、账号密码是什么pom.xml里的 SpringBoot 版本和 JDK 版本package.json里的 Vue 版本和依赖。这四项决定了你能不能在一小时内跑起来。如果缺少 SQL 文件这个包的价值会大打折扣因为表结构往往和实体类强绑定靠猜字段名非常痛苦。2.3 数据库导入与配置修改的最小步骤假设 SQL 文件齐全第一步是建库导数据。用命令行或 Navicat 都可以命令行更稳# 登录 MySQL创建数据库并导入 mysql -u root -p -e CREATE DATABASE house_rental DEFAULT CHARACTER SET utf8mb4; mysql -u root -p house_rental sql/house_rental.sql # 验证表是否导入成功 mysql -u root -p -e USE house_rental; SHOW TABLES;导入后重点确认几张核心表是否存在user用户、house房源、rental_order租赁订单、contract合同、announcement公告。如果表名是t_user、tb_house这种带前缀的说明作者有自己的命名习惯改配置时不要搞混。接着改application.ymlspring: datasource: url: jdbc:mysql://localhost:3306/house_rental?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver server: port: 8080这里有两个高频翻车点。一是serverTimezone不写MySQL 8 会报时区错误二是密码里有特殊字符YAML 里需要加引号。改完先启动后端看到 SpringBoot 的启动日志没有报错再动前端。2.4 前端启动与接口联调前端进入frontend目录先装依赖再启动cd frontend npm install npm run serve如果npm install卡住先换国内镜像源。启动成功后浏览器访问http://localhost:8081默认端口可能是 8080 冲突后自动切换的看终端输出为准。此时前端能打开登录页但登录请求会失败因为后端接口地址可能写死在src/api或vue.config.js的代理里。检查代理配置// vue.config.js module.exports { devServer: { proxy: { /api: { target: http://localhost:8080, // 后端地址 changeOrigin: true, pathRewrite: { ^/api: } } } } }target必须和后端实际端口一致pathRewrite要看后端 Controller 的RequestMapping有没有/api前缀。这两处对不上就会出现“前端能开、登录转圈、控制台 404”的经典现象。联调通了这个项目才算真正活过来。3. 核心业务模块实现房源、订单、合同三张表的联动3.1 房源表设计与多条件搜索接口房屋租赁系统的核心是房源。房源表设计得好不好直接决定后面订单和合同顺不顺。一个够用的house表至少包含这些字段字段名类型说明idbigint主键titlevarchar(100)房源标题addressvarchar(255)详细地址areadecimal(10,2)面积rentdecimal(10,2)月租金house_typevarchar(20)户型如两室一厅statustinyint0待租 1已租 2下架landlord_idbigint房东用户IDcreate_timedatetime发布时间搜索接口是使用频率最高的功能用户会按区域、价格区间、户型组合筛选。后端用 MyBatis 动态 SQL 实现select idsearchHouses resultTypeHouse SELECT * FROM house where if testkeyword ! null and keyword ! AND (title LIKE CONCAT(%, #{keyword}, %) OR address LIKE CONCAT(%, #{keyword}, %)) /if if testminRent ! null AND rent gt; #{minRent} /if if testmaxRent ! null AND rent lt; #{maxRent} /if if testhouseType ! null and houseType ! AND house_type #{houseType} /if AND status 0 /where ORDER BY create_time DESC /selectwhere标签会自动处理第一个AND避免语法错误。status 0写死在 SQL 里保证搜索只返回待租房源。参数说明keyword对应前端搜索框minRent和maxRent对应价格滑块houseType对应下拉框。如果前端传的是空字符串而不是 nullif判断要同时判空串否则会拼出AND house_type 这种查不到数据的条件。3.2 租赁订单的状态流转与防重复提交订单模块是答辩老师最爱问的地方因为它涉及状态机和并发。一个租赁订单的典型状态流转是待确认 → 已确认 → 租赁中 → 已完成任意环节可取消。表里用status字段记录每次变更写一条操作日志。核心接口是“创建订单”。这里有一个必须处理的坑同一个房源被两个人同时下单。常见做法是在创建前用数据库行锁或乐观锁校验房源状态Transactional public Result createOrder(Long houseId, Long tenantId) { // 悲观锁锁定房源行防止并发下单 House house houseMapper.selectByIdForUpdate(houseId); if (house null || house.getStatus() ! 0) { return Result.fail(房源已被租出或不存在); } // 更新房源状态为已租 house.setStatus(1); houseMapper.updateById(house); // 生成订单 RentalOrder order new RentalOrder(); order.setHouseId(houseId); order.setTenantId(tenantId); order.setStatus(0); // 待确认 order.setCreateTime(new Date()); orderMapper.insert(order); return Result.success(order); }selectByIdForUpdate对应 SQL 里的SELECT ... FOR UPDATE在事务内锁住这一行第二个请求会等待等第一个事务提交后发现状态已变直接返回失败。参数说明houseId和tenantId由前端传入Transactional保证锁和更新在同一事务。如果项目里没用事务这个防重就是摆设答辩时被问到会很难看。3.3 合同生成与文件上传的落地方式合同模块通常是毕设的加分项。最简单的做法是订单确认后后端根据模板生成一份 HTML 或 PDF 合同存到服务器本地目录数据库记录文件路径。生成 PDF 可以用 iText 或 FreeMarker 转 PDF但依赖较重。更轻的方案是生成 HTML前端用浏览器打印成 PDF。文件上传接口用 SpringBoot 的MultipartFilePostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file) { if (file.isEmpty()) { return Result.fail(文件为空); } String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.)); // 用 UUID 重命名避免中文名和重名问题 String newName UUID.randomUUID().toString() suffix; File dest new File(uploadDir newName); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } file.transferTo(dest); return Result.success(/upload/ newName); }uploadDir建议配置在application.yml里不要写死在代码中。UUID重命名解决两个问题中文文件名在不同系统下乱码以及同名文件互相覆盖。上传目录要确保有写权限Linux 部署时经常因为目录属主是 root 导致上传失败日志里报FileNotFoundException实际是权限问题。4. 避坑与排查跑不起来时先查这五个地方4.1 后端启动报数据库连接失败现象启动日志里出现Communications link failure或Access denied for user。原因通常是三种MySQL 服务没启动、application.yml里的密码不对、或者 MySQL 8 的驱动类名写成了旧版com.mysql.jdbc.Driver。解决先mysql -u root -p手动登录确认服务正常再把驱动类改成com.mysql.cj.jdbc.DriverURL 加上serverTimezone。如果是 Docker 里的 MySQL注意端口映射和容器内地址的区别。4.2 前端登录一直转圈或报 404现象页面能打开点登录没反应F12 控制台显示POST /api/user/login 404。原因基本是代理没配或路径不匹配。解决打开vue.config.js确认target指向后端真实端口再看后端 Controller 的映射路径。如果后端写的是RequestMapping(/user)前端请求/api/user/loginpathRewrite要把/api去掉否则后端收到的是/api/user/login自然 404。4.3 中文乱码从数据库一路乱到页面现象房源标题在数据库里是问号页面上也是乱码。原因建库时字符集不是utf8mb4或者 JDBC URL 没加characterEncodingutf8。解决重新建库指定DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ciURL 补上编码参数前端 HTML 的meta声明charsetutf-8。三处缺一处都可能乱码这是血泪经验。4.4 图片上传成功但页面不显示现象上传接口返回成功数据库路径也有但img标签是裂图。原因SpringBoot 默认不映射本地上传目录为静态资源。解决加一个配置类把上传目录映射到 URL 路径Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadDir); } }uploadDir结尾必须带斜杠否则路径拼接会出错。Windows 下是file:D:/upload/Linux 下是file:/data/upload/。4.5 答辩演示时数据库连的是别人的机器现象本地跑得好好的换到答辩教室的电脑上启动就报错。原因application.yml里数据库地址是localhost但教室电脑没装 MySQL或者数据没导。解决提前把 SQL 文件和项目一起拷贝现场用 U 盘里的绿色版 MySQL 或提前在教室机器上配好环境。更稳的做法是准备一个 SQLite 版本作为备用虽然和 MySQL 有差异但演示够用。这个坑每年都有人踩属于典型的后悔药没处买。5. 让毕设项目真正属于你三个必须动手改的地方5.1 改掉默认账号密码和演示数据压缩包里的项目通常自带admin/123456这种账号演示数据也是“张三租了李四的房子”。答辩时老师一看就知道是现成的。你至少要做三件事把管理员账号改成自己的学号或姓名拼音把房源数据换成真实小区名和合理价格把公告内容改成和学校或城市相关的文案。这些改动不涉及核心逻辑但能显著提升“这是我做的”可信度。改数据用 SQL 直接更新即可UPDATE user SET username 你的学号, password 加密后的密码 WHERE id 1; UPDATE house SET address XX市XX区XX小区, title 整租两室一厅 WHERE id 10;密码如果用了 MD5 或 BCrypt不要手动改明文用项目里的加密工具类生成后再更新。5.2 给核心接口加上参数校验和统一返回现成项目里很多 Controller 直接接收实体类没有校验。你可以在关键接口上加Valid和注解校验这是答辩时能讲的技术点PostMapping(/house) public Result addHouse(Valid RequestBody House house) { // 业务逻辑 } // House 实体类字段上加约束 NotBlank(message 标题不能为空) Size(max 100, message 标题过长) private String title; DecimalMin(value 0.01, message 租金必须大于0) private BigDecimal rent;配合全局异常处理器捕获MethodArgumentNotValidException返回统一的错误信息。这样前端能拿到具体哪个字段不合法而不是笼统的 500。这个改动工作量小但能让代码看起来规范很多。5.3 用 Postman 或 Apifox 整理一份接口文档答辩老师经常会问“你这个接口怎么设计的”。如果你能掏出一份接口文档印象分会高很多。把登录、房源增删改查、订单创建、合同上传这几个核心接口整理成表格写清请求方法、路径、参数、返回示例。不需要多完整覆盖主流程即可。这份文档也可以直接放进论文附录一举两得。接口方法路径参数说明登录POST/user/loginusername, password返回 token房源搜索GET/house/searchkeyword, minRent, maxRent分页返回创建订单POST/order/createhouseId, tenantId需登录上传合同POST/file/uploadfile返回文件路径整理完自己用 Postman 跑一遍确认每个接口的返回和文档一致。这个过程会逼你重新读一遍代码答辩时被追问也不慌。5.4 一个我自己的习惯我每次交付这类项目前都会做一次“断网测试”把电脑网线拔了看系统还能不能正常跑。因为很多项目引用了在线 CDN 的字体、图标或地图 API答辩教室网络一断页面直接变形。把 CDN 资源下载到本地static目录改成相对路径引用这个习惯帮我省过好几次尴尬。希望帮到你。本文还有配套的精品资源点击获取 房屋租赁系统毕业设计：SpringBoot+Vue项目实战与避坑指南
简介这份毕业设计资源包围绕《房屋租赁系统的设计与实现》展开面向计算机相关专业需要完成毕设的学生以及希望练习全栈开发与管理系统设计的开发者。项目融合程序设计、管理系统与人工智能三类知识点涵盖前端界面、后端业务逻辑、数据库表结构设计以及权限管理、房源发布查询、预约签约支付退租等租赁流程并涉及智能推荐、自然语言处理、图像识别等应用方向同时兼顾HTTPS、JWT身份验证、缓存与索引优化、Docker部署等工程实践。压缩包共578个文件约24.66MB以png、gif、jpg等图片资源和js、less、css、html等前端文件为主另有jsp、java、jar等后端与依赖文件以及xml、properties等配置项目录结构完整。已有117人学习可作为毕设选题参考与功能模块拆解样本帮助读者理解系统架构、梳理实现思路并对照完善自己的项目。1. 房屋租赁系统从一份毕业设计压缩包到能跑起来的完整项目每年到了毕设季计算机、软件工程、大数据方向的选题里房屋租赁系统几乎是出现频率最高的那一类。原因很直接业务场景人人能理解功能边界清晰数据库表关系不算复杂但又能塞进权限、搜索、订单、支付模拟这些足够写满论文的模块。你拿到一个名为“毕业设计-房屋租赁系统.zip”的压缩包第一反应大概率是里面是什么技术栈能不能直接跑查重能不能过答辩会不会被问穿这篇笔记不讨论某一份具体的源码而是把“房屋租赁系统”这个毕设题目当成一个工程对象来拆。我会按一线做项目的顺序把技术选型、数据库设计、核心功能实现、部署调试、以及答辩前必须自己动手改的地方讲清楚。适合正在做毕设的本科生也适合需要快速交付一个可演示系统的开发者。读完你应该能判断这个方向值不值得投入以及怎么在两周内把它从压缩包变成自己讲得明白的项目。2. 技术选型与项目结构为什么 SpringBoot Vue 是毕设最稳的组合2.1 三种主流技术栈的取舍逻辑房屋租赁系统在毕设语境下技术栈的选择不是追求先进而是追求三件事环境好装、代码好懂、答辩好讲。目前市面上能拿到的完整项目基本集中在三条路线上。第一条是 Java 路线SpringBoot MyBatis MySQL Vue。这是计算机毕业设计和 Java 毕业设计项目里占比最高的组合。后端分层清晰Controller、Service、Mapper 各司其职论文里画架构图、写模块设计都有现成的话术。前端用 Vue Element UI表格、表单、弹窗都是现成组件租赁系统里大量的列表页和审核页可以直接套。第二条是 Python 路线Django 或 Flask MySQL 前端模板。基于 Python 的毕业设计这两年热度上升很快代码量少适合想快速出效果的人。但缺点是如果指导老师偏 Java 体系答辩时容易被追问框架细节而 Django 的 ORM 和 admin 又太自动化反而不好展示“自己写了什么”。第三条是前后端不分离的 JSP 或 Thymeleaf 老式方案。这类项目在网盘里存量很大能跑但代码风格陈旧前端交互差答辩演示时观感吃亏。除非学校明确要求否则不建议选。我的建议很明确如果压缩包里是 SpringBoot Vue直接沿用如果是 JSP考虑把前端换成 Vue后端接口保留改造量可控但项目档次会明显提升。2.2 拿到压缩包后的目录体检解压之后不要急着导入 IDE先做一次结构体检。一个规范的房屋租赁系统项目根目录通常长这样house-rental/ ├── backend/ # 后端工程 │ ├── src/main/java/com/xxx/ │ │ ├── controller/ # 接口层 │ │ ├── service/ # 业务层 │ │ ├── mapper/ # 数据访问层 │ │ ├── entity/ # 实体类 │ │ └── config/ # 配置类 │ ├── src/main/resources/ │ │ ├── application.yml # 数据库、端口配置 │ │ └── mapper/ # MyBatis XML │ └── pom.xml ├── frontend/ # 前端工程 │ ├── src/views/ # 页面 │ ├── src/api/ # 接口封装 │ └── package.json ├── sql/ # 数据库脚本 │ └── house_rental.sql └── README.md体检重点看四个地方sql目录里有没有建表语句和初始数据application.yml里的数据库名、账号密码是什么pom.xml里的 SpringBoot 版本和 JDK 版本package.json里的 Vue 版本和依赖。这四项决定了你能不能在一小时内跑起来。如果缺少 SQL 文件这个包的价值会大打折扣因为表结构往往和实体类强绑定靠猜字段名非常痛苦。2.3 数据库导入与配置修改的最小步骤假设 SQL 文件齐全第一步是建库导数据。用命令行或 Navicat 都可以命令行更稳# 登录 MySQL创建数据库并导入 mysql -u root -p -e CREATE DATABASE house_rental DEFAULT CHARACTER SET utf8mb4; mysql -u root -p house_rental sql/house_rental.sql # 验证表是否导入成功 mysql -u root -p -e USE house_rental; SHOW TABLES;导入后重点确认几张核心表是否存在user用户、house房源、rental_order租赁订单、contract合同、announcement公告。如果表名是t_user、tb_house这种带前缀的说明作者有自己的命名习惯改配置时不要搞混。接着改application.ymlspring: datasource: url: jdbc:mysql://localhost:3306/house_rental?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver server: port: 8080这里有两个高频翻车点。一是serverTimezone不写MySQL 8 会报时区错误二是密码里有特殊字符YAML 里需要加引号。改完先启动后端看到 SpringBoot 的启动日志没有报错再动前端。2.4 前端启动与接口联调前端进入frontend目录先装依赖再启动cd frontend npm install npm run serve如果npm install卡住先换国内镜像源。启动成功后浏览器访问http://localhost:8081默认端口可能是 8080 冲突后自动切换的看终端输出为准。此时前端能打开登录页但登录请求会失败因为后端接口地址可能写死在src/api或vue.config.js的代理里。检查代理配置// vue.config.js module.exports { devServer: { proxy: { /api: { target: http://localhost:8080, // 后端地址 changeOrigin: true, pathRewrite: { ^/api: } } } } }target必须和后端实际端口一致pathRewrite要看后端 Controller 的RequestMapping有没有/api前缀。这两处对不上就会出现“前端能开、登录转圈、控制台 404”的经典现象。联调通了这个项目才算真正活过来。3. 核心业务模块实现房源、订单、合同三张表的联动3.1 房源表设计与多条件搜索接口房屋租赁系统的核心是房源。房源表设计得好不好直接决定后面订单和合同顺不顺。一个够用的house表至少包含这些字段字段名类型说明idbigint主键titlevarchar(100)房源标题addressvarchar(255)详细地址areadecimal(10,2)面积rentdecimal(10,2)月租金house_typevarchar(20)户型如两室一厅statustinyint0待租 1已租 2下架landlord_idbigint房东用户IDcreate_timedatetime发布时间搜索接口是使用频率最高的功能用户会按区域、价格区间、户型组合筛选。后端用 MyBatis 动态 SQL 实现select idsearchHouses resultTypeHouse SELECT * FROM house where if testkeyword ! null and keyword ! AND (title LIKE CONCAT(%, #{keyword}, %) OR address LIKE CONCAT(%, #{keyword}, %)) /if if testminRent ! null AND rent gt; #{minRent} /if if testmaxRent ! null AND rent lt; #{maxRent} /if if testhouseType ! null and houseType ! AND house_type #{houseType} /if AND status 0 /where ORDER BY create_time DESC /selectwhere标签会自动处理第一个AND避免语法错误。status 0写死在 SQL 里保证搜索只返回待租房源。参数说明keyword对应前端搜索框minRent和maxRent对应价格滑块houseType对应下拉框。如果前端传的是空字符串而不是 nullif判断要同时判空串否则会拼出AND house_type 这种查不到数据的条件。3.2 租赁订单的状态流转与防重复提交订单模块是答辩老师最爱问的地方因为它涉及状态机和并发。一个租赁订单的典型状态流转是待确认 → 已确认 → 租赁中 → 已完成任意环节可取消。表里用status字段记录每次变更写一条操作日志。核心接口是“创建订单”。这里有一个必须处理的坑同一个房源被两个人同时下单。常见做法是在创建前用数据库行锁或乐观锁校验房源状态Transactional public Result createOrder(Long houseId, Long tenantId) { // 悲观锁锁定房源行防止并发下单 House house houseMapper.selectByIdForUpdate(houseId); if (house null || house.getStatus() ! 0) { return Result.fail(房源已被租出或不存在); } // 更新房源状态为已租 house.setStatus(1); houseMapper.updateById(house); // 生成订单 RentalOrder order new RentalOrder(); order.setHouseId(houseId); order.setTenantId(tenantId); order.setStatus(0); // 待确认 order.setCreateTime(new Date()); orderMapper.insert(order); return Result.success(order); }selectByIdForUpdate对应 SQL 里的SELECT ... FOR UPDATE在事务内锁住这一行第二个请求会等待等第一个事务提交后发现状态已变直接返回失败。参数说明houseId和tenantId由前端传入Transactional保证锁和更新在同一事务。如果项目里没用事务这个防重就是摆设答辩时被问到会很难看。3.3 合同生成与文件上传的落地方式合同模块通常是毕设的加分项。最简单的做法是订单确认后后端根据模板生成一份 HTML 或 PDF 合同存到服务器本地目录数据库记录文件路径。生成 PDF 可以用 iText 或 FreeMarker 转 PDF但依赖较重。更轻的方案是生成 HTML前端用浏览器打印成 PDF。文件上传接口用 SpringBoot 的MultipartFilePostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file) { if (file.isEmpty()) { return Result.fail(文件为空); } String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.)); // 用 UUID 重命名避免中文名和重名问题 String newName UUID.randomUUID().toString() suffix; File dest new File(uploadDir newName); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } file.transferTo(dest); return Result.success(/upload/ newName); }uploadDir建议配置在application.yml里不要写死在代码中。UUID重命名解决两个问题中文文件名在不同系统下乱码以及同名文件互相覆盖。上传目录要确保有写权限Linux 部署时经常因为目录属主是 root 导致上传失败日志里报FileNotFoundException实际是权限问题。4. 避坑与排查跑不起来时先查这五个地方4.1 后端启动报数据库连接失败现象启动日志里出现Communications link failure或Access denied for user。原因通常是三种MySQL 服务没启动、application.yml里的密码不对、或者 MySQL 8 的驱动类名写成了旧版com.mysql.jdbc.Driver。解决先mysql -u root -p手动登录确认服务正常再把驱动类改成com.mysql.cj.jdbc.DriverURL 加上serverTimezone。如果是 Docker 里的 MySQL注意端口映射和容器内地址的区别。4.2 前端登录一直转圈或报 404现象页面能打开点登录没反应F12 控制台显示POST /api/user/login 404。原因基本是代理没配或路径不匹配。解决打开vue.config.js确认target指向后端真实端口再看后端 Controller 的映射路径。如果后端写的是RequestMapping(/user)前端请求/api/user/loginpathRewrite要把/api去掉否则后端收到的是/api/user/login自然 404。4.3 中文乱码从数据库一路乱到页面现象房源标题在数据库里是问号页面上也是乱码。原因建库时字符集不是utf8mb4或者 JDBC URL 没加characterEncodingutf8。解决重新建库指定DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ciURL 补上编码参数前端 HTML 的meta声明charsetutf-8。三处缺一处都可能乱码这是血泪经验。4.4 图片上传成功但页面不显示现象上传接口返回成功数据库路径也有但img标签是裂图。原因SpringBoot 默认不映射本地上传目录为静态资源。解决加一个配置类把上传目录映射到 URL 路径Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadDir); } }uploadDir结尾必须带斜杠否则路径拼接会出错。Windows 下是file:D:/upload/Linux 下是file:/data/upload/。4.5 答辩演示时数据库连的是别人的机器现象本地跑得好好的换到答辩教室的电脑上启动就报错。原因application.yml里数据库地址是localhost但教室电脑没装 MySQL或者数据没导。解决提前把 SQL 文件和项目一起拷贝现场用 U 盘里的绿色版 MySQL 或提前在教室机器上配好环境。更稳的做法是准备一个 SQLite 版本作为备用虽然和 MySQL 有差异但演示够用。这个坑每年都有人踩属于典型的后悔药没处买。5. 让毕设项目真正属于你三个必须动手改的地方5.1 改掉默认账号密码和演示数据压缩包里的项目通常自带admin/123456这种账号演示数据也是“张三租了李四的房子”。答辩时老师一看就知道是现成的。你至少要做三件事把管理员账号改成自己的学号或姓名拼音把房源数据换成真实小区名和合理价格把公告内容改成和学校或城市相关的文案。这些改动不涉及核心逻辑但能显著提升“这是我做的”可信度。改数据用 SQL 直接更新即可UPDATE user SET username 你的学号, password 加密后的密码 WHERE id 1; UPDATE house SET address XX市XX区XX小区, title 整租两室一厅 WHERE id 10;密码如果用了 MD5 或 BCrypt不要手动改明文用项目里的加密工具类生成后再更新。5.2 给核心接口加上参数校验和统一返回现成项目里很多 Controller 直接接收实体类没有校验。你可以在关键接口上加Valid和注解校验这是答辩时能讲的技术点PostMapping(/house) public Result addHouse(Valid RequestBody House house) { // 业务逻辑 } // House 实体类字段上加约束 NotBlank(message 标题不能为空) Size(max 100, message 标题过长) private String title; DecimalMin(value 0.01, message 租金必须大于0) private BigDecimal rent;配合全局异常处理器捕获MethodArgumentNotValidException返回统一的错误信息。这样前端能拿到具体哪个字段不合法而不是笼统的 500。这个改动工作量小但能让代码看起来规范很多。5.3 用 Postman 或 Apifox 整理一份接口文档答辩老师经常会问“你这个接口怎么设计的”。如果你能掏出一份接口文档印象分会高很多。把登录、房源增删改查、订单创建、合同上传这几个核心接口整理成表格写清请求方法、路径、参数、返回示例。不需要多完整覆盖主流程即可。这份文档也可以直接放进论文附录一举两得。接口方法路径参数说明登录POST/user/loginusername, password返回 token房源搜索GET/house/searchkeyword, minRent, maxRent分页返回创建订单POST/order/createhouseId, tenantId需登录上传合同POST/file/uploadfile返回文件路径整理完自己用 Postman 跑一遍确认每个接口的返回和文档一致。这个过程会逼你重新读一遍代码答辩时被追问也不慌。5.4 一个我自己的习惯我每次交付这类项目前都会做一次“断网测试”把电脑网线拔了看系统还能不能正常跑。因为很多项目引用了在线 CDN 的字体、图标或地图 API答辩教室网络一断页面直接变形。把 CDN 资源下载到本地static目录改成相对路径引用这个习惯帮我省过好几次尴尬。希望帮到你。本文还有配套的精品资源点击获取