SpringBoot如何配置数据源？多数据源配置教程

SpringBoot 配置数据源的关键在于分层设计、连接池选型与安全加固

在 SpringBoot 项目中，数据源配置看似简单，却直接决定应用的性能、稳定性与安全性。最优实践是：优先使用 spring.datasource 统一配置，默认采用 HikariCP 连接池，生产环境必须启用配置加密与监控，多数据源场景下使用 @Primary 明确主库。 以下从基础配置、连接池调优、多数据源、安全防护四个维度展开，并给出酷番云场景下的实战经验。

基础配置：从 YAML 到属性绑定

SpringBoot 通过自动装配机制将 spring.datasource 前缀的属性映射到 DataSourceProperties，最简配置如下：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/demo?useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

关键点：

• url 必须携带时区参数，否则高版本 MySQL 驱动会报错。
• driver-class-name 可省略，SpringBoot 会根据 url 自动推断。
• 若使用 JNDI 或外部配置中心，可通过 spring.datasource.jndi-name 指定。

如果使用多环境,建议拆分 application-dev.yml / application-prod.yml，通过 spring.profiles.active 切换。密码不要明文写在配置文件中，至少使用环境变量占位符：

password: ${DB_PASSWORD}

连接池选型与调优：HikariCP 是默认首选

SpringBoot 2.x+ 默认集成 HikariCP，其性能极佳，但默认参数并不适合所有业务，需要按场景调整：

spring:
  datasource:
    hikari:
      minimum-idle: 5
      maximum-pool-size: 20
      connection-timeout: 30000
      idle-timeout: 600000
      max-lifetime: 1800000
      pool-name: MyHikariPool

核心调优原则：

• maximum-pool-size 并非越大越好，根据经验，核心公式为：池大小 = (核心CPU数 2) + 有效存储设备并发数，过量连接反而增加上下文切换开销。
• connection-timeout 应小于数据库侧 wait_timeout，避免连接假死。
• max-lifetime 必须小于数据库连接空闲回收时间，防止被服务端强制断开。

多数据源配置：主从分离与分库场景

当业务需要读写分离或连接多个业务库时,需手动配置多个 DataSource，推荐方式：

1. 定义主数据源和从数据源,主数据源必须用 @Primary 注解，否则 Spring 无法确定默认注入对象。
2. 使用 @ConfigurationProperties 分别绑定不同前缀。

@Bean
@Primary
@ConfigurationProperties("spring.datasource.master")
public DataSource masterDataSource() {
    return DataSourceBuilder.create().build();
}
@Bean
@ConfigurationProperties("spring.datasource.slave")
public DataSource slaveDataSource() {
    return DataSourceBuilder.create().build();
}

此时配置文件中前缀应写为：

spring:
  datasource:
    master:
      url: jdbc:mysql://master-host:3306/db
      username: root
      password: ${MASTER_PASSWORD}
    slave:
      url: jdbc:mysql://slave-host:3306/db
      username: root
      password: ${SLAVE_PASSWORD}

进阶方案： 使用 AbstractRoutingDataSource 实现动态路由，结合 AOP 注解在 Service 层切换数据源，但需注意事务边界事务内部切换数据源无效，因为连接在事务开启时已绑定。

配置安全：加密与外部化存储

生产环境密码明文是重大隐患。推荐两种方案：

• 使用 jasypt-spring-boot 对密码加密，引入依赖后，配置 jasypt.encryptor.password 作为解密密钥，配置文件中使用 ENC(密文)。
• 将配置托管到 Spring Cloud Config 或 Vault，应用启动时动态拉取，不在本地落盘。

通用建议： 数据库账号应遵循最小权限原则，应用账号只授予 DML 权限（SELECT/INSERT/UPDATE/DELETE），禁止使用 root。

酷番云实践经验：从配置到监控的一体化方案

在酷番云部署 SpringBoot 应用时，我们常遇到两个典型问题：内网数据库连接被无故断开、高峰期连接池打满，针对前者，我们利用酷番云的云监控定时检查连接健康状态，并在 HikariCP 中设置 connection-test-query: SELECT 1，同时将 max-lifetime 调整到 1200000ms（小于云数据库默认 wait_timeout），针对后者，我们在酷番云控制台为数据库实例弹性扩容，并配合应用侧限流降级，使连接池水位长期稳定在 60% 以下。

关键经验是：云环境下必须开启 TCP keepalive 和 HikariCP 的 keepalive-time，否则云网络设备可能在空闲期回收连接。

相关问答

问：SpringBoot 2.7 与 3.x 在数据源配置上有什么显著区别？
答：SpringBoot 3.x 要求 Java 17 或更高，且 spring.datasource 的自动配置逻辑基本一致，但底层移除了对 Apache Commons DBCP 和 Tomcat JDBC 的自动支持，HikariCP 成为唯一的默认连接池（若需使用其他池，必须显式排除 Hikari 并引入对应依赖），3.x 中 spring.datasource.password 支持使用 environment 属性，但推荐使用 @ConfigurationProperties 绑定加密配置。

问：生产环境使用连接池时，如何快速定位连接泄漏？
答：HikariCP 提供 leak-detection-threshold 参数，设置该值后，若连接在超出阈值后未归还，日志会输出堆栈信息，例如设置为 60000ms，可捕捉 60 秒以上的占用。建议先在压测环境开启泄漏检测，稳定后再关闭，因为该功能有一定性能开销。 同时在酷番云上可结合日志监控，对 Connection is not available 异常设置告警。

您在实际项目中是否遇到过数据源配置的诡异问题？欢迎在评论区留言，我们将在后续文章中针对热门问题深入拆解，如果本文对您有帮助，请点赞转发，让更多开发者少踩数据源的坑。