SpringBoot+Vue3房屋租赁系统开发实践

1. 项目概述

这套房屋租赁系统采用当前主流的前后端分离架构，后端基于SpringBoot框架构建，前端使用Vue3实现，数据持久层采用MyBatis与MySQL数据库交互。系统设计目标是解决传统租赁业务中合同管理混乱、看房效率低下、账目统计困难等痛点，为中小型房产中介提供数字化解决方案。

我在实际开发中发现，这种技术组合特别适合需要快速迭代的B端管理系统。SpringBoot的约定优于配置原则让后端开发效率提升40%以上，Vue3的Composition API使前端组件复用率显著提高，而MyBatis的动态SQL能力则完美适配业务中复杂的查询条件组合。

2. 技术架构解析

2.1 后端技术栈设计

SpringBoot 2.7.x作为基础框架，其自动装配机制大幅减少了XML配置。特别在邮件服务、定时任务等模块，通过starter依赖实现开箱即用。例如房源状态定时更新功能：

java复制@Scheduled(cron = "0 0 3 * * ?")
public void autoUpdateHouseStatus() {
    // 自动下架过期房源
    houseMapper.updateExpiredHouses();
}

数据层采用MyBatis-Plus 3.5.x增强版，其Lambda表达式查询构建器让代码更简洁：

java复制List<House> houses = lambdaQuery()
    .eq(House::getStatus, 1)
    .ge(House::getArea, 50)
    .list();

2.2 前端技术方案

Vue3的组合式API（Composition API）大幅提升了代码组织性。以房源搜索组件为例：

javascript复制const searchParams = reactive({
    district: '',
    priceRange: [0, 10000],
    roomType: ''
});

const filteredHouses = computed(() => {
    return houseList.value.filter(house => 
        house.price >= searchParams.priceRange[0] && 
        house.price <= searchParams.priceRange[1]
    );
});

采用Pinia替代Vuex进行状态管理，其模块化设计更符合租赁业务场景：

javascript复制// stores/contract.js
export const useContractStore = defineStore('contract', {
    state: () => ({ drafts: [] }),
    actions: {
        async loadDrafts() {
            this.drafts = await api.getContractDrafts();
        }
    }
});

3. 核心功能实现

3.1 房源多条件搜索

后端采用MyBatis动态SQL构建灵活查询：

xml复制<select id="searchHouses" resultMap="HouseMap">
    SELECT * FROM house
    <where>
        <if test="district != null">
            AND district = #{district}
        </if>
        <if test="minPrice != null">
            AND price >= #{minPrice}
        </if>
        <if test="roomType != null">
            AND room_type = #{roomType}
        </if>
    </where>
    ORDER BY update_time DESC
</select>

前端配合实现实时搜索反馈：

javascript复制watchDebounced(
    searchParams,
    () => fetchHouses(),
    { debounce: 500 }
);

3.2 电子合同签署流程

1. 模板管理：使用Freemarker动态生成合同文档
2. 签署验证：集成CA数字证书服务
3. 存证备案：合同哈希值上链存储（采用Hyperledger Fabric私有链）

关键代码示例：

java复制public String generateContract(ContractTemplate template, Map<String, Object> data) {
    Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
    cfg.setTemplateLoader(new StringTemplateLoader(template.getContent()));
    Template temp = cfg.getTemplate("");
    StringWriter writer = new StringWriter();
    temp.process(data, writer);
    return writer.toString();
}

4. 数据库设计要点

4.1 主要表结构

表名	关键字段	索引设计
house	id, title, district, price, status	联合索引(district, status)
contract	id, house_id, tenant_id, start_date, end_date	唯一索引(house_id, tenant_id)
payment	id, contract_id, amount, payment_date	普通索引(contract_id)

4.2 性能优化实践

1. 分区表：按地区对房源表进行RANGE分区
2. 读写分离：SpringBoot配置多数据源
3. 缓存策略：使用Redis缓存热门房源

yaml复制# application.yml
spring:
  redis:
    cache:
      house-list: 3600s # 房源列表缓存1小时
      house-detail: 1800s # 详情缓存30分钟

5. 部署与运维方案

5.1 容器化部署

Docker Compose编排文件示例：

dockerfile复制version: '3'
services:
  backend:
    build: ./backend
    ports:
      - "8080:8080"
    depends_on:
      - mysql
  frontend:
    build: ./frontend
    ports:
      - "80:80"
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}

5.2 监控配置

1. SpringBoot Actuator暴露健康检查端点
2. Prometheus + Grafana监控JVM指标
3. ELK日志收集系统

关键监控指标：

• 平均响应时间 < 500ms
• JVM内存使用率 < 70%
• MySQL连接数利用率 < 80%

6. 典型问题解决方案

6.1 并发签约冲突

采用乐观锁机制防止超租：

java复制@Transactional
public boolean signContract(Long houseId) {
    House house = houseMapper.selectById(houseId);
    if (house.getStatus() != 1) {
        return false;
    }
    house.setStatus(2); // 标记为已签约
    return houseMapper.updateById(house) > 0;
}

6.2 大数据量导出

使用Apache POI的SXSSFWorkbook实现百万级数据导出：

java复制SXSSFWorkbook workbook = new SXSSFWorkbook(100); // 保持100行在内存中
Sheet sheet = workbook.createSheet("Contracts");
Row headerRow = sheet.createRow(0);
// 添加表头...

for (Contract contract : contractList) {
    Row row = sheet.createRow(rowNum++);
    row.createCell(0).setCellValue(contract.getId());
    // 其他字段...
    if (rowNum % 100 == 0) {
        ((SXSSFSheet)sheet).flushRows(100); // 定期刷新
    }
}

7. 安全防护措施

1. 接口安全：

   • JWT令牌认证
   • Spring Security权限控制
   • 参数过滤（防SQL注入）

2. 数据安全：

   • 敏感字段加密存储（使用AES-256）
   • 数据库定时备份
   • 操作日志审计

安全配置示例：

java复制@Configuration
@EnableWebSecurity
public class SecurityConfig {
    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
            .csrf().disable()
            .authorizeRequests()
                .antMatchers("/api/public/**").permitAll()
                .antMatchers("/api/contract/**").hasRole("AGENT")
                .anyRequest().authenticated()
            .and()
            .addFilter(new JwtAuthenticationFilter(authenticationManager()));
        return http.build();
    }
}

8. 项目优化方向

1. 性能优化：

   • 引入Elasticsearch实现房源全文检索
   • 使用WebSocket实现实时消息通知
   • 前端组件懒加载

2. 功能扩展：

   • 增加VR看房模块（Three.js集成）
   • 对接第三方支付平台
   • 开发房东端小程序

3. 运维增强：

   • 搭建CI/CD流水线
   • 实现灰度发布
   • 增加混沌工程测试

实际开发中，这套系统从技术选型到具体实现都遵循了"稳定优先，适度超前"的原则。特别在MyBatis使用上，我们既保留了传统XML方式的灵活性，又在简单CRUD场景采用MyBatis-Plus提升效率。前端Vue3的