MyBatis如何根据配置实现多环境下数据库名动态切换

完全不需要用grep批量修改XML文件，MyBatis本身就支持和JPA一致的配置化能力，推荐按优先级选择以下方案：

方案1：移除SQL中的库名硬编码（最推荐，零额外配置） #

绝大多数场景下你SQL里写的some_database就是当前数据源默认连接的库，直接删掉库名前缀即可，把SQL改成：

SELECT ... FROM some_table WHERE ...

不同环境的数据源连接URL本来就会配置对应环境的库名，比如开发环境连接project库、云环境连接project_cloud库，执行SQL时会自动路由到对应库下的表，和JPA的使用逻辑完全一致，从根源上避免硬编码问题。

注意：这个方案符合「一次构建，多环境部署」的交付原则，同一个制品不需要任何修改就能部署到所有环境，不会出现改漏、改错的问题。

方案2：MyBatis配置变量替换（适合同实例跨库查询场景） #

如果你的SQL确实需要带库名前缀（比如同个数据库实例下要访问其他业务库的表），直接用MyBatis内置的配置属性替换能力即可：

1. 在不同环境的Spring配置文件中定义对应库名，比如application-project.yml（本地环境）添加配置：

mybatis:
  configuration-properties:
    biz_db_schema: project

application-project_cloud.yml（云环境）添加配置：

mybatis:
  configuration-properties:
    biz_db_schema: project_cloud

2. 在Mapper XML中直接引用配置变量替换硬编码的库名：

SELECT ... FROM ${biz_db_schema}.some_table WHERE ...

这里有两个关键注意点：

• 必须用${}引用变量，不能用#{}：${}是MyBatis加载配置时直接做常量替换，不会加单引号，不存在SQL注入风险（变量值来自本地配置，不是用户传入参数）；#{}是预编译参数占位符，会给值包裹单引号，最终拼出的SQL会出现语法错误。
• 不需要修改任何Java代码，Spring启动时会自动加载当前激活环境对应的配置值注入到MyBatis中。

方案3：多数据源场景直接路由数据源 #

如果是多数据源的场景，不需要在SQL里写库名区分：

• 给每个数据源配置独立的SqlSessionFactory，指定对应的Mapper扫描路径
• 不同数据源的连接URL直接配置对应环境的目标库
• 对应路径下的Mapper XML直接写表名即可，执行SQL时会自动走匹配的数据源连接，和JPA多数据源的使用体验完全一致。

内容的提问来源于stack exchange，提问作者test failed in 1.08s