MyBatis包扫描需确保类路径存在.class文件且ClassLoader可访问，Spring Boot中应配置mybatis.type-aliases-package而非依赖mybatis-config.xml；别名不区分大小写，但需规避内置别名冲突并防止同名类覆盖。
直接在 mybatis-config.xml 里用 <package name="com.example.domain"></package> 就能批量注册别名，SQL 中写 resultType="User" 就行，不用写全限定类名。但实际常扫不到——关键不在“怎么写”，而在“谁加载、何时加载、路径对不对”。
typeAliasesPackage 在 XML 中写对了，为啥还是报错？
MyBatis 的包扫描不是“配置即生效”，它依赖类路径（classpath）中真实存在的 .class 文件，以及当前 ClassLoader 能否访问到这些类。常见失效原因：
- 实体类没编译进
target/classes对应目录（IDE 没自动构建，或 Maven 编译被跳过） - 包名大小写错误，比如写了
com.example.Model，但实际是com.example.model - 多模块项目中，该包在多个 module 里重复定义，MyBatis 加载的是另一个 classloader 下的副本
- Spring Boot 默认不加载
mybatis-config.xml，XML 里的<package></package>基本无效
Spring Boot 项目，正确配置别名包扫描的方式
别再折腾 XML，改用 Spring Boot 原生配置更可靠：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 在
application.yml或application.properties中加：mybatis.type-aliases-package=com.example.domain - 确保该路径下所有实体类已编译完成（可检查
target/classes/com/example/domain/是否有 .class 文件） - 如果使用 Lombok，确认
@Data等注解已生效，避免因编译失败导致类缺失 - 启动时留意日志：MyBatis 会打印 “Type alias 'User' registered for class com.example.domain.User”，这是成功标志
避免别名冲突的实用建议
包扫描默认用类名小写作别名（User → user），且不区分大小写。若多个包下存在同名类（如 com.a.User 和 com.b.User），后加载的会静默覆盖前者，极易引发映射错乱：
- 团队规范：禁止跨包使用相同简单类名（例如统一用
UserInfo/UserEntity区分） - 关键类显式注册别名：
<typealias alias="AdminUser" type="com.a.User"></typealias> - 缩小扫描范围：只扫
com.example.domain.user，而非整个com.example.domain - 实体类上加
@Alias("admin")注解，优先级高于包扫描，且明确可控
别名大小写和内置别名要注意什么？
MyBatis 别名本身不区分大小写：resultType="user"、"User"、"USER" 都能匹配到同一个类。但注意：
- 内置别名（如
string、integer、map）会覆盖自定义别名，避免用这些词作类名 - 别名默认是类名小写形式，但你也可以在
@Alias注解或<typealias></typealias>中指定任意字符串 - XML 中
parameterType和resultType都支持别名，无需额外声明
