使用mybatis出现java.lang.IndexOutOfBoundsException: Index: 5, Size: 5

<think>好的，用户遇到了MyBatis中的IndexOutOfBoundsException错误，具体是Index 2, Size 2。我需要结合之前提供的引用信息来找出可能的原因和解决方案。 首先，查看用户提供的引用内容。引用1提到，当MyBatis设置参数时，如果构造器参数数量和SQL参数不匹配，会引发类似的异常。引用2中的错误是在一对多查询时出现的，可能与结果映射有关。引用3和4都指出，使用Lombok注解不当，特别是缺少构造方法或使用了@Builder导致的问题。 现在用户的具体错误是索引2越界，但大小只有2。可能的情况是，MyBatis在映射结果时，尝试访问第三个元素（索引2），但结果集只有两个字段。这可能是因为实体类的属性数量与查询返回的列数不一致，或者构造方法的问题。 接下来需要分析可能的原因。首先，检查SQL查询返回的列数是否与接收实体类的属性数量匹配。如果查询返回了3列，但实体类只有2个属性，或者反之，就会导致索引越界。其次，Lombok注解使用不当，如使用了@Builder但没有提供无参构造器，导致MyBatis无法正确创建对象实例。此外，如果实体类没有正确的构造方法，MyBatis可能尝试通过字段名映射，但数量不匹配时也会出错。 解决方案方面，首先要核对SQL查询的字段和实体类属性是否一一对应，数量是否一致。然后检查Lombok注解，确保添加了@NoArgsConstructor和@AllArgsConstructor，避免使用@Builder单独存在。如果问题依旧，可能需要显式定义构造方法或调整resultMap的映射配置。 最后，用户可能需要具体的步骤来排查问题，比如检查SQL字段数、检查实体类属性、检查Lombok注解，以及调试时的日志分析。确保回答结构清晰，逐步引导用户解决问题，并引用相关的引用资料来支持建议。</think>### 解决 MyBatis 中 `IndexOutOfBoundsException: Index 2, Size 2` 的详细分析与方案 #### 一、问题本质分析 `java.lang.IndexOutOfBoundsException: Index: 2, Size: 2` 表明 MyBatis 在尝试访问集合的第3个元素（索引从0开始），但实际集合只有2个元素。结合 MyBatis 的底层逻辑和引用中的案例，此问题通常由以下原因引发： 1. **实体类构造方法与查询字段不匹配** - MyBatis 默认通过**字段顺序**或**构造器参数顺序**映射查询结果到实体类。 - 若 SQL 查询返回的列数与实体类构造器参数数量不一致，会触发索引越界[^1][^4]。 2. **Lombok 注解使用不当** - 使用了 `@Builder` 但未显式定义无参构造器或全参构造器，导致 MyBatis 无法正确实例化对象[^3][^4]。 - `@Data` 生成的默认构造器可能不满足 MyBatis 反射需求。 3. **ResultMap 配置错误** - 若手动配置了 `<resultMap>`，但字段映射顺序或数量与查询结果不一致。 --- #### 二、具体排查步骤与解决方案 ##### 1. **检查 SQL 查询字段与实体类属性** **问题示例**： ```sql SELECT field1, field2, field3 FROM table WHERE ... ``` 若实体类仅有 `field1` 和 `field2` 两个属性，但查询返回了 `field3`，则会因字段数量不匹配导致索引越界。 **修复方法**： - **方案1**：调整 SQL 查询字段，使其与实体类属性严格对应。 - **方案2**：在实体类中补充缺失的属性字段。 --- ##### 2. **修正 Lombok 注解配置** **错误配置**： ```java @Data @Builder public class YourEntity { private String field1; private String field2; } ``` `@Builder` 会覆盖默认构造器，导致 MyBatis 无法通过反射创建对象实例。 **正确配置**： ```java @Data @NoArgsConstructor // 必须显式声明无参构造器 @AllArgsConstructor // 确保全参构造器存在 @Builder public class YourEntity { private String field1; private String field2; } ``` --- ##### 3. **验证 ResultMap 映射** 若使用了自定义 `<resultMap>`，需检查字段顺序和数量： ```xml <resultMap id="yourMap" type="YourEntity"> <result column="sql_field1" property="field1"/> <result column="sql_field2" property="field2"/> </resultMap> ``` 确保 `<result>` 标签数量与 SQL 查询字段完全一致。 --- ##### 4. **调试与日志分析** - **开启 MyBatis 日志**： 在 `application.yml` 中配置： ```yaml logging: level: org.mybatis: DEBUG ``` 观察日志中 SQL 实际返回的字段数量与类型。 - **检查堆栈信息**： 根据错误日志定位到具体报错的 `<resultMap>` 或 Mapper 方法。 --- #### 三、案例模拟与修复 **场景复现**： ```java // 实体类（错误配置） @Data @Builder public class User { private Long id; private String name; } // Mapper 接口 @Select("SELECT id, name, age FROM user WHERE id = #{id}") User getUserById(Long id); ``` 查询返回3列（`id`, `name`, `age`），但 `User` 类只有2个属性，导致 MyBatis 尝试映射第3列时触发 `IndexOutOfBoundsException`。 **修复操作**： 1. **补充缺失字段**： ```java @Data @NoArgsConstructor @AllArgsConstructor @Builder public class User { private Long id; private String name; private Integer age; // 新增字段 } ``` 2. **调整 SQL 查询**（可选）： ```sql SELECT id, name FROM user WHERE id = #{id} ``` --- #### 四、关键结论 | 原因类型 | 解决方案 | |-----------------------|--------------------------------------------------------------------------| | 字段数量不匹配 | 确保 SQL 查询字段与实体类属性一一对应 | | Lombok 注解缺失 | 显式添加 `@NoArgsConstructor` 和 `@AllArgsConstructor`，避免单独使用 `@Builder` | | ResultMap 配置错误 | 检查 `<resultMap>` 标签的字段顺序和数量 | --- #### 五、扩展建议 - **避免依赖字段顺序映射**：建议使用 `<resultMap>` 显式定义映射关系，而非依赖默认顺序。 - **谨慎使用 Lombok**：复杂场景下可手动编写构造器，避免注解冲突。 ---