MyBatis-Plus 查询不到数据，但使用 SQL 可以查询到数据的问题排查

目录

前言

一、问题描述

示例代码

二、排查步骤

1. 检查数据源配置

2. 检查实体类与数据库表结构

3. 检查 Mapper 接口

4. 检查 MyBatis-Plus 配置

5. 排查查询条件

6. 检查日志输出

7. 检查数据库连接问题

8. 检查全局配置和插件

三、解决方案

---

前言

        在开发过程中，有时会遇到一个奇怪的问题：使用 MyBatis-Plus 查询不到数据，而直接执行 SQL 查询却能够获取到数据。这种情况可能会让人感到困惑，这篇博客将详细介绍如何排查和解决这个问题。

一、问题描述

当我们在使用MyBatis-Plus进行查询时，明明知道数据库中存在满足条件的数据，但查询结果却为空。与此同时，使用相同的查询条件直接在数据库中执行SQL语句，却能成功获取数据。这种情况的出现，让我们对MyBatis-Plus的查询功能产生了疑惑。

示例代码

// 使用MyBatis-Plus的查询方法 List users = userMapper.selectList(null);
System.out.println(users); // 输出为空列表

 

而在数据库客户端执行以下 SQL 语句可以正确返回数据：

SELECT * FROM user;

二、排查步骤

1. 检查数据源配置

首先，确保 MyBatis-Plus 的数据源配置正确。检查 application.yml 或 application.properties 文件中的数据库连接配置是否与实际使用的数据库相符。

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database_name
    username: your_username
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver

2. 检查实体类与数据库表结构

确保实体类的字段与数据库表中的列名一致，且类型匹配。如果字段名称或类型不一致，MyBatis-Plus 可能无法正确映射查询结果。

@Data
public class User {
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

3. 检查 Mapper 接口

确认 Mapper 接口的配置正确，并且继承了 BaseMapper 接口。MyBatis-Plus 依赖 Mapper 接口来生成 SQL 语句。

public interface UserMapper extends BaseMapper {
}

4. 检查 MyBatis-Plus 配置

确保 MyBatis-Plus 的配置文件正确加载，并且没有错误配置，例如全局过滤器、SQL 拦截器等可能影响查询结果的设置。

配置文件示例（application.yml）：

mybatis-plus:
  mapper-locations: classpath:/mapper/*.xml
  type-aliases-package: com.example.demo.entity

5. 排查查询条件

如果 selectList 方法带有查询条件，需确认查询条件是否正确。可以尝试使用无条件查询（如上例的 null）来排除条件问题。

QueryWrapper queryWrapper = new QueryWrapper();
queryWrapper.eq("name", "John");
List users = userMapper.selectList(queryWrapper);

6. 检查日志输出

启用 MyBatis-Plus 的 SQL 日志输出，可以帮助查看生成的 SQL 语句是否正确。可以在 application.yml 中配置日志级别。

yml
logging:
  level:
    com.baomidou.mybatisplus: debug

通过日志，你可以看到 MyBatis-Plus 实际生成并执行的 SQL 语句，进一步分析问题。

7. 检查数据库连接问题

确保 MyBatis-Plus 使用的数据库连接与直接执行 SQL 查询所使用的连接指向同一个数据库实例。有时，开发环境和测试环境可能存在混淆。

8. 检查全局配置和插件

如果项目中使用了全局配置或插件（如分页插件、乐观锁插件等），需要确认这些插件不会影响到正常的查询操作。

三、解决方案

1. 修正数据源配置：确保配置文件中的数据库连接信息正确无误。
2. 调整实体类和表结构：确保实体类字段与数据库表列名和类型一致。
3. 确认 Mapper 接口配置：确保 Mapper 接口继承了 BaseMapper，并且配置正确。
4. 检查查询条件：如果使用了查询条件，确保条件正确无误。
5. 启用 SQL 日志：通过日志查看 MyBatis-Plus 实际生成的 SQL 语句，帮助分析问题。
6. 统一数据库连接：确保所有操作使用的是同一个数据库实例。