对 MyBatis 的 Mapper 进行单元测试时，通常会模拟数据库环境或使用嵌入式数据库（如 H2）来执行真实的 SQL 测试。以下是进行单元测试的常见方式和步骤：

方式一：使用 H2 嵌入式数据库（推荐）

这种方式可以模拟真实环境，执行 SQL 语句，适合 Mapper 测试。

步骤：

1. 添加依赖（以 Maven 为例）：

<dependency>
  <groupId>com.h2database</groupId>
  <artifactId>h2</artifactId>
  <scope>test</scope>
</dependency>

2. 配置测试用的 MyBatis 配置文件或使用 Spring Boot 的 application-test.yml：

spring:
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa
    password:
  mybatis:
    mapper-locations: classpath*:mapper/**/*.xml
    type-aliases-package: com.example.entity

3. 初始化测试数据：

可在测试启动前运行 schema.sql 和 data.sql 脚本，或使用 @Sql 注解：

@Sql(scripts = {"/schema.sql", "/data.sql"})

4. 编写测试类：

@SpringBootTest
@RunWith(SpringRunner.class)
public class UserMapperTest {

    @Autowired
    private UserMapper userMapper;

    @Test
    public void testSelectById() {
        User user = userMapper.selectById(1);
        Assertions.assertNotNull(user);
        Assertions.assertEquals("Tom", user.getName());
    }
}

方式二：使用 Mockito + MyBatis-Plus（适合只测试逻辑）

如果只关心业务逻辑，可以使用 Mockito 模拟 Mapper 接口：

@ExtendWith(MockitoExtension.class)
public class UserServiceTest {

    @Mock
    private UserMapper userMapper;

    @InjectMocks
    private UserService userService;

    @Test
    public void testGetUserById() {
        User user = new User(1, "Alice");
        Mockito.when(userMapper.selectById(1)).thenReturn(user);

        User result = userService.getUserById(1);
        Assertions.assertEquals("Alice", result.getName());
    }
}

小贴士：

• XML 映射文件记得放在 test/resources/mapper 或用 @MapperScan 扫描路径。
• 可使用 DBUnit 或 Flyway 进行测试数据管理。
• 如果使用 Spring Boot，可以用 @MybatisTest 注解简化测试配置。

总结：

相关文章：

SpringBoot项目里如何自定义一个自己的Starter? springboot项目里如何使用mybatisplus实现mysql数据库的读写分离？ MyBatis 如何处理关联查询（如一对一、一对多、多对多）？ Java如何连接OceanBase数据库并实现增删改查？ MyBatis 中如何在查询中传入多个参数？ MyBatis 中如何使用类型别名（TypeAliases）？它有什么优势？ MyBatis 如何自定义插件？MyBatis 插件的原理是什么？ 在 Spring Boot 中使用 Hibernate，有哪些自动配置项？