“No primary or single unique constructor found for interface java.util.List”问题原因及解决

你的名字 2024-03-23 17:18 71阅读 0赞

###### 问题原因： ######

这个错误通常出现在使用 MyBatis 查询结果映射时，MyBatis 无法找到适合的构造方法来将查询结果转换为指定的 Java 对象。具体来说，错误信息 "No primary or single unique constructor found for interface java.util.List" 意味着 MyBatis 在将查询结果转换为 List 类型对象时遇到了问题，因为它无法找到一个合适的构造方法来实例化 List 对象。

而导致这些问题有以下几种原因：

1.  **错误的映射类型：** 在 MyBatis 的映射文件中，可能将结果集映射为了 `java.util.List` 类型，但实际上 MyBatis 不能直接将结果集映射为 List 类型，因为 List 是一个接口，不能直接实例化。解决方法是将映射类型改为一个具体的 Java 类型，例如 `com.yourpackage.YourEntityClass`。
2.  **缺少合适的构造方法：** 如果实体类（例如 `YourEntityClass`）没有提供无参构造方法，同时 MyBatis 也无法找到合适的构造方法来匹配查询结果的列，就会出现这个错误。
3.  **构造方法参数匹配问题：** 如果实体类中的构造方法参数和查询结果的列不匹配，也会导致这个错误。请确保实体类的构造方法参数顺序和类型与查询结果的列一一对应。
4.  **自定义结果映射问题：** 如果使用了自定义的结果映射（ResultMap），请确保配置正确，并且没有产生冲突。

###### 解决方法： ######

*  确认 MyBatis 映射文件中的结果映射配置是否正确，特别是对应实体类是否正确。
 *  确认实体类是否提供了无参构造方法，并且构造方法参数是否正确匹配查询结果的列。
 *  确认查询的 SQL 语句是否正确，列名是否和实体类的属性名匹配。

--------------------

###### 本人解决的步骤： ######

以上是网上搜集的一些解决办法，而我在经过问题排查后发现是因为自己在mapper层为加@PathVariable注解。

![d6d3a1ac07524329bc4ce815ab38b7b9.png][]

###### 不添加该注解导致错误的原因： ######

`@PathVariable注解的作用：`在Controller层的方法中，参数注解 `@PathVariable` 用于将URL路径中的变量提取出来，并绑定到方法的参数上。它告诉Spring MVC框架该参数值应该从URL路径中获取，而不是从请求的请求体（Request Body）中获取。

当在Controller层的方法参数上使用 `@PathVariable` 注解时，Spring MVC会尝试根据URL路径的占位符名称来匹配方法参数的名称，从而将URL路径中的变量值传递给方法参数。如果在使用 `@PathVariable` 注解时，没有在方法参数上添加该注解，Spring MVC将无法正确识别URL路径中的变量，从而导致找不到匹配的方法签名，进而报错 "No primary or single unique constructor found for interface java.util.List"。

举个例子，这里我有一个URL路径 `/delete/1,2,3`，其中 `1,2,3` 是要删除的ids。在Controller层的方法中，如果没有使用 `@PathVariable` 注解，Spring MVC会默认从请求体中获取参数，但请求体中并没有ids参数，所以就会报错找不到匹配的方法签名。

使用 `@PathVariable` 注解时，要确保注解的参数名与URL路径中的占位符名称一致，这样Spring MVC才能正确地将URL路径中的变量传递给方法参数。

[d6d3a1ac07524329bc4ce815ab38b7b9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/9ae628c51de44c7892dba6910bcf2af5.png