滚雪球学MyBatis-Plus(14)：常见问题与解决方案

bug菌¹

已于 2024-09-06 09:36:09 修改

阅读量625

点赞数 25

分类专栏： # 滚雪球学MyBatis-Plus 文章标签：零基础入门教学 mybatis-plus 零基础入门

于 2024-09-06 09:35:59 首次发布

本文链接：https://blog.csdn.net/weixin_43970743/article/details/141028909

版权

滚雪球学MyBatis-Plus 专栏收录该内容

15 篇文章 3 订阅

订阅专栏

前言

在上期内容中，我们详细介绍了如何编写单元测试和集成测试，以确保代码的正确性和可靠性。我们还讨论了项目的打包与部署流程，帮助你将开发的应用程序顺利发布到生产环境中。通过这些步骤，你可以保证项目的高质量和稳定运行。

本期内容将重点介绍 MyBatis Plus 在实际开发中常见的问题及其解决方案。尽管 MyBatis Plus 提供了丰富的功能和便捷的操作，但在使用过程中仍可能遇到各种问题。通过本期内容，你将学会如何解决这些常见问题，确保项目的顺利进行。

一、常见问题及解决方案

1. 依赖冲突问题

问题描述：在引入 MyBatis Plus 依赖后，项目启动时报错，提示依赖冲突。

解决方案：使用 dependencyManagement 统一管理依赖版本，避免依赖冲突。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.0</version>
        </dependency>
        <!-- 其他依赖版本管理 -->
    </dependencies>
</dependencyManagement>

2. 数据库连接失败

问题描述：项目启动时报错，提示无法连接到数据库。

解决方案：

检查数据库配置是否正确，包括 URL、用户名和密码。
确保数据库服务已启动，并且网络连接正常。
确认驱动程序版本与数据库版本兼容。

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mybatis_plus_demo?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
    username: root
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver

3. 数据库表未找到

问题描述：查询数据时报错，提示数据库表未找到。

解决方案：

确认数据库中已创建相应的表。
确认实体类的 @TableName 注解与数据库表名一致。
检查数据库配置中的表名前缀是否正确。

@TableName("user")
public class User {
    // 字段定义
}

4. MyBatis Plus 配置未生效

问题描述：配置分页插件或乐观锁插件后，发现配置未生效。

解决方案：

确认配置类已被 Spring 管理，添加 @Configuration 注解。
确认插件配置方法上添加了 @Bean 注解。
确认应用程序启动类扫描了配置类所在的包。

@Configuration
public class MyBatisPlusConfig {

    @Bean
    public PaginationInterceptor paginationInterceptor() {
        return new PaginationInterceptor();
    }

    @Bean
    public OptimisticLockerInterceptor optimisticLockerInterceptor() {
        return new OptimisticLockerInterceptor();
    }
}

5. 分页查询无效

问题描述：使用分页插件进行分页查询时，返回的结果未分页。

解决方案：

确认分页插件已配置并生效。
在分页查询方法中，使用 MyBatis Plus 提供的 Page 对象作为参数。

public IPage<User> findAll(Page<User> page) {
    return userMapper.selectPage(page, null);
}

6. 乐观锁失效

问题描述：使用乐观锁更新数据时，发现乐观锁未生效。

解决方案：

确认实体类中添加了 @Version 注解，并指定了版本字段。
确认乐观锁插件已配置并生效。

@TableName("user")
public class User {
    @TableId
    private Long id;
    private String name;
    private Integer age;
    private String email;
    @Version
    private Integer version;
}

7. 自定义 SQL 无效

问题描述：使用自定义 SQL 注解进行查询时，发现查询无效或报错。

解决方案：

确认自定义 SQL 注解的 SQL 语法正确。
确认 Mapper 接口已被 Spring 管理，添加 @Mapper 注解。
确认应用程序启动类扫描了 Mapper 接口所在的包。

@Mapper
public interface UserMapper extends BaseMapper<User> {

    @Select("SELECT * FROM user WHERE age > #{age}")
    List<User> selectUsersOlderThan(Integer age);
}

8. 多数据源配置无效

问题描述：配置多数据源后，发现切换数据源无效。

解决方案：

确认多数据源配置正确，并在 application.yml 中定义所有数据源。
确认使用了正确的数据源切换注解或编程方式进行数据源切换。

spring:
  datasource:
    dynamic:
      primary: master
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/mybatis_plus_master?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
          username: root
          password: your_password
          driver-class-name: com.mysql.cj.jdbc.Driver
        slave:
          url: jdbc:mysql://localhost:3306/mybatis_plus_slave?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
          username: root
          password: your_password
          driver-class-name: com.mysql.cj.jdbc.Driver