mybatis-plus-join-boot-starter

### 3.1 确保依赖版本兼容性 在使用 `mybatis-plus-join-boot-starter` 时，若无法进行 `leftJoin` 联表查询，首先需要检查依赖版本是否正确。引入的 `mybatis-plus-join-boot-starter` 版本应为 1.4.4，且与 `mybatis-plus-spring-boot3-starter` 的版本保持一致，以确保联表查询功能正常运行。同时，为避免 `mybatis-spring-boot-starter` 与 `mybatis-plus-spring-boot3-starter` 出现版本冲突，建议将 `mybatis-spring-boot-starter` 设置为可选依赖： ```xml <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.0.3</version> <optional>true</optional> </dependency> ``` 这样可以确保 MyBatis-Plus 的自动配置优先于 Spring Boot 的默认配置，从而支持联表查询功能[^1]。 ### 3.2 使用 LambdaQueryWrapper 构建 LEFT JOIN 查询 `mybatis-plus-join-boot-starter` 提供了 `LambdaQueryWrapper` 的扩展方法，允许通过链式调用构建 `LEFT JOIN` 查询。例如，若需从 `user` 表左连接 `user_role` 和 `role` 表，可使用如下代码： ```java LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper .select(User::getId, User::getName) .leftJoin(UserRole.class, UserRole::getUserId, User::getId) .leftJoin(Role.class, Role::getId, UserRole::getRoleId); List<User> users = userMapper.selectList(queryWrapper); ``` 上述代码会生成包含 `LEFT JOIN` 的 SQL 语句，并且只选择 `User` 表中的 `id` 和 `name` 字段。如果 `leftJoin` 方法缺失或无法调用，可能是因为未正确引入 `mybatis-plus-join-boot-starter`，或者当前使用的 `LambdaQueryWrapper` 并非该扩展库提供的版本。 ### 3.3 检查 Mapper 接口与实体类映射 联表查询失败的另一个常见原因是实体类与数据库表结构映射不匹配。确保每个实体类使用 `@TableName` 注解绑定对应的数据库表名，并且字段使用 `@TableId` 和 `@TableField` 注解进行映射。例如： ```java @Data @TableName("user") public class User { @TableId(value = "id", type = IdType.AUTO) private Long id; @TableField("name") private String name; } ``` 如果查询结果为空或字段映射错误，可能是由于字段名不一致或未正确指定别名所致。建议在 `select` 方法中明确指定需要查询的字段，并在实体类中使用 `@TableField(value = "column_name")` 明确绑定字段名。 ### 3.4 启用 MyBatis-Plus Join 功能 `mybatis-plus-join-boot-starter` 依赖默认会自动启用联表查询功能，但需确保 `MyBatisPlusJoinAutoConfiguration` 被正确加载。可以在启动类或配置类中添加如下配置，以确保扫描到 `@Mapper` 接口并启用联表查询支持： ```java @Configuration @MapperScan("com.example.mapper") public class MyBatisConfig { } ``` 如果 `@MapperScan` 注解缺失，可能导致 Mapper 接口未被注册为 Spring Bean，进而导致联表查询功能无法使用。 ### 3.5 调试 SQL 生成与执行 若联表查询返回结果为空或不符合预期，可以通过日志打印生成的 SQL 语句进行调试。在 `application.yml` 中开启 MyBatis-Plus 的 SQL 日志输出： ```yaml logging: level: com.example.mapper: debug ``` 查看日志中实际执行的 SQL 是否包含正确的 `LEFT JOIN` 子句和字段选择。例如，使用 `leftJoin` 方法构建的查询应生成类似以下的 SQL： ```sql SELECT user.id, user.name FROM user LEFT JOIN user_role ON user.id = user_role.user_id LEFT JOIN role ON user_role.role_id = role.id; ``` 若生成的 SQL 缺少 `LEFT JOIN` 子句或字段选择错误，说明 `LambdaQueryWrapper` 使用方式存在问题，需检查 `.leftJoin()` 和 `.select()` 方法的调用顺序和参数是否正确。 ### 3.6 避免字段名冲突与别名映射 在多表联表查询中，若多个表存在相同字段名（如 `id`、`name`），可能会导致字段映射混乱。建议使用 `.select()` 明确指定需要查询的字段，并在实体类中使用别名或自定义字段名映射。例如： ```java queryWrapper .select(User::getId, User::getName) .leftJoin(Role.class, Role::getId, UserRole::getRoleId) .select(Role::getName, role -> role.get("role_name")); ``` 也可以在实体类中使用 `@TableField(value = "role_name")` 明确指定字段别名，以避免字段名冲突问题。 ###

### 3.1 引入依赖 在使用 `mybatis-plus-join-boot-starter` 进行关联查询之前，需要在 `pom.xml` 文件中引入相应的依赖。通常需要引入 `mybatis-plus-boot-starter` 和 `mybatis-plus-join-boot-starter` 两个依赖包，以支持多表关联查询功能。 ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> </dependency> <dependency> <groupId>com.github.yulichang</groupId> <artifactId>mybatis-plus-join-boot-starter</artifactId> <version>1.4.13</version> </dependency> ``` ### 3.2 使用 LambdaQueryWrapper 进行关联查询 `mybatis-plus-join-boot-starter` 提供了增强的 `LambdaQueryWrapper`，支持多表关联查询，包括 `leftJoin`、`innerJoin` 等连接方式。以下是一个使用 `LambdaQueryWrapper` 进行多表关联查询的示例： 假设存在三张表：用户表（`User`）、角色表（`Role`）和用户角色关联表（`UserRole`）。通过 `leftJoin` 方法构建左连接查询，获取用户及其对应的角色信息： ```java public List<User> getUsersWithRoles() { LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper .select(User::getId, User::getName) // 指定查询的用户字段 .leftJoin(UserRole.class, UserRole::getUserId, User::getId) // 左连接用户角色表 .leftJoin(Role.class, Role::getId, UserRole::getRoleId); // 左连接角色表 return userMapper.selectList(queryWrapper); } ``` 在上述示例中，`leftJoin` 方法接受三个参数：关联的实体类、关联表的字段以及主表的字段。通过这种方式，可以构建出基于 Lambda 表达式的多表连接查询逻辑，避免字段名的硬编码问题，提高代码的可读性和可维护性。 ### 3.3 添加查询条件 如果需要在查询中添加额外的过滤条件，可以在 `LambdaQueryWrapper` 中使用 `.eq()`、`.like()` 等方法进行条件拼接。例如，筛选出特定角色的用户信息： ```java queryWrapper .select(User::getId, User::getName) .leftJoin(UserRole.class, UserRole::getUserId, User::getId) .leftJoin(Role.class, Role::getId, UserRole::getRoleId) .eq(Role::getName, "Admin"); // 添加角色名称为 Admin 的筛选条件[^2] ``` ### 3.4 分页查询 在实际开发中，多表关联查询通常需要结合分页功能。MyBatis-Plus 提供了 `Page` 类用于实现分页查询，结合 `LambdaQueryWrapper` 可以轻松实现分页查询功能： ```java Page<User> page = new Page<>(1, 10); // 查询第一页，每页10条记录 IPage<User> userPage = userMapper.selectPage(page, queryWrapper); List<User> users = userPage.getRecords(); // 获取分页后的用户列表[^3] ``` ### 3.5 动态条件查询 在某些场景下，可能需要根据不同的条件动态构建查询语句。可以通过 `LambdaQueryWrapper` 的 `.and()` 或 `.or()` 方法实现动态条件拼接。例如，根据角色名称动态筛选用户： ```java String roleName = "Admin"; LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper .select(User::getId, User::getName) .leftJoin(UserRole.class, UserRole::getUserId, User::getId) .leftJoin(Role.class, Role::getId, UserRole::getRoleId) .if(StringUtils.isNotBlank(roleName), wrapper -> wrapper.eq(Role::getName, roleName)); // 动态添加角色名称条件[^3] ``` ### 3.6 多表关联查询的注意事项 - **字段选择**：建议使用 `.select()` 方法明确指定需要查询的字段，避免不必要的数据传输。 - **性能优化**：多表关联查询可能会影响查询性能，特别是在数据量较大的情况下，建议通过索引优化或数据库设计提升查询效率。 - **联表限制**：MyBatis-Plus 的 `LambdaQueryWrapper` 联表查询功能适用于简单的联表场景，对于复杂的 SQL 查询，建议结合自定义 SQL 实现。 ### 3.7 多表关联查询的扩展应用 在某些场景下，可能需要通过子查询或自定义 SQL 来实现更复杂的多表关联逻辑。MyBatis-Plus 支持通过 `.apply()` 方法直接嵌入 SQL 片段，从而实现更加灵活的查询逻辑： ```java queryWrapper .select(User::getId, User::getName) .apply("user_role.role_id = role.id") .eq("role.name", "Admin");[^2] ``` 通过 `.apply()` 方法，可以直接在查询条件中嵌入 SQL 表达式，适用于复杂的查询场景。 ###