17、《SpringBoot+MyBatis集成（5） - 工程实践 - 企业级项目架构设计》-优快云博客

本文链接：https://blog.youkuaiyun.com/ldz_wolf/article/details/145720014

SpringBoot+MyBatis集成 - 工程实践 - 企业级项目架构设计

一、开篇：企业级架构的核心诉求

在互联网高并发场景下，如何构建可维护、高性能、安全稳定的系统架构是企业级项目的核心挑战。本文以SpringBoot+MyBatis技术栈为基石，深入探讨分层架构设计、数据访问层优化、多租户隔离等关键技术，并提供从开发到运维的全链路实践方案。通过本文，您将掌握大型项目中ORM框架的高阶用法及典型问题的系统性解法。

二、分层架构设计与工程规范

2.1 标准三层架构实现

项目结构示例：

src/main/java
├── com.xxx
│   ├── controller       # 请求入口层
│   ├── service          # 业务逻辑层
│   │   ├── impl         # 服务实现
│   ├── dao              # 数据访问层
│   ├── entity           # 实体对象
│   ├── dto              # 数据传输对象
│   └── config           # 配置类

分层职责说明：

Controller层：处理HTTP请求/响应，建议使用@Validated进行参数校验
Service层：通过@Transactional声明事务边界，处理核心业务逻辑
DAO层：使用MyBatis的Mapper接口实现数据库操作，推荐继承BaseMapper<T>

2.2 企业级项目规范

模块化拆分：按业务域划分Maven模块
配置管理：区分application-dev.yml/application-prod.yml
日志规范：统一采用SLF4J+Logback，按模块输出日志文件

三、MyBatis深度定制实践

3.1 自定义插件开发

实现SQL执行日志打印插件：

@Intercepts({
    @Signature(type = Executor.class, method = "update", args = {MappedStatement.class, Object.class}),
    @Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})
})
public class SqlLogInterceptor implements Interceptor {
    
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        MappedStatement ms = (MappedStatement) invocation.getArgs()[0];
        Object param = invocation.getArgs()[1];
        
        // 获取BoundSql打印完整SQL
        BoundSql boundSql = ms.getBoundSql(param);
        String sql = boundSql.getSql();
        Logger.info("Executing SQL: {}", sql);
        
        return invocation.proceed();
    }
}

3.2 分页优化方案

集成PageHelper的正确姿势：

# application.yml
pagehelper:
  helper-dialect: mysql
  reasonable: true
  support-methods-arguments: true

分页使用示例：

public PageInfo<User> queryUsers(int pageNum, int pageSize) {
    PageHelper.startPage(pageNum, pageSize);
    List<User> users = userMapper.selectAll();
    return new PageInfo<>(users);
}

注意事项：

避免在分页语句后紧跟其他查询操作
推荐使用PageHelper.offsetPage()实现深度分页
生产环境需结合缓存机制优化分页性能

四、多租户数据隔离方案

4.1 常见隔离模式对比

方案类型	实现方式	优点	缺点
独立数据库	每个租户独立DB实例	数据隔离性强	运维成本高
共享Schema	通过tenant_id字段区分	资源利用率高	需处理数据泄露风险
混合模式	大客户独立DB+小客户共享	平衡性能与成本	架构复杂度较高

4.2 基于MyBatis的租户拦截器

public class TenantInterceptor implements Interceptor {
    
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 动态注入tenant_id条件
        StatementHandler handler = (StatementHandler) invocation.getTarget();
        BoundSql boundSql = handler.getBoundSql();
        
        String newSql = boundSql.getSql() + " AND tenant_id = ?";
        MetaObject metaObject = SystemMetaObject.forObject(handler);
        metaObject.setValue("delegate.boundSql.sql", newSql);
        
        // 设置参数值
        List<ParameterMapping> mappings = new ArrayList<>(boundSql.getParameterMappings());
        mappings.add(new ParameterMapping.Builder(
            configuration, "tenantId", Long.class).build());
        
        metaObject.setValue("delegate.boundSql.parameterMappings", mappings);
        metaObject.setValue("delegate.boundSql.additionalParameters", 
            Collections.singletonMap("tenantId", TenantContext.getCurrentId()));
        
        return invocation.proceed();
    }
}

五、SQL性能监控与优化

5.1 监控体系搭建

配置Druid监控中心：

@Configuration
public class DruidConfig {
    
    @Bean
    public ServletRegistrationBean<StatViewServlet> druidServlet() {
        ServletRegistrationBean<StatViewServlet> reg = new ServletRegistrationBean<>();
        reg.setServlet(new StatViewServlet());
        reg.addUrlMappings("/druid/*");
        return reg;
    }
}

慢查询检测配置：

# MySQL配置
SET GLOBAL long_query_time = 2;
SET GLOBAL slow_query_log = ON;

5.2 典型性能问题

N+1问题解决方案：

<!-- 使用关联查询替代循环查询 -->
<select id="selectUserWithOrders" resultMap="userResultMap">
    SELECT u.*, o.order_id, o.amount 
    FROM user u
    LEFT JOIN orders o ON u.id = o.user_id
    WHERE u.id = #{id}
</select>

<!-- 或使用MyBatis的集合映射 -->
<resultMap id="userResult" type="User">
    <collection property="orders" ofType="Order" 
                select="selectOrdersByUserId" column="id"/>
</resultMap>