前言：配置文件的重要性

在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配置吧，让这个持久层框架在你的项目中发挥最大威力！