SpringBoot多租户实战:用dynamic-datasource-spring-boot-starter 3.5.1实现动态数据源切换

使用dynamic-datasource-spring-boot-starter做多数据源及源码分析 多数据源系列 1、spring boot2.0 +Mybatis + druid搭建一个最简单的多数据源 2、利用Spring的AbstractRoutingDataSource做多数据源动态切换 3、使用dynamic-datasource-spring-boot-starter做多数据源及源码分析 文章目录多数据源系列简介实操基本使用集成druid连接池源码分析整体结构总结 简介 前两篇博客介绍了用基本的方式做多数据源,可以应对一般的情况,但是遇到一些复杂的情况,比如:动态增减数据源、数据源分组,纯粹多 阅读详情

SpringBoot多租户实战:用dynamic-datasource-spring-boot-starter 3.5.1构建企业级动态数据源架构

如果你正在为一个SaaS平台或者一个需要服务多个独立客户(租户)的内部系统发愁,数据隔离肯定是绕不开的核心难题。每个租户的数据必须物理或逻辑上分开,但代码又希望是同一套,这种矛盾在项目初期可能还能用一些“土办法”对付,但随着租户数量增长,维护成本会指数级上升。我经历过不止一个项目,从简单的数据库前缀区分,到后来不得不重构为更彻底的隔离方案,踩过的坑让我深刻意识到,一个清晰、可维护的多租户数据源架构是多么重要。

今天我们不谈那些过于理论化的设计模式,直接聚焦于一个在SpringBoot生态中非常流行的解决方案:dynamic-datasource-spring-boot-starter。这个由苞米豆团队维护的组件,以其轻量、非侵入和强大的动态管理能力,成为了许多中小型项目实现多租户数据隔离的首选。我们将基于最新的3.5.1版本,从零开始,搭建一个生产可用的多租户系统。重点不仅仅是配置怎么写,而是如何将数据源动态切换与你的业务登录流程、连接池管理、事务控制无缝集成,解决那些文档里不会写,但实际开发中一定会遇到的“高频痛点”。

1. 架构核心:理解多租户与动态数据源

在深入代码之前,我们必须对要解决的问题和采用的方案有一个清晰的蓝图。多租户(Multi-Tenancy)架构,简单说就是一套应用实例能够同时为多个相互隔离的客户(租户)提供服务。数据隔离是其核心,通常有三种实现方式:

  1. 独立数据库:每个租户拥有自己独立的数据库实例。隔离性最好,安全性最高,但成本也最大。
  2. 共享数据库,独立Schema:所有租户共享同一个数据库实例,但每个租户有自己的一套表(Schema)。在MySQL中,Schema基本等同于Database。
  3. 共享数据库,共享Schema:所有租户的数据都存放在同一套表中,通过一个tenant_id字段来区分。结构最简单,但数据隔离和查询复杂度较高。

我们即将实现的,是第二种方式:共享数据库实例,但每个租户有独立的数据库(Schema)。dynamic-datasource 在这里扮演的角色,就是根据当前请求的租户身份,动态地将数据库连接指向对应的租户数据库。

它的工作原理可以概括为下图所示的流程:

sequenceDiagram
    participant C as 客户端/租户
    participant I as 拦截器
    participant H as DynamicDataSourceContextHolder
    participant DRDS as DynamicRoutingDataSource
    participant D as 目标数据源
    participant DB as 租户数据库

    C->>I: 发起请求(携带租户标识)
    I->>H: 解析标识,将租户Key压入线程上下文
    H->>DRDS: 当前线程需使用租户Key对应的数据源
    DRDS->>DRDS: 根据Key查找/创建数据源
    DRDS->>D: 获取目标数据源连接
    D->>DB: 执行SQL操作
    DB-->>D: 返回数据
    D-->>DRDS: 返回连接
    DRDS-->>H: 完成操作
    H-->>I: 请求处理完毕
    I->>H: 清理线程上下文中的租户Key
    I-->>C: 返回响应

这个流程的核心在于 DynamicDataSourceContextHolder 这个类。它利用 ThreadLocal 为每个请求线程绑定了一个数据源标识(Key)。当程序执行数据库操作时,DynamicRoutingDataSource(动态路由数据源)会向它询问:“当前线程要用哪个数据源?” 然后它就像个路由器一样,把连接请求导向正确的目标。

这种设计的好处是对业务代码几乎无侵入。你的Service层、Mapper层完全不用关心当前操作的是哪个租户的数据,它们只需要像在单数据源环境下一样编写SQL即可。数据源的切换在更上层的拦截器或过滤器中透明完成。

2. 环境搭建与基础配置

理论清晰后,我们开始动手。首先创建一个标准的SpringBoot项目,这里我推荐使用Spring Initializr,选择必要的依赖:Spring Web, Spring Data JPA (或MyBatis-Plus),以及MySQL Driver。

2.1 引入核心依赖

在 pom.xml 中,添加 dynamic-datasource-spring-boot-starter 的依赖。强烈建议明确指定版本号,以避免后续因版本自动升级带来的不兼容问题。

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
    <version>3.5.1</version>
</dependency>

如果你计划使用Druid连接池(这也是生产环境的常见选择),需要排除SpringBoot的默认HikariCP自动配置,并引入Druid的starter。

<!-- Druid 连接池 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.16</version> <!-- 请使用最新稳定版 -->
</dependency>

注意:dynamic-datasource 支持多种连接池,它会按照 druid > hikaricp > beecp > dbcp > spring basic 的顺序自动检测并创建。显式引入Druid依赖后,它会优先使用Druid。

2.2 配置数据源信息

接下来是 application.yml 的配置。这里我们需要定义一个主数据源,它用于存储系统本身的管理信息,例如用户账号、租户信息、以及各个租户的数据源配置。这个库是系统启动和管理的基石。

spring:
  datasource:
    dynamic:
      primary: master # 默认数据源名称,项目启动时会使用这个数据源
      strict: false  # 严格模式,建议false。如果为true,切换到一个不存在的数据源会抛异常;为false则回退到primary数据源。
      datasource:
        master: # 主数据源,用于管理系统元数据
          driver-class-name: com.mysql.cj.jdbc.Driver
          url: jdbc:mysql://localhost:3306/management_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
          username: root
          password: your_password
  # 如果整合Druid,需要排除默认的Druid自动配置,由dynamic-datasource接管
  autoconfigure:
    exclude: com.alibaba.druid.spring.boot.autoconfigure.DruidDataSourceAutoConfigure

对于Druid连接池的调优参数,我建议不要一开始就堆砌所有配置。可以先使用一组经过验证的、适用于中小并发场景的基础配置,后续根据监控再调整。

# 接在上面的 dynamic 配置之后
      druid:
        initial-size: 5
        min-idle: 5
        max-active: 20
        max-wait: 60000
        test-on-borrow: false
        test-on-return: false
        test-while-idle: true
        validation-query: SELECT 1
        time-between-eviction-runs-millis: 60000
        min-evictable-idle-time-millis: 300000

提示:validation-query 对于MySQL通常是 SELECT 1,对于Oracle可能是 SELECT 1 FROM DUAL。确保它简单高效,仅用于检测连接是否存活。

2.3 设计元数据表

我们的系统需要一个“总指挥部”来记录所有租户的数据源信息。我们在主库(management_db)中创建一张表 sys_tenant_datasource。

CREATE TABLE `sys_tenant_datasource` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `tenant_id` varchar(64) NOT NULL COMMENT '租户唯一标识',
  `tenant_name` varchar(128) DEFAULT NULL COMMENT '租户名称',
  `datasource_name` varchar(64) NOT NULL COMMENT '动态数据源名称(对应poolName)',
  `driver_class_name` varchar(256) DEFAULT 'com.mysql.cj.jdbc.Driver' COMMENT 'JDBC驱动类',
  `url` varchar(512) NOT NULL COMMENT '数据库连接URL',
  `username` varchar(128) NOT NULL COMMENT '数据库用户名',
  `password` varchar(256) NOT NULL COMMENT '数据库密码',
  `status` tinyint(1) DEFAULT '1' COMMENT '状态(1启用,0停用)',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_tenant_id` (`tenant_id`),
  UNIQUE KEY `uk_datasource_name` (`datasource_name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='租户数据源配置表';

对应的JPA实体类(如果使用MyBatis,则是Mapper和实体类)如下:

import javax.persistence.*;
import java.time.LocalDateTime;

@Entity
@Table(name = "sys_tenant_datasource")
public class TenantDataSource {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    @Column(name = "tenant_id", nullable = false, unique = true, length = 64)
    private String tenantId;
    private String tenantName;
    @Column(name = "datasource_name", nullable = false, unique = true, length = 64)
    private String datasourceName;
    private String driverClassName = "com.mysql.cj.jdbc.Driver";
    @Column(nullable = false, length = 512)
    private String url;
    @Column(nullable = false, length = 128)
    private String username;
    @Column(nullable = false, length = 256)
    private String password;
    private Boolean status = true;
    private LocalDateTime createTime;
    private LocalDateTime updateTime;
    // 省略 getter/setter 和构造方法
}

这张表是动态数据源的“注册中心”。系统启动时,以及后续新增租户时,都会根据这里的配置来动态创建或移除数据源。

3. 核心实现:动态数据源的生命周期管理

配置好基础环境后,我们进入核心环节:如何让数据源“动”起来。这包括启动时加载、运行时增删改查以及最重要的——按需切换。

3.1 启动时加载所有租户数据源

项目启动时,我们需要从 sys_tenant_datasource 表中读取所有已启用的租户数据源配置,并将它们注册到 DynamicRoutingDataSource 中。这通过一个 @PostConstruct 方法来实现。

import com.baomidou.dynamic.datasource.DynamicRoutingDataSource;
import com.baomidou.dynamic.datasource.creator.DataSourceCreator;
import com.baomidou.dynamic.datasource.spring.boot.autoconfigure.DataSourceProperty;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;
import javax.sql.DataSource;
import java.util.List;

@Slf4j
@Component
@RequiredArgsConstructor
public class TenantDataSourceLoader implements CommandLineRunner {

    private final DataSource dataSource; // 这里注入的是DynamicRoutingDataSource
    private final DataSourceCreator dataSourceCreator;
    private final TenantDataSourceRepository tenantDataSourceRepo; // 你的Repository或Service

    @Override
    public void run(String... args) {
        log.info("开始初始化租户数据源...");
        List<TenantDataSource> activeDataSources = tenantDataSourceRepo.findByStatus(true);
        DynamicRoutingDataSource ds = (DynamicRoutingDataSource) dataSource;

        for (TenantDataSource config : activeDataSources) {
            try {
                // 1. 构建数据源属性
                DataSourceProperty property = new DataSourceProperty();
                property.setPoolName(config.getDatasourceName()); // 关键:poolName
                property.setDriverClassName(config.getDriverClassName());
                property.setUrl(config.getUrl());
                property.setUsername(config.getUsername());
                property.setPassword(config.getPassword());
                // 可以在这里设置连接池特定参数,如Druid参数
                // property.setDruid(...);

                // 2. 创建数据源并注册
                DataSource tenantDataSource = dataSourceCreator.createDataSource(property);
                ds.addDataSource(property.getPoolName(), tenantDataSource);

                log.info("成功加载租户数据源: {} -> {}", config.getTenantName(), config.getDatasourceName());
            } catch (Exception e) {
                log.error("加载租户数据源失败: {}", config.getDatasourceName(), e);
                // 根据策略决定是否阻断启动:throw new RuntimeException("数据源加载失败", e);
            }
        }
        log.info("租户数据源初始化完成,共加载 {} 个数据源。", activeDataSources.size());
    }
}

使用 CommandLineRunner 或 ApplicationRunner 接口,可以确保在SpringBoot应用完全启动后执行初始化逻辑,比 @PostConstruct 在某些场景下更可靠。

3.2 运行时管理数据源

租户可能会动态增加、或者其数据库连接信息可能变更。我们需要提供API来管理这些数据源。

添加数据源:当新租户注册时,除了在业务表记录租户信息,还需要将其数据源配置入库并动态添加到运行时。

@RestController
@RequestMapping("/admin/datasource")
@RequiredArgsConstructor
public class TenantDataSourceController {

    private final DynamicRoutingDataSource dynamicRoutingDataSource;
    private final DataSourceCreator dataSourceCreator;
    private final TenantDataSourceService dataSourceService;

    @PostMapping
    public ApiResponse<String> addDataSource(@RequestBody @Valid TenantDataSourceDTO dto) {
        // 1. 持久化到数据库
        TenantDataSource savedConfig = dataSourceService.save(dto);

        // 2. 动态添加到当前运行的数据源集合
        DataSourceProperty property = new DataSourceProperty();
        BeanUtils.copyProperties(savedConfig, property);
        property.setPoolName(savedConfig.getDatasourceName());

        DataSource newDataSource = dataSourceCreator.createDataSource(property);
        dynamicRoutingDataSource.addDataSource(property.getPoolName(), newDataSource);

        return ApiResponse.success("数据源添加成功");
    }
}

移除数据源:当租户注销或停用时,需要从运行时移除并关闭其连接池。

    @DeleteMapping("/{datasourceName}")
    public ApiResponse<String> removeDataSource(@PathVariable String datasourceName) {
        // 1. 检查是否有业务正在使用此数据源(可根据实际情况实现)
        // 2. 从动态数据源中移除
        dynamicRoutingDataSource.removeDataSource(datasourceName);
        // 3. 更新数据库状态(如设为停用)
        dataSourceService.disableDataSource(datasourceName);
        return ApiResponse.success("数据源移除成功");
    }

注意:removeDataSource 方法会关闭该数据源对应的连接池。务必确保在执行此操作时,没有正在进行的事务或数据库操作使用该数据源,否则可能导致连接泄漏或错误。

3.3 基于拦截器的自动切换

这是实现多租户透明化的关键。我们需要一个拦截器,在请求进入Controller之前,根据当前请求的租户标识,自动切换到对应的数据源。

首先,我们需要一种方式从请求中获取租户标识。常见做法有:

  • 子域名:tenant1.your-app.com
  • 请求头:X-Tenant-Id: tenant_001
  • 请求路径:/api/tenant/tenant_001/users
  • JWT Token:将租户ID编码在用户认证令牌中。

这里以请求头 X-Tenant-Id 为例,实现一个拦截器。

import com.baomidou.dynamic.datasource.toolkit.DynamicDataSourceContextHolder;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Optional;

@Slf4j
@Component
public class TenantDataSourceInterceptor implements HandlerInterceptor {

    private static final String TENANT_HEADER = "X-Tenant-Id";

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // 1. 从请求头中提取租户ID
        String tenantId = Optional.ofNullable(request.getHeader(TENANT_HEADER))
                                  .orElse("default"); // 或者抛异常,根据业务

        // 2. 根据租户ID,查找或计算出对应的数据源名称 (datasourceName)
        // 这里假设租户ID直接作为数据源名称,或者通过一个简单的服务转换
        String datasourceKey = resolveDataSourceKey(tenantId);

        // 3. 将数据源Key设置到当前线程上下文中
        if (datasourceKey != null) {
            DynamicDataSourceContextHolder.push(datasourceKey);
            log.debug("当前请求 [{}] 已切换到数据源: {}", request.getRequestURI(), datasourceKey);
        } else {
            // 如果找不到对应数据源,可以回退到主数据源或抛出异常
            DynamicDataSourceContextHolder.push("master");
            log.warn("未找到租户 [{}] 对应的数据源,已切换至主数据源。", tenantId);
        }
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        // 请求完成后,务必清理当前线程的数据源上下文,防止内存泄漏和上下文污染
        DynamicDataSourceContextHolder.clear();
        log.debug("清理当前线程数据源上下文。");
    }

    private String resolveDataSourceKey(String tenantId) {
        // 这里可以实现更复杂的逻辑,例如从缓存中查询租户-数据源映射
        // 简单场景下,可以直接用 tenantId 作为 key,前提是你的数据源名称就是tenantId
        return "ds_" + tenantId; // 例如: ds_tenant_001
    }
}

然后,将这个拦截器注册到Spring MVC中。

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    private final TenantDataSourceInterceptor tenantDataSourceInterceptor;

    public WebConfig(TenantDataSourceInterceptor tenantDataSourceInterceptor) {
        this.tenantDataSourceInterceptor = tenantDataSourceInterceptor;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(tenantDataSourceInterceptor)
                .addPathPatterns("/api/**") // 拦截所有API请求
                .excludePathPatterns("/api/auth/**", "/admin/**"); // 排除登录、管理等无需租户隔离的接口
    }
}

这样,所有匹配 /api/** 的请求在进入业务逻辑前,都会自动根据 X-Tenant-Id 请求头切换到正确的租户数据库。业务代码无需任何修改。

4. 进阶议题与生产环境踩坑指南

基础功能跑通只是第一步,要真正用于生产,还必须处理好以下几个棘手问题。

4.1 事务管理的挑战与解决方案

在动态数据源环境下,事务管理变得复杂。Spring的 @Transactional 注解在方法开始时,会从 DataSourceTransactionManager 获取一个连接并绑定到当前线程。如果我们的数据源切换发生在 @Transactional 注解生效之后(例如,在Service方法内部调用 DynamicDataSourceContextHolder.push()),那么事务将仍然使用最初的数据源,导致数据错乱。

解决方案是:确保数据源切换发生在事务开启之前。 我们的拦截器(preHandle)在Controller之前执行,而Spring的声明式事务通常通过AOP在Service方法调用前开启,这两者的顺序至关重要。默认情况下,拦截器的顺序可能早于事务AOP。为了确保万无一失,我们可以:

  1. 明确指定顺序:通过 @Order 注解或实现 Ordered 接口,确保拦截器的优先级高于事务管理器。
  2. 使用Spring的 TransactionSynchronizationManager 进行手动资源管理(不推荐,复杂度高)。
  3. 最稳妥的方案:将租户标识的解析和数据源Key的确定,提前到过滤器(Filter) 或 Spring Security 认证成功之后的环节,因为它们执行顺序更靠前。

一个常见的实践是结合Spring Security,在用户认证成功后,将租户信息存入 SecurityContext 或自定义的线程上下文,然后在事务AOP之前,通过一个BeanPostProcessor或自定义的 AbstractRoutingDataSource 实现(虽然我们用dynamic-datasource,但原理相通)来根据上下文设置数据源。

4.2 连接池配置优化

每个动态数据源都有自己的连接池。如果租户数量很多(比如上百个),每个连接池都保持 minIdle=5,就会产生数百个闲置连接,对数据库造成压力。

优化策略:

  • 按需创建/销毁:对于不活跃的租户,可以考虑在拦截器中判断,如果长时间没有请求,则动态移除其数据源(removeDataSource)。下次请求时再懒加载。这需要一套租户活跃度监控和懒加载机制。
  • 差异化配置:为不同级别的租户(如VIP和普通)配置不同的连接池参数。可以在 sys_tenant_datasource 表中增加字段存储连接池配置(JSON格式),在 DataSourceCreator.createDataSource() 时传入。
  • 共享连接池探索:极端情况下,可以考虑让多个小租户共享一个物理数据库,但使用不同的Schema。这时可以尝试配置一个较大的公共连接池,然后在执行SQL前动态修改连接的Schema(如执行 USE tenant_schema;)。但这需要修改SQL执行层面,dynamic-datasource 默认不直接支持,可能需要自定义扩展。

4.3 多租户下的缓存与上下文隔离

数据源隔离了,但缓存呢?如果你的应用使用了Redis或本地缓存(如Caffeine),必须确保缓存Key也包含租户标识,否则会发生租户间数据泄露。

// 错误的缓存Key,会导致租户A看到租户B的数据
String cacheKey = "user:" + userId;

// 正确的缓存Key
String tenantAwareCacheKey = tenantId + ":user:" + userId;

同样,任何使用 ThreadLocal 存储的上下文信息,在异步任务(如 @Async、消息监听)中都会丢失。你需要使用 TaskDecorator 或 TransmittableThreadLocal(如果使用线程池)来传递租户上下文。

import org.springframework.core.task.TaskDecorator;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class AsyncConfig {

    @Bean("tenantAwareTaskExecutor")
    public ThreadPoolTaskExecutor taskExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        // ... 配置核心线程数等参数
        executor.setTaskDecorator(new TenantAwareTaskDecorator());
        executor.initialize();
        return executor;
    }

    static class TenantAwareTaskDecorator implements TaskDecorator {
        @Override
        public Runnable decorate(Runnable runnable) {
            // 获取当前线程的租户上下文
            String currentTenantId = TenantContextHolder.getCurrentTenantId();
            return () -> {
                try {
                    // 在新线程中设置租户上下文
                    TenantContextHolder.setTenantId(currentTenantId);
                    runnable.run();
                } finally {
                    TenantContextHolder.clear();
                }
            };
        }
    }
}

4.4 监控、日志与问题排查

当系统有几十个动态数据源在运行时,监控和日志变得至关重要。

  • 连接池监控:如果使用Druid,可以为每个动态数据源开启监控。但注意,每个数据源的监控StatViewServlet和WebStatFilter需要独立配置和管理,避免冲突。dynamic-datasource 对Druid监控的支持需要仔细查阅其文档或源码。
  • 统一日志:在所有数据库操作相关的日志中,打印当前数据源Key。你可以通过自定义MyBatis拦截器或使用 dynamic-datasource 自带的 SLF4J 日志功能来实现。
  • 健康检查:Spring Boot Actuator的 /health 端点默认只会检查主数据源。你需要自定义一个 HealthIndicator 来检查所有动态数据源的健康状态。
import org.springframework.boot.actuate.health.Health;
import org.springframework.boot.actuate.health.HealthIndicator;
import org.springframework.stereotype.Component;
import com.baomidou.dynamic.datasource.DynamicRoutingDataSource;
import javax.sql.DataSource;
import java.sql.Connection;
import java.util.Map;

@Component
public class DynamicDataSourceHealthIndicator implements HealthIndicator {

    private final DynamicRoutingDataSource dynamicRoutingDataSource;

    public DynamicDataSourceHealthIndicator(DataSource dataSource) {
        this.dynamicRoutingDataSource = (DynamicRoutingDataSource) dataSource;
    }

    @Override
    public Health health() {
        Map<String, DataSource> dataSources = dynamicRoutingDataSource.getDataSources();
        Map<String, Health> details = new LinkedHashMap<>();
        boolean allUp = true;

        for (Map.Entry<String, DataSource> entry : dataSources.entrySet()) {
            String dsName = entry.getKey();
            try (Connection conn = entry.getValue().getConnection()) {
                if (conn.isValid(2)) { // 2秒超时
                    details.put(dsName, Health.up().build());
                } else {
                    details.put(dsName, Health.down().withDetail("error", "Connection validation failed").build());
                    allUp = false;
                }
            } catch (Exception e) {
                details.put(dsName, Health.down(e).build());
                allUp = false;
            }
        }
        Health.Builder builder = allUp ? Health.up() : Health.down();
        return builder.withDetails(details).build();
    }
}

这套方案从实战中来,也经过了我们多个内部项目的检验。它最大的优势在于平衡了隔离性与开发复杂度,用一套相对清晰的架构,解决了多租户数据访问的核心矛盾。当然,没有银弹,你需要根据自己业务的规模、租户的增长模式以及运维能力,对上述的每一个环节进行细化和调整。比如,当租户量达到数千时,启动时全量加载数据源可能不再合适,你可能需要引入更复杂的懒加载和缓存淘汰机制。但无论如何,理解并掌握 dynamic-datasource 提供的这套动态路由机制,是你构建现代SaaS应用后端架构的重要一步。

别再手动切换数据源了!用ShardingSphere 5.1.1 + dynamic-datasource-spring-boot-starter 3.1.1 实现声明式多数据源路由 本文介绍了如何使用ShardingSphere 5.1.1和dynamic-datasource-spring-boot-starter 3.1.1实现声明式多数据源路由,避免手动切换数据源的繁琐操作。通过注解驱动的方式,简化了多租户隔离、读写分离和分库分表等场景的数据源管理,提升代码简洁性和可维护性。 阅读详情

相关推荐

基于JdbcTemplate与dynamic-datasource实现多租户数据隔离的实战指南

本文详细介绍了基于JdbcTemplate与dynamic-datasource-spring-boot-starter实现多租户数据隔离的实战方案。通过动态切换数据源,为每个租户提供独立的数据库连接,确保数据物理隔离。文章涵盖从快速搭建、@DS注解与SpEL表达式灵活运用,到事务管理、连接池配置等避坑指南,并提供了构建SaaS用户模块的真实业务场景演练,是SpringBoot多租户架构的实用指南。

weixin_29230649的博客 365

dynamic-datasource-spring-boot-starter

dynamic-datasource-spring-boot-starter 是一个基于springboot的快速集成多数据源的启动器。其支持。

顺其自然~专栏 8981

SpringBoot3多数据源配置避坑指南:dynamic-datasource-spring-boot3-starter的正确打开方式

本文详细解析了在SpringBoot3项目中配置多数据源的常见问题与解决方案,重点介绍了如何正确使用dynamic-datasource-spring-boot3-starter组件。针对经典的“Failed to configure a DataSource: ‘url‘ attribute is not specified”错误,文章从依赖选择、YAML配置结构、驱动加载及业务代码注解使用等方面提供了系统的避坑指南,帮助开发者高效完成多数据源集成。

weixin_29248611的博客 274

使用dynamic-datasource-spring-boot-starter动态切换数据源操作数据库(MyBatis-3.5.9)

记录:383 场景:使用dynamic-datasource-spring-boot-starter动态切换数据源,使用MyBatis操作数据库。提供三种示例:一,使用@DS注解作用到类上。二,使用@DS注解作用到方法上。三,不使用注解,使用DynamicDataSourceContextHolder类在方法内灵活切换不同数据源。

zhangbeizhen18的博客 1万+

别再手动切数据源了!SpringBoot整合Dynamic-Datasource 3.5.2,实现动态增删数据源的完整流程

本文详细介绍了SpringBoot整合Dynamic-Datasource 3.5.2实现动态增删数据源的完整流程,包括架构解析、动态注册API实现、多租户场景下的动态管理以及高级特性与性能优化。通过实战案例和代码示例,帮助开发者快速掌握动态数据源管理技术,提升系统弹性和敏捷性。

weixin_29212429的博客 273

dynamic-datasource-spring-boot-starter-v3.5.1.tar.gz

Dynamic-Datasource (opens new window)- 基于 SpringBoot 的多数据源组件,功能强悍,支持 Seata 分布式事务。 支持 数据源分组 ,适用于多种场景 纯粹多库 读写分离 一主多从 混合模式。 支持数据库敏感配置信息 加密(可自定义) ENC()。 支持每个数据库独立初始化表结构schema和数据库database。 支持无数据源启动,支持懒加载数据源(需要的时候再创建连接)。 支持 自定义注解 ,需继承DS(3.2.0+)。 提供并简化对Druid,HikariCp,BeeCp,Dbcp2的快速集成。 提供对Mybatis-Plus,Quartz,ShardingJdbc,P6sy,Jndi等组件的集成方案。 提供 自定义数据源来源 方案(如全从数据库加载)。 提供项目启动后 动态增加移除数据源 方案。 提供Mybatis环境下的 纯读写分离 方案。 提供使用 spel动态参数 解析数据源方案。内置spel,session,header,支持自定义。 支持 多层数据源嵌套切换 。

springboot dynamic-datasource 实现动态切换数据源-多租户-配置文件切换-基于dynamic-datasource

springboot dynamic-datasource 实现动态切换数据源-多租户-配置文件切换

北巷东东的专栏 2692

dynamic-datasource-spring-boot-starter-v3.5.1.zip

Dynamic-Datasource (opens new window)- 基于 SpringBoot 的多数据源组件,功能强悍,支持 Seata 分布式事务。 支持 数据源分组 ,适用于多种场景 纯粹多库 读写分离 一主多从 混合模式。 支持数据库敏感配置信息 加密(可自定义) ENC()。 支持每个数据库独立初始化表结构schema和数据库database。 支持无数据源启动,支持懒加载数据源(需要的时候再创建连接)。 支持 自定义注解 ,需继承DS(3.2.0+)。 提供并简化对Druid,HikariCp,BeeCp,Dbcp2的快速集成。 提供对Mybatis-Plus,Quartz,ShardingJdbc,P6sy,Jndi等组件的集成方案。 提供 自定义数据源来源 方案(如全从数据库加载)。 提供项目启动后 动态增加移除数据源 方案。 提供Mybatis环境下的 纯读写分离 方案。 提供使用 spel动态参数 解析数据源方案。内置spel,session,header,支持自定义。 支持 多层数据源嵌套切换 。

SpringBoot 2.X 整合 druid + dynamic-datasource 多数据源方案

官方文档: dynamic-datasource-spring-boot-starter 一、依赖导入 springboot 2.4.7 druid-spring-boot-starter 1.2.6 dynamic-datasource-spring-boot-starter 3.4.0 <dependency> <groupId>com.alibaba</groupId> &l

李虹柏的博客 8764

MCU工程迁移实战:从STM32到MSPM0L1306的完整指南

在嵌入式系统开发中,MCU工程迁移是开发者常面临的核心挑战,涉及从旧平台向新芯片的完整适配。其原理在于不同MCU在硬件架构、外设寄存器映射、时钟树及开发工具链上存在差异,迁移的本质是将应用逻辑与底层硬件实现解耦。这一过程的技术价值在于提升代码复用性、降低硬件切换成本,并确保产品能快速响应供应链或技术栈变化。典型应用场景包括产品升级换代、芯片缺货替代以及技术生态统一。本文以TI MSPM0L1306为例,详解如何通过对比清单分析、DriverLib API替换及分步调试,高效完成从STM32等平台到Arm C

weixin_27625589的博客 330

保姆级教程:用NX机电概念设计与RobotStudio实现ModbusTCP联合仿真(附完整代码)

本文提供了一份详细的NX机电概念设计与RobotStudio联合仿真实战教程。通过ModbusTCP协议构建数据桥梁,实现机械行为与机器人控制逻辑的双向实时同步。文章从环境搭建、信号配置、RAPID代码编写到联合调试,逐步拆解了实现数字孪生核心链路的关键步骤,并分享了常见问题排查方法,助力工程师在虚拟环境中提前验证产线协同。

sat99的博客 1102

SpringBoot 手动实现动态切换数据源 DynamicSource (中)

dynamic-datasource-spring-boot-starter 是一个基于springboot的快速集成多数据源的启动器。其支持。JPA用户不建议使用,JPA自带事务,无法连续切库。

2509_93923299的博客 910

【现代信号处理】01 -概率论与随机过程回顾

概率论与随机过程回顾 文章目录概率论与随机过程回顾1. 统计模型的相关概念1.1 统计实验(不确定性)1.2 样本点1.3 样本空间Ω1.4 概率1.5.统计模型是先验的2. 概率和统计的差异2.1 联系2.2 差异2.3.1 概率和统计问题的三要素2.3.1.1 model-模型2.3.1.2 data-数据2.3.1.3 decision-决策2.3.2 关系图3. 样本空间的重要性3.1 贝朗特悖论3.1.1 解法一3.1.2 解法二3.1.3 解法三3.2 结论4.概率相关的概念4.1 随机变量4.

qq_41741344的博客 1411

springboot+mybatis plus 数据源真动态切换

解决的都是多数据源支持问题,而非真正的动态数据源。经过几天的研究及调试,终于搞了一个自认为还可以的真正的动态切换数据源的方案,先分享出来,希望对大家有帮助,有更好的解决方案也欢迎指正。​ 在做一个数据库管理的项目时,需要解决的一个问题就是,管理的数据库的数据源是通过页面维护进来的,所以在系统启动时,是无法确定有哪些数据源的。接口方法需要有一个参数来指定数据源的代号,假设为:“dsName”,即需要支持动态数据源切换的接口方法中必须要有dsName这个参数,前端调用的时候,使用的数据源就用这个字段标识。

蜗牛跑的快 1346

深入理解梅尔刻度、梅尔滤波器组和梅尔时频谱图

读取一段音频,使用短时傅里叶变换,得到普通的时频谱图,然后绘制梅尔滤波器组,值得注意的是,librosa的梅尔滤波器组函数还带有权重归一化功能,即对一个三角形滤波器的每个权重,都除以该三角形的面积,如果不希望进行该归一化,设置参数。从公式可见,对数部分可以以自然对数为底数,也可以以10为底数,不同的底数对应不同的系数,要确定当前的系数,只需要代入(1000Hz, 1000mel)即可。其中,m是当前滤波器的序号,表征了当前的时间段,k是当前频率的序号,表征了当前正在对哪一频率的。

DEDSEC_Roger的博客 1万+

5分钟搞定!Unity中Matcap玻璃材质快速实现(含免费贴图资源)

本文详细介绍了在Unity中快速实现Matcap玻璃材质的方法,从技术原理到实战操作,包括Shader编写、参数调节和性能优化。通过Matcap技术,开发者可以高效创建逼真玻璃效果,特别适合移动端和快速迭代项目。文章还提供了免费贴图资源和进阶优化技巧,帮助提升视觉效果和运行效率。

a1b2c的博客 223

使用dynamic-datasource (苞米豆)动态数据源 多数据源自动切换

简介 dynamic-datasource-spring-boot-starter 是一个基于springboot的快速集成多数据源的启动器。 其支持Jdk 1.7+, SpringBoot 1.4.x 1.5.x 2.0.x。 参考文章https://mybatis.plus/guide/dynamic-datasource.htmlhttps://blog.csdn.net/weixi...

qq_37730370的博客 8891

[RK3399][Android7.1] 调试笔记 --- 编译GSL5680 touch提示错误

Platform: RK3399 OS: Android 7.1 Kernel: v4.4.83 现象: 之前在rk3288平台上使用过GSL5680的Touch,现在移植过来一直报如下错误: make[1]: `include/generated/vdso-offsets.h' is up to date. CHK include/generated/compi...

Kris Fei's blog 1056

Java多数据源管理实战:dynamic-datasource-spring-boot-starter详解

在分布式系统架构中,多数据源管理是实现数据库水平扩展的关键技术。其核心原理是通过动态路由机制,在运行时将不同的数据库操作分发到对应的数据源实例。这种技术能有效支持读写分离、分库分表等典型场景,提升系统整体吞吐量和可用性。dynamic-datasource-spring-boot-starter作为SpringBoot生态的轻量级解决方案,通过@DS注解实现声明式数据源切换,大幅降低了多数据源管理的复杂度。该组件与MyBatis-Plus深度整合,支持HikariCP、Druid等主流连接池,在电商系统、多

weixin_32325225的博客 202

Python 爬虫实战:抓取悦动圈跑步爱好者运动轨迹数据,规划健身路线

通过本次 Python 爬虫实战,我们学习了如何使用 Python 抓取悦动圈跑步爱好者的运动轨迹数据,并基于这些数据进行分析和处理,最终规划出健身路线。在这个过程中,我们掌握了requests、BeautifulSoup、pandas和matplotlib等库的基本使用方法,了解了爬虫的基本原理和流程。希望本文能够帮助你更好地理解和应用 Python 爬虫技术,在数据处理和分析领域取得更多的成果。

u014481728的博客 2370

【转录调控网络】代谢组学与其他组学的联合分析经典模式简介

多组学联合分析经典模式转录组学&代谢组学联合分析 转录组学&代谢组学联合分析 转录组是获得生物体内基因表达的重要方法,代谢组是生物体表型的基础和直接体现者。 转录组测序可以得到大量差异表达基因和调控代谢通路,但由于基因与表型之间很难之间关联,导致关键的信号通路难以确定,因此往往达不到预期的研究目的。代谢产物是生物体在内外调控下基因转录的最终结果,是生物体表型的物质基础。 在系统生物学研究时代,生物过程复杂多变,基因调控网络复杂。针对特定的生理、病理等表型进行研究,利用转录组的数据获得大量差异

小哲的博客 6195

Spring Boot 和 MyBatis 环境下实现动态数据源切换

springboot动态切换数据源

码农也有梦想 888

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

java使用dynamic-datasource实现动态数据源切换

确保在同一个事务中使用的所有操作都指向同一个数据源,否则可能会导致事务不一致的问题。是一个流行的Spring Boot Starter,它可以帮助你轻松地在Spring Boot应用程序中实现动态数据源切换。你可以根据需要配置数据源切换的策略,比如基于线程、事务或AOP的切换策略。如果你需要更复杂的配置,比如自定义数据源初始化、连接池配置等,你可以通过实现。请确保你使用的是与你的Spring Boot版本兼容的。文件中配置你的数据源。注解,那么将使用默认的数据源(在上面的配置中是。

xuweilin的博客 1107

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

汉书HE8,好用的汇编代码编写工具

汉书HE8,好用的汇编代码编写工具早期编写汇编代码所用功能强大

Spring Boot中@DS注解实现多数据源动态切换的实战指南

本文详细介绍了在Spring Boot中使用@DS注解实现多数据源动态切换的实战方法。通过配置示例和代码演示,展示了如何简化多数据源管理,提升系统灵活性和维护效率。特别适合需要同时操作多个数据库的Java开发者,涵盖基础配置、注解使用、事务处理及性能优化等关键知识点。

weixin_27330481的博客 231

WINCC7.3破解文件

WINCC7.3硬件够破解文件,有需要的下载!WINCC7.3硬件够破解文件,有需要的下载!

实用开源项目介绍-dynamic datasource for springboot-一个基于springboot的快速集成多数据源的启动器

项目地址 GitHub地址:https://github.com/baomidou/dynamic-datasource-spring-boot-starter 文档地址: https://gitee.com/baomidou/dynamic-datasource-spring-boot-starter/wikis/pages 简介 dynamic-datasource-spring-boot-s...

创新是灵魂,执行是生命。 1168

springboot 中 mybatis-plus 多数据源切换

之前的项目中,要做多数据源,网上的一般思路都是通过AOP 在service或者mapper层做数据源的动态切换,大部分人大概切换数据源代码如下 @Pointcut("execution(* com.gzstrong.cloud.qspj.*.mapper..*.*(..))") private void db1Aspect() { } @Pointcut("exe...

shrek11的专栏 3478
上一篇: RabbitMQ实战:5分钟搞定Docker安装与SpringBoot整合(附避坑指南)
下一篇: 5款主流调度系统UI大PK:Temporal、Airflow、DonpinScheduler谁更适合你的团队?
ruby5
博客等级 码龄15年 29粉丝 893原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值