SpringBoot2+Vue3房屋租赁系统开发实战

蓝天白云很快了

1. 项目概述

这套基于SpringBoot2+Vue3+MyBatis-Plus+MySQL8.0的房屋租赁系统，是我在实际商业项目中经过多次迭代优化的成熟解决方案。系统采用前后端分离架构，后端使用Java生态中最主流的SpringBoot框架，前端则基于Vue3的组合式API开发，数据库选用MySQL8.0充分利用其JSON支持和窗口函数等新特性。相比传统租赁管理系统，这套方案在性能、扩展性和开发效率上都有显著提升。

提示：系统完整源码和文档已经过生产环境验证，包含租客端、房东端和管理员端三个角色模块，支持从房源发布、在线签约到租金管理的全流程数字化。

2. 技术栈选型解析

2.1 后端技术组合

SpringBoot2.x作为基础框架，其自动配置特性大幅减少了XML配置。我特别选用2.7.x稳定版本而非最新的3.x系列，主要考虑企业环境对JDK版本的兼容性要求。实际部署时通过spring-boot-starter-actuator实现了健康检查，配合Prometheus+Grafana搭建监控看板。

MyBatis-Plus 3.5.x作为ORM层，其Lambda表达式查询构建器让代码更简洁：

java复制// 典型查询示例
LambdaQueryWrapper<House> query = new LambdaQueryWrapper<>();
query.eq(House::getStatus, 1)
     .between(House::getPrice, minPrice, maxPrice)
     .orderByDesc(House::getCreateTime);

2.2 前端技术演进

Vue3组合式API相比Options API更适合复杂业务场景。我在房源详情页使用<script setup>语法，配合Pinia状态管理：

javascript复制// 使用setup语法
const houseStore = useHouseStore()
const { currentHouse } = storeToRefs(houseStore)

onMounted(async () => {
  await houseStore.fetchHouseDetail(route.params.id)
})

2.3 数据库设计要点

MySQL8.0的改进在系统中得到充分应用：

使用JSON类型存储房屋配套设施数据
窗口函数实现租金统计报表
原子DDL保证表结构变更安全

核心表关系设计：

sql复制CREATE TABLE `t_house` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `title` varchar(100) COLLATE utf8mb4_bin NOT NULL,
  `specs` json DEFAULT NULL COMMENT '配套设施JSON',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

3. 核心功能实现

3.1 多角色权限控制

采用RBAC模型结合JWT实现细粒度控制。Spring Security配置关键点：

java复制@Configuration
@EnableWebSecurity
public class SecurityConfig {
    @Bean
    SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/api/tenant/**").hasRole("TENANT")
            .antMatchers("/api/owner/**").hasRole("OWNER")
            .anyRequest().authenticated();
        return http.build();
    }
}

前端路由守卫实现：

javascript复制router.beforeEach((to) => {
  if (to.meta.requiresAuth && !store.state.user) {
    return { path: '/login', query: { redirect: to.fullPath } }
  }
})

3.2 电子合同签署流程

使用PDF.js渲染合同模板
通过Canvas实现手写签名
阿里云OSS存储签署后的合同
区块链存证关键操作日志

签名处理核心代码：

javascript复制const handleSign = (signature) => {
  const canvas = document.getElementById('sign-pad')
  const url = canvas.toDataURL()
  uploadSignature(url).then(() => {
    // 生成合同最终版
  })
}

3.3 支付对账系统

集成支付宝和微信支付双渠道，采用策略模式封装支付逻辑：

java复制public interface PaymentStrategy {
    PaymentResult pay(PaymentRequest request);
}

@Service
@RequiredArgsConstructor
public class PaymentService {
    private final Map<String, PaymentStrategy> strategies;
    
    public PaymentResult pay(String channel, PaymentRequest request) {
        return strategies.get(channel).pay(request);
    }
}

定时对账任务使用Spring Scheduler：

java复制@Scheduled(cron = "0 0 2 * * ?")
public void dailyReconciliation() {
    // 下载对账单并比对
}

4. 性能优化实践

4.1 缓存策略设计

采用多级缓存架构：

本地Caffeine缓存热点数据
Redis集群缓存共享数据
MySQL查询优化

缓存注解配置示例：

java复制@Cacheable(value = "houses", key = "#id", unless = "#result == null")
public House getById(Long id) {
    return baseMapper.selectById(id);
}

4.2 数据库优化

索引优化：为所有外键和查询条件字段建立组合索引
查询优化：避免SELECT *，使用MyBatis-Plus的@TableField(select = false)
连接池配置：HikariCP参数调优

典型索引设计：

sql复制ALTER TABLE t_contract 
ADD INDEX idx_house_tenant (house_id, tenant_id);

4.3 前端性能提升

路由懒加载
组件按需引入
图片懒加载
Webpack分包策略

vite配置示例：

javascript复制export default defineConfig({
  build: {
    rollupOptions: {
      output: {
        manualChunks: {
          vendor: ['vue', 'pinia']
        }
      }
    }
  }
})

5. 部署与监控

5.1 容器化部署

Docker Compose编排文件关键配置：

yaml复制services:
  app:
    image: openjdk:11-jre
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
  mysql:
    image: mysql:8.0
    volumes:
      - ./mysql-data:/var/lib/mysql

5.2 日志收集方案

ELK日志收集架构
关键业务日志标记
异常日志告警配置

Logback配置示例：

xml复制<appender name="ELK" class="net.logstash.logback.appender.LogstashTcpSocketAppender">
    <destination>logstash:5044</destination>
    <encoder class="net.logstash.logback.encoder.LogstashEncoder"/>
</appender>

5.3 健康检查端点

SpringBoot Actuator配置：

properties复制management.endpoints.web.exposure.include=health,info,metrics
management.endpoint.health.show-details=always

6. 典型问题排查

6.1 跨域问题解决方案

生产环境遇到的CORS问题处理：

java复制@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins("https://domain.com")
                .allowCredentials(true);
    }
}

6.2 分布式锁实现

使用Redisson解决并发问题：

java复制public void lockExample() {
    RLock lock = redissonClient.getLock("house:lock:" + houseId);
    try {
        lock.lock(10, TimeUnit.SECONDS);
        // 业务逻辑
    } finally {
        lock.unlock();
    }
}

6.3 事务失效场景

排查发现的事务不生效案例：

java复制// 错误示例：同类方法调用导致事务失效
public void updateHouse(Long id) {
    this.innerUpdate(id); // 事务不生效
}

@Transactional
public void innerUpdate(Long id) {
    // update操作
}

// 正确做法：通过代理对象调用
@Autowired
private ApplicationContext context;

public void updateHouse(Long id) {
    context.getBean(HouseService.class).innerUpdate(id);
}

7. 项目文档体系

7.1 接口文档规范

使用Swagger3+Knife4j生成文档，关键配置：

java复制@Bean
public Docket api() {
    return new Docket(DocumentationType.OAS_30)
            .apiInfo(apiInfo())
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.rental"))
            .build();
}