在 Spring 框架中配置數據源（DataSource）主要有兩種方式：
- 通過 Setter 注入配置數據源
- 通過 jdbc.properties 配置文件方式
本博文將使用 Druid 作為數據源，其在 Spring 項目中常見且高效。
Druid 被廣泛認為是性能最佳的連接池之一，尤其在高并發場景下表現優異。它支持快速的連接獲取和釋放，優化了資源管理
🌱 1. 通過 Setter 注入配置 Druid 數據源
? 1.1 Maven 依賴
<dependency><groupId>com.alibaba</groupId><artifactId>druid</artifactId><version>1.2.24</version> <!-- 請根據項目需要選擇版本 -->
</dependency>
? 1.2 XML 配置
修改 applicationContext.xml 文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"><!-- Druid 數據源配置 --><bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" destroy-method="close"><property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/mydb"/><property name="username" value="root"/><property name="password" value="root"/><!-- Druid 特有屬性 --><property name="initialSize" value="5"/><property name="minIdle" value="5"/><property name="maxActive" value="20"/><property name="maxWait" value="60000"/><property name="timeBetweenEvictionRunsMillis" value="60000"/><property name="minEvictableIdleTimeMillis" value="300000"/><property name="validationQuery" value="SELECT 1"/><property name="testWhileIdle" value="true"/><property name="testOnBorrow" value="false"/><property name="testOnReturn" value="false"/></bean><!-- JdbcTemplate 配置 --><bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate"><property name="dataSource" ref="dataSource"/></bean></beans>
? 1.3 Java Config 配置 （推薦方式）
import com.alibaba.druid.pool.DruidDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jdbc.core.JdbcTemplate;import javax.sql.DataSource;@Configuration
public class DataSourceConfig {@Bean(destroyMethod = "close") // 指定關閉方法，釋放資源public DataSource dataSource() {DruidDataSource dataSource = new DruidDataSource();dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver");dataSource.setUrl("jdbc:mysql://localhost:3306/mydb");dataSource.setUsername("root");dataSource.setPassword("root");// Druid 特有屬性dataSource.setInitialSize(5);dataSource.setMinIdle(5);dataSource.setMaxActive(20);dataSource.setMaxWait(60000);dataSource.setTimeBetweenEvictionRunsMillis(60000);dataSource.setMinEvictableIdleTimeMillis(300000);dataSource.setValidationQuery("SELECT 1");dataSource.setTestWhileIdle(true);dataSource.setTestOnBorrow(false);dataSource.setTestOnReturn(false);return dataSource;}@Beanpublic JdbcTemplate jdbcTemplate(DataSource dataSource) {return new JdbcTemplate(dataSource);}
}
🗂? 2. 通過 jdbc.properties 文件配置 Druid 數據源（推薦用于生產環境）
? 2.1 jdbc.properties 文件
# MySQL數據庫配置
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mydb
jdbc.username=root
jdbc.password=root
? 2.2 XML 配置
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:context="http://www.springframework.org/schema/context"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd"><!--1.開啟命名空間--><!--2.使用 context 空間加載 properties 文件--><!-- <context:property-placeholder location="jdbc.properties" system-properties-mode="NEVER"/><context:property-placeholder location="jdbc.properties,jdbc2.properties" system-properties-mode="NEVER"/><context:property-placeholder location="*.properties" system-properties-mode="NEVER"/><context:property-placeholder location="classpath:*.properties" system-properties-mode="NEVER"/> --><!--加載最全的方式，除了本項目路徑下的 properties，還可以加載 jar 包下的properties --><context:property-placeholder location="classpath*:*.properties" system-properties-mode="NEVER"/><!--3.使用屬性占位符 ${} 加載 properties 文件內容--><bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"><property name="driverClassName" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></bean><bean id="userDao" class="com.alivinfer.dao.impl.UserDaoImpl"><property name="name" value="${jdbc.driver}"/></bean>
</beans>
💡 注意：
使用property-placeholder標簽需要引入以下命名空間：
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd"
? 2.3 Java Config 配置 （推薦方式）
import com.alibaba.druid.pool.DruidDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
import org.springframework.core.env.Environment;
import org.springframework.jdbc.core.JdbcTemplate;import javax.annotation.Resource;
import javax.sql.DataSource;@Configuration
@PropertySource("classpath:jdbc.properties") // 引入 properties 文件
public class DataSourceConfig {@Resourceprivate Environment env;@Bean(destroyMethod = "close")public DataSource dataSource() {DruidDataSource dataSource = new DruidDataSource();dataSource.setDriverClassName(env.getProperty("jdbc.driver"));dataSource.setUrl(env.getProperty("jdbc.url"));dataSource.setUsername(env.getProperty("jdbc.username"));dataSource.setPassword(env.getProperty("jdbc.password"));dataSource.setInitialSize(Integer.parseInt(env.getProperty("druid.initialSize")));dataSource.setMinIdle(Integer.parseInt(env.getProperty("druid.minIdle")));dataSource.setMaxActive(Integer.parseInt(env.getProperty("druid.maxActive")));dataSource.setMaxWait(Long.parseLong(env.getProperty("druid.maxWait")));dataSource.setTimeBetweenEvictionRunsMillis(Long.parseLong(env.getProperty("druid.timeBetweenEvictionRunsMillis")));dataSource.setMinEvictableIdleTimeMillis(Long.parseLong(env.getProperty("druid.minEvictableIdleTimeMillis")));dataSource.setValidationQuery(env.getProperty("druid.validationQuery"));dataSource.setTestWhileIdle(Boolean.parseBoolean(env.getProperty("druid.testWhileIdle")));dataSource.setTestOnBorrow(Boolean.parseBoolean(env.getProperty("druid.testOnBorrow")));dataSource.setTestOnReturn(Boolean.parseBoolean(env.getProperty("druid.testOnReturn")));return dataSource;}@Beanpublic JdbcTemplate jdbcTemplate(DataSource dataSource) {return new JdbcTemplate(dataSource);}
}
? 測試代碼
package com.alivinfer;import org.junit.jupiter.api.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;import javax.sql.DataSource;public class SpringTest {/*** 測試 xml 配置 druid 數據源*/@Testpublic void test() {// 獲取 IoC 容器ApplicationContext applicationContext = newClassPathXmlApplicationContext("applicationContext.xml");// 測試 druid 數據源DataSource dataSource = (DataSource) applicationContext.getBean("dataSource");System.out.println(dataSource);}}
🕶? Druid 數據源優勢
? 高效：相比 DriverManagerDataSource，Druid 提供更高的并發性能和更好的連接池管理
? 穩定：支持 SQL 監控、慢 SQL 記錄、防 SQL 注入、異常日志跟蹤等特性
? 易用：通過配置文件實現靈活的參數調整，方便不同環境下的使用
💡 常見問題
-
Druid 日志過多：
- 在
jdbc.properties中添加以下配置可減少不必要的日志：
druid.logAbandoned=false druid.removeAbandoned=false - 在
-
com.mysql.cj.jdbc.Driver 找不到：
- 確保
mysql-connector-java版本兼容，并檢查URL是否包含serverTimezone參數：
jdbc.url=jdbc:mysql://localhost:3306/mydb?serverTimezone=UTC - 確保
-
數據庫連接泄漏：
- 啟用
removeAbandoned功能，自動關閉超時未關閉的連接：
druid.removeAbandoned=true druid.removeAbandonedTimeout=1800 - 啟用
📌 總結
| 配置方式 | 優點 | 缺點 | 推薦使用場景 |
|---|---|---|---|
| Setter 注入 (XML/Java Config) | 簡單直觀，便于理解 | 配置寫在代碼中，生產環境不推薦 | 小型項目、快速開發、臨時測試 |
| jdbc.properties 文件 (XML/Java Config) | 配置與代碼解耦、支持環境切換、易于維護 | 需要維護額外的配置文件，但在中大型項目中是必要的 | 企業級項目、生產環境、靈活配置 |
推薦使用：
- 在 企業項目 和 生產環境 中，推薦使用 jdbc.properties 文件方式結合 Java Config，確保代碼簡潔、配置靈活，充分利用 Druid 的性能優勢和監控功能
