mybatis主配置文件mybatis-config.xml必须以标准XML声明和DTD约束开头,根元素为;需通过外置数据库参数,指定默认环境并配置事务与数据源,正确注册映射器。

MyBatis 的主配置文件 mybatis-config.xml 是整个框架运行的起点,它定义了数据源、事务、类型别名、映射器等核心行为。配置不复杂但容易忽略细节,关键是要结构正确、属性引用清晰、环境匹配真实场景。
必须的文档声明和根节点
开头必须包含标准的 XML 声明与 DTD 约束,否则 MyBatis 无法解析:
<?xml version="1.0" encoding="UTF-8"?>- 根元素只能是
<configuration></configuration>,所有其他配置都必须嵌套在它内部
数据库连接参数建议外置到 properties 文件
把 driver、url、username、password 等敏感或易变配置抽离到 src/main/Resources/db.properties 中更安全也更灵活:
- db.properties 示例:
jdbc.driver=com.mysql.cj.jdbc.Driverjdbc.url=jdbc:mysql://localhost:3306/mydb?usessl=false&characterEncoding=utf8&serverTimezone=Asia/Shanghaijdbc.username=rootjdbc.password=123456 - 在 mybatis-config.xml 中引入:
<properties resource="db.properties"></properties> - 后续直接用
${jdbc.url}这类占位符引用,优先级高于 XML 内<Property></property>直接定义的同名值
environments 环境配置要明确 default 和 id
一个项目常有 dev/test/prod 多套环境,<environments default="development"></environments> 指定默认激活的环境块:
一款非常漂亮的茶叶网站,以绿色为主调,页面干净清洁、一目了然,非常适合茶叶店的朋友。mttshop打造精致、简单、易用、免费的商城系统要求:IIS5.1以后,必须安装.net 3.5安装步骤:1、下载完成后,直接解压文件mb001.rar2、附加数据库:解压后的可以找一个叫db.rar的文件,解压后直接附加就可以,支持SQL 2000、2005、20083、配置web.config文件,找到4、后
0 - 每个
<environment id="development"></environment>必须包含<transactionmanager type="JDBC"></transactionmanager> -
<datasource type="POoled"></datasource>是最常用的数据源类型,支持连接池;也可选 UNPOOLED(每次新建连接)或 JNDI(容器托管) - 里面的
<property name="driver" value="${jdbc.driver}"></property>等,就是前面 properties 加载进来的值
mappers 映射器注册不能遗漏
Mapper 接口和 XML 文件(或注解 SQL)必须被 MyBatis 扫描到,否则查询会报 “Invalid bound statement”:
- 推荐用包扫描方式(简洁不易漏):
<mappers><package name="com.example.mapper"></package></mappers> - 如果用 XML 显式注册,路径必须准确:
<mapper resource="mapper/UserMapper.xml"></mapper>(路径基于 classpath) - 确保 XML 文件名与 Mapper 接口名一致,且 Namespace 等于接口全限定名
基本上就这些。只要 DTD 正确、properties 加载到位、environments 有 default 且能连通、mappers 能扫到,MyBatis 就能正常启动。其余如 typeAliases、settings、plugins 属于按需增强项,初期可暂不配置。