Spring 數據源配置完全指南：JNDI、Properties、Druid/HikariCP、事務管理一站式實戰

Spring 數據源配置完全指南

數據源是持久層的心臟。本文系統覆蓋 JNDI 容器級配置、Properties 外部化配置、主流連接池 (Druid/HikariCP/C3P0) 整合、SessionFactory 構建、聲明式事務管理 五大塊，提供生產級 XML 與 Java Config 雙版本。

一、方案一：JNDI 容器管理數據源 (推薦生產)

優勢：應用與數據源解耦、容器統一連接池監控、多應用共享池、密碼不落應用代碼。

1. 容器配置

<!-- Tomcat context.xml (全局) 或 META-INF/context.xml (單應用) -->
<Resource name="jdbc/myDS" auth="Container" type="javax.sql.DataSource"
    driverClassName="com.mysql.cj.jdbc.Driver"
    url="jdbc:mysql://db:3306/myapp?useSSL=false&serverTimezone=UTC"
    username="app_user" password="secret"
    maxTotal="50" maxIdle="20" maxWaitMillis="10000"
    validationQuery="SELECT 1" testOnBorrow="true" />

2. Spring 引用

<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">
    <property name="jndiName" value="java:comp/env/jdbc/myDS"/>
    <property name="proxyInterface" value="javax.sql.DataSource"/>
    <property name="lookupOnStartup" value="false"/> <!-- 延遲查找，啟動快 -->
</bean>

二、方案二：Properties 外部化 + 連接池 Bean (通用開發/測試)

1. jdbc.properties

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/myapp?useSSL=false&serverTimezone=UTC
jdbc.username=dev
jdbc.password=dev123
jdbc.pool.maxActive=20
jdbc.pool.maxIdle=10
jdbc.pool.initialSize=5

2. Spring XML 配置

<context:property-placeholder location="classpath:jdbc.properties" ignore-unresolvable="true"/>

<!-- Druid (推薦生產) -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
    <property name="driverClassName" value="${jdbc.driver}"/>
    <property name="url" value="${jdbc.url}"/>
    <property name="username" value="${jdbc.username}"/>
    <property name="password" value="${jdbc.password}"/>
    <property name="maxActive" value="${jdbc.pool.maxActive}"/>
    <property name="minIdle" value="${jdbc.pool.maxIdle}"/>
    <property name="initialSize" value="${jdbc.pool.initialSize}"/>
    <property name="validationQuery" value="SELECT 1"/>
    <property name="testOnBorrow" value="true"/>
    <property name="filters" value="stat,wall,log4j2"/> <!-- 監控、防 SQL 注入、日誌 -->
</bean>

<!-- HikariCP (Spring Boot 2+ 默認，性能最強) -->
<bean id="dataSource" class="com.zaxxer.hikari.HikariDataSource">
    <property name="driverClassName" value="${jdbc.driver}"/>
    <property name="jdbcUrl" value="${jdbc.url}"/>
    <property name="username" value="${jdbc.username}"/>
    <property name="password" value="${jdbc.password}"/>
    <property name="maximumPoolSize" value="${jdbc.pool.maxActive}"/>
    <property name="minimumIdle" value="${jdbc.pool.maxIdle}"/>
</bean>

三、MyBatis / Hibernate SessionFactory 整合

<!-- MyBatis SqlSessionFactory -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/>
    <property name="mapperLocations" value="classpath:mapper/*.xml"/>
    <property name="typeAliasesPackage" value="com.app.domain"/>
    <property name="configurationProperties">
        <props>
            <prop key="mapUnderscoreToCamelCase">true</prop>
            <prop key="cacheEnabled">true</prop>
        </props>
    </property>
</bean>

<!-- Mapper 掃描器 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="com.app.mapper"/>
    <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>

四、聲明式事務管理 (AOP + XML / @Transactional)

<!-- 事務管理器 -->
<bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource" ref="dataSource"/>
</bean>

<!-- TX Advice 定義規則 -->
<tx:advice id="txAdvice" transaction-manager="txManager">
    <tx:attributes>
        <tx:method name="get*" read-only="true"/>
        <tx:method name="find*" read-only="true"/>
        <tx:method name="query*" read-only="true"/>
        <tx:method name="select*" read-only="true"/>
        <tx:method name="save*" propagation="REQUIRED" rollback-for="Exception"/>
        <tx:method name="insert*" propagation="REQUIRED" rollback-for="Exception"/>
        <tx:method name="update*" propagation="REQUIRED" rollback-for="Exception"/>
        <tx:method name="delete*" propagation="REQUIRED" rollback-for="Exception"/>
        <tx:method name="*" propagation="REQUIRED" rollback-for="Exception"/> <!-- 兜底 -->
    </tx:attributes>
</tx:advice>

<!-- AOP 切面織入 -->
<aop:config>
    <aop:pointcut id="serviceMethods" expression="execution(* com.app.service..*.*(..))"/>
    <aop:advisor advice-ref="txAdvice" pointcut-ref="serviceMethods"/>
</aop:config>

<!-- 或註解驅動 (推薦現代項目) -->
<tx:annotation-driven transaction-manager="txManager"/>

五、Java Config 版本 (Spring Boot 風格)

@Configuration
@MapperScan("com.app.mapper")
@EnableTransactionManagement
public class DataSourceConfig {
    @Value("${jdbc.url}") String url;
    @Value("${jdbc.username}") String user;
    @Value("${jdbc.password}") String pwd;
    @Value("${jdbc.driver}") String driver;

    @Bean(destroyMethod = "close")
    public DataSource dataSource() {
        HikariDataSource ds = new HikariDataSource();
        ds.setJdbcUrl(url); ds.setUsername(user); ds.setPassword(pwd); ds.setDriverClassName(driver);
        ds.setMaximumPoolSize(20); ds.setMinimumIdle(5);
        return ds;
    }

    @Bean public SqlSessionFactory sqlSessionFactory(DataSource ds) throws Exception {
        SqlSessionFactoryBean fb = new SqlSessionFactoryBean();
        fb.setDataSource(ds);
        fb.setMapperLocations(new PathMatchingResourcePatternResolver().getResources("classpath:mapper/*.xml"));
        return fb.getObject();
    }

    @Bean public DataSourceTransactionManager txManager(DataSource ds) {
        return new DataSourceTransactionManager(ds);
    }
}

六、連接池選型決策表

數據源配置核心原則：生產優先 JNDI 或 HikariCP，監控必上 Druid/Actuator，事務規則按業務語義定義，配置外部化，密碼加密。