1. 项目背景与核心价值
去年帮学弟调试毕业设计时，发现房屋租赁系统这个选题经久不衰——既有足够的商业价值体现工程能力，又不会复杂到难以实现。这个基于Java+Vue的全栈项目，正好覆盖了毕业生需要展示的三大能力：后端业务逻辑处理（Java）、前端交互实现（Vue）以及系统架构设计（SpringBoot+MyBatis）。
相比纯课程设计，这个项目有几个突出优势：
- 真实的业务闭环（房东-房源-租客-合同）
- 典型的前后端分离架构
- 可扩展的权限管理体系
- 完整的文档体系（毕业答辩加分项）
2. 技术栈选型解析
2.1 后端技术组合
采用SpringBoot 2.7 + MyBatis-Plus的组合绝非偶然：
- SpringBoot的自动配置让毕业生避开繁琐的XML配置
- MyBatis-Plus的Lambda查询比原生MyBatis节省30%的SQL编写量
- 特意选用Hutool工具包处理日期/字符串，避免自己造轮子
数据库选择MySQL 8.0而非5.7，是因为：
sql复制-- 支持JSON字段存储房源图片数组
ALTER TABLE house
ADD images JSON COMMENT '房源图片';
2.2 前端技术方案
Vue 2.x + ElementUI的经典组合考虑点：
- 比Vue3更稳定的周边生态（毕业设计期间少踩坑）
- ElementUI的Form组件能快速搭建CRUD界面
- Axios拦截器统一处理401权限问题
特意增加的前端优化项：
javascript复制// 路由懒加载提升首屏速度
const HouseList = () => import('./views/HouseList.vue')
3. 核心业务模块实现
3.1 房源管理子系统
采用状态机模式管理房源状态：
java复制public enum HouseStatus {
AUDITING(1), // 审核中
RENTING(2), // 出租中
MAINTENANCE(3); // 维护中
// 状态转换校验逻辑
public boolean canTransferTo(HouseStatus nextStatus) {
// 具体实现...
}
}
图片上传采用分片上传策略：
- 前端用spark-md5生成文件指纹
- 七牛云SDK实现断点续传
- 数据库只存储CDN地址
3.2 租赁合同模块
合同PDF生成方案对比：
| 方案 | 优点 | 缺点 |
|---|---|---|
| iText | 精细控制 | 代码量庞大 |
| JasperReport | 模板化 | 需要学习JRXML |
| Thymeleaf+wkhtmltopdf | 开发快 | 服务器需装插件 |
最终选用方案三，核心代码：
java复制// 用Thymeleaf渲染HTML模板
String html = templateEngine.process("contract", ctx);
// 调用wkhtmltopdf转换
Files.write(pdfPath, new WkHtmlToPdf().convert(html));
4. 关键问题解决方案
4.1 并发订房冲突
采用乐观锁解决超卖问题：
sql复制UPDATE house
SET status = 'RENTED'
WHERE id = 1001 AND status = 'AVAILABLE'
前端配合使用防抖策略：
javascript复制// 提交按钮500ms内防重复点击
this.debounceSubmit = _.debounce(this.realSubmit, 500);
4.2 权限控制方案
RBAC模型扩展字段：
java复制@Data
public class UserRole {
private Long userId;
private String role; // admin/landlord/tenant
private String scope; // 数据权限范围
}
接口级权限控制：
java复制@PreAuthorize("hasRole('landlord') or #userId == authentication.principal.id")
public void updateHouse(Long userId, HouseVO vo) {
// ...
}
5. 部署与监控方案
5.1 低成本部署方案
阿里云学生机配置建议：
- 1核2G云服务器（9.9元/月）
- 配置MySQL时注意：
ini复制[mysqld] innodb_buffer_pool_size = 256M # 小内存优化
5.2 基础监控实现
SpringBoot Actuator配置：
yaml复制management:
endpoints:
web:
exposure:
include: health,metrics
endpoint:
health:
show-details: always
前端埋点示例：
javascript复制// 使用百度统计跟踪页面停留
export default {
mounted() {
this._startTime = Date.now();
},
beforeDestroy() {
const duration = Date.now() - this._startTime;
_hmt.push(['_trackEvent', 'HouseDetail', 'View', duration]);
}
}
6. 答辩加分项设计
6.1 文档体系构建
必备文档清单：
- 数据库设计文档（含ER图）
- API接口文档（Swagger UI）
- 部署手册（含常见错误解决方案）
推荐使用PlantUML画时序图：
plantuml复制@startuml
actor 租客
participant 前端
participant 后端
participant 支付宝
租客 -> 前端: 提交订单
前端 -> 后端: POST /orders
后端 -> 支付宝: 创建交易
支付宝 --> 后端: 返回支付链接
后端 --> 前端: 返回支付页面
@enduml
6.2 性能优化展示
缓存策略示例：
java复制@Cacheable(value = "houses", key = "#id")
public HouseVO getHouseById(Long id) {
return mapper.selectById(id);
}
前端性能数据采集：
javascript复制// 使用Navigation Timing API
const perfData = window.performance.timing;
console.log(`TTFB: ${perfData.responseStart - perfData.requestStart}ms`);
7. 避坑指南
-
时间处理坑：
java复制// 一定要配置时区 spring.jackson.time-zone=GMT+8 -
微信支付沙箱环境：
- 需要特别申请测试商户号
- 验签时注意使用测试密钥
-
跨域问题终极方案：
java复制@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOrigins("*") .allowedMethods("*") .maxAge(3600); } } -
数据库连接池配置：
yaml复制spring: datasource: hikari: maximum-pool-size: 10 # 小项目10连接足够 connection-timeout: 3000 idle-timeout: 600000
这个项目我指导过3个学弟完成，最大的体会是：不要过度追求技术新颖，把基础功能做扎实，文档写完整，比强行上新技术更得分。最后提醒下，房源审核流程一定要设计操作日志，这是答辩老师最爱问的审计问题。