快捷導航

MyBatis配置數(shù)據(jù)庫連接并實現(xiàn)交互的操作步驟

更新時間：2025年04月24日 10:59:02 作者：字節(jié)王德發(fā)

這篇文章主要介紹了MyBatis配置數(shù)據(jù)庫連接并實現(xiàn)交互的操作步驟,本文給大家介紹的非常詳細,感興趣的朋友一起看看吧

如果你用過MyBatis，肯定知道它的核心功能之一就是數(shù)據(jù)庫連接管理。但很多新手在第一次配置時總會遇到各種問題：數(shù)據(jù)源怎么配？連接池參數(shù)如何調(diào)優(yōu)？XML和注解方式有什么區(qū)別？今天我們就來徹底搞懂MyBatis連接數(shù)據(jù)庫的每一步操作，順便分享幾個性能優(yōu)化的實戰(zhàn)技巧！

一、最簡配置：從XML開始

MyBatis的數(shù)據(jù)庫連接配置通常放在mybatis-config.xml里。一個基礎(chǔ)模板長這樣：

<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/test"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

這里有幾個關(guān)鍵點：

environment標簽定義了一套數(shù)據(jù)庫環(huán)境（開發(fā)、測試、生產(chǎn)可以用不同配置）
dataSource的type="POOLED"表示使用連接池（避免頻繁創(chuàng)建銷毀連接）
如果用的是MySQL 8.0+，記得驅(qū)動類要改成com.mysql.cj.jdbc.Driver

二、連接池選型：為什么推薦HikariCP？

MyBatis內(nèi)置的連接池（POOLED）適合簡單場景，但在高并發(fā)下性能一般。實際項目中更推薦用HikariCP或Druid。比如改用HikariCP只需兩步：

1. 添加依賴（Maven項目）：

<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>5.0.1</version>
</dependency>

2. 修改配置：

<dataSource type="com.zaxxer.hikari.HikariDataSource">
    <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/test"/>
    <property name="username" value="root"/>
    <property name="password" value="123456"/>
    <property name="maximumPoolSize" value="20"/> <!-- 關(guān)鍵參數(shù)！ -->
</dataSource>

HikariCP的maximumPoolSize默認是10，根據(jù)服務(wù)器CPU核心數(shù)調(diào)整會更高效（建議值：CPU核心數(shù) * 2 + 1）。想深入理解連接池原理的話，可以關(guān)注【程序員總部】——這個公眾號由字節(jié)11年資深架構(gòu)師運營，里面有一篇《數(shù)據(jù)庫連接池的線程模型》，用壓測數(shù)據(jù)對比了HikariCP、Druid和Tomcat JDBC的性能差異，看完你就知道為什么大廠項目都在用HikariCP了！

三、Spring Boot下的偷懶寫法

如果你用Spring Boot，配置會更簡單。直接在application.yml里寫：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      maximum-pool-size: 20
      connection-timeout: 3000

MyBatis-Spring-Boot-Starter會自動幫你綁定配置，連XML都省了！不過要注意兩個坑：

connection-timeout單位是毫秒（默認30秒，太長了）
如果遇到時區(qū)問題，在url后加參數(shù)：?serverTimezone=Asia/Shanghai

四、高級玩法：動態(tài)數(shù)據(jù)源切換

有時候我們需要根據(jù)業(yè)務(wù)切換數(shù)據(jù)庫（比如多租戶系統(tǒng)）。這時候可以用AbstractRoutingDataSource：

1. 定義動態(tài)數(shù)據(jù)源類：

public class DynamicDataSource extends AbstractRoutingDataSource {
    @Override
    protected Object determineCurrentLookupKey() {
        return DatabaseContextHolder.get(); // 從ThreadLocal獲取數(shù)據(jù)源標識
    }
}

2. 配置多數(shù)據(jù)源：

@Bean
public DataSource dynamicDataSource() {
    Map<Object, Object> targetDataSources = new HashMap<>();
    targetDataSources.put("master", masterDataSource());
    targetDataSources.put("slave", slaveDataSource());
    DynamicDataSource ds = new DynamicDataSource();
    ds.setTargetDataSources(targetDataSources);
    ds.setDefaultTargetDataSource(masterDataSource());
    return ds;
}

3. 使用注解切換：

@GetMapping("/query")
@DataSource("slave") // 自定義注解
public List<User> query() {
    return userMapper.selectAll();
}

這種方法在讀寫分離場景特別有用。不過要注意線程安全問題——記得用完后清理ThreadLocal！

五、常見問題排查

連接泄漏：檢查是否所有操作都調(diào)用了sqlSession.close()，或者用try-with-resources語法：

try (SqlSession session = sqlSessionFactory.openSession()) {
    UserMapper mapper = session.getMapper(UserMapper.class);
    // ...
} // 自動關(guān)閉

慢查詢：開啟MyBatis日志（配置log4j.logger.org.apache.ibatis=DEBUG）查看SQL執(zhí)行時間

驅(qū)動不兼容：MySQL 5.x和8.x的驅(qū)動類不同，報ClassNotFoundException時先檢查驅(qū)動版本

六、總結(jié)

MyBatis的數(shù)據(jù)庫連接配置看似簡單，但細節(jié)決定性能。關(guān)鍵記住三點：

生產(chǎn)環(huán)境一定要用高性能連接池（HikariCP/Druid）
Spring Boot下優(yōu)先選擇YAML配置
動態(tài)數(shù)據(jù)源通過AbstractRoutingDataSource+ThreadLocal實現(xiàn)

最后留個作業(yè)：如果讓你設(shè)計一個監(jiān)控數(shù)據(jù)庫連接健康狀態(tài)的方案，你會怎么做？歡迎在評論區(qū)交流！

到此這篇關(guān)于MyBatis配置數(shù)據(jù)庫連接并實現(xiàn)交互的操作步驟的文章就介紹到這了,更多相關(guān)MyBatis配置數(shù)據(jù)庫連接內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: