前言：配置文件的重要性

在MyBatis江湖中，mybatis-config.xml就是整個框架的"總指揮部"。這個配置文件雖然體積不大，卻掌管著數據源、事務、類型轉換等核心命脈。今天我們就來扒一扒這個XML文件的十八般武藝，從青銅到王者配置全解析！

一、配置項分類詳解（武器庫大點兵）

1. 環境配置（environments）

這是整個配置文件的戰略要地，相當于軍隊的作戰指揮部：

<environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></dataSource></environment>
</environments>

核心組件：

• transactionManager：事務管家（JDBC/MANAGED兩種模式）
• dataSource：數據源大本營（UNPOOLED/POOLED/JNDI三種類型）
• property：數據庫連接的四大金剛（驅動、URL、用戶名、密碼）

2. 類型別名（typeAliases）

給Java類型起"江湖綽號"的快捷方式：

<typeAliases><!-- 單個注冊 --><typeAlias type="com.example.User" alias="AwesomeUser"/><!-- 包掃描注冊（推薦） --><package name="com.example.model"/>
</typeAliases>

使用場景：

• Mapper XML中直接使用resultType="AwesomeUser"
• 避免寫全限定類名的繁瑣

3. 插件配置（plugins）

給MyBatis裝上"外掛"的神奇接口：

<plugins><plugin interceptor="com.github.pagehelper.PageInterceptor"><property name="helperDialect" value="mysql"/></plugin>
</plugins>

經典應用：

• 分頁插件（PageHelper）
• 性能監控插件
• 自定義攔截器（實現Interceptor接口）

4. 其他重要配置

<settings><!-- 開啟駝峰命名自動轉換 --><setting name="mapUnderscoreToCamelCase" value="true"/><!-- 延遲加載總開關 --><setting name="lazyLoadingEnabled" value="true"/>
</settings><typeHandlers><!-- 自定義類型處理器 --><typeHandler handler="com.example.JsonTypeHandler"/>
</typeHandlers>

二、多環境配置實戰（分身術秘籍）

場景：開發/測試/生產三套環境

<environments default="dev"><environment id="dev"><!-- 開發環境配置 --></environment><environment id="test"><!-- 測試環境配置 --></environment><environment id="prod"><!-- 生產環境配置 --></environment>
</environments>

環境切換的兩種姿勢

1. 硬編碼切換（不推薦）：

<environments default="test">  <!-- 直接修改default值 -->

2. 動態參數化切換（推薦）：

<!-- 通過JVM參數指定 -->
-Dmybatis.environment=prod<!-- 配置文件讀取 -->
<property name="env" value="${mybatis.environment}"/>
<environments default="${env}">

三、屬性文件外置化（乾坤大挪移）

1. 基礎外置化

<properties resource="jdbc.properties"/>

jdbc.properties內容：

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mydb

2. 屬性優先級規則

<properties resource="base.properties"><!-- 命令行參數優先級最高 --><property name="jdbc.url" value="${cmd.jdbc.url}"/><!-- 系統屬性次之 --><property name="jdbc.username" value="${sys.db.user}"/><!-- 配置文件最低 -->
</properties>

3. 占位符的高級玩法

<dataSource type="POOLED"><!-- 字符串拼接 --><property name="url" value="${db.protocol}://${db.host}:${db.port}/${db.name}"/>
</dataSource>

四、配置優化技巧（武林秘籍）

1. 環境隔離原則：

   • 開發環境用UNPOOLED（簡單快速）
   • 生產環境用POOLED（連接池優化）
   • 云環境考慮JNDI（容器管理）

2. 安全加固：

   • 生產環境密碼加密存儲
   • 使用<property name="password" value="${jdbc.password:default_pwd}"/>設置默認值

3. 性能調優：

   <dataSource type="POOLED"><!-- 連接池核心參數 --><property name="poolMaximumActiveConnections" value="100"/><property name="poolMaximumIdleConnections" value="20"/>
   </dataSource>
   

五、常見坑點排查（避坑指南）

1. 環境切換失效：

   • 檢查default屬性是否正確
   • 確認沒有同時使用Spring的@Profile注解

2. 屬性未加載：

   • 檢查文件路徑是否在classpath下
   • 確認屬性名沒有拼寫錯誤

3. 類型別名沖突：

   • 包掃描時不同包存在同名類
   • 解決方案：使用注解顯式指定別名

結語：配置即代碼

通過精心配置mybatis-config.xml，我們不僅能掌控MyBatis的核心行為，更能為項目搭建起靈活可靠的架構基礎。記住：好的配置是項目成功的基石，但過度配置則是災難的開始。建議根據項目實際需求，在靈活性與可維護性之間找到最佳平衡點。

下期預告： 《Mapper映射文件全解析》

最后送大家一句配置真言：“配置宜簡不宜繁，外置當用則用，環境必分則分”。快去優化你的MyBatis配置吧，讓這個持久層框架在你的項目中發揮最大威力！