解决Spring Data JPA异常：未找到类型的属性

Kahen大约 3 分钟

解决Spring Data JPA异常：未找到类型的属性

在这篇简短的文章中，我们将解释如何修复Spring Data JPA异常_"PropertyReferenceException: 未找到类型的属性"_。

首先，我们将解释导致此异常的主要原因。然后，我们将通过实际示例说明如何重现它，以及如何修复它。

2. 原因

在深入了解细节之前，让我们尝试理解异常的含义。

"未找到类型的属性"的堆栈跟踪简单地告诉我们，未找到指定的属性。当Spring Data无法访问不存在或未定义的属性时，会抛出此异常。

通常，Spring Data根据派生查询方法的名称自动生成SQL查询。因此，导致异常的最常见原因是使用无效属性定义查询方法。

另一个原因可能是在访问属性时拼写属性名称错误。

3. 重现异常

现在我们知道了异常的含义，让我们看看如何在实践中重现它。

例如，让我们考虑_Person_实体类：

@Entity
public class Person {
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;
    private String firstName;
    private String lastName;

    // 标准getter和setter
}

现在，让我们为我们的_Person_类创建一个Spring Data JPA仓库：

@Repository
public interface PersonRepository extends JpaRepository`<Person, Integer>` {
}

接下来，我们将添加一个按名字查询人的查询方法。但是，让我们假设我们拼错了_firstName_属性。

例如，让我们写成_firsttName_：

Person findByFirsttName(String lastName);

现在，如果我们启动Spring Boot应用程序，我们会得到：

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'personRepository' defined in com.baeldung.nopropertyfound.repository.PersonRepository ...
...
Caused by: java.lang.IllegalArgumentException: Failed to create query for method public abstract com.baeldung.nopropertyfound.model.Person com.baeldung.nopropertyfound.repository.PersonRepository.findByFirsttName(java.lang.String)!
No property 'firsttName' found for type 'Person'; Did you mean 'firstName'
...
Caused by: org.springframework.data.mapping.PropertyReferenceException: No property 'firsttName' found for type 'Person'; Did you mean 'firstName'
...

正如我们在日志中看到的，Spring Boot因_"PropertyReferenceException: 未找到Person类型的'firsttName'属性"_而失败。

Spring Data在启动时自动检查生成的SQL查询是否有效。

由于我们使用的属性不存在(firsttName)，Spring Data无法生成SQL查询，因此出现了异常。

4. 解决案

修复异常的唯一方法是：在定义查询方法时使用确切的属性名称。

因此，要修复这个问题，我们需要将_findByFirsttName()重命名为_findByFirstName()。

Person findByFirstName(String firstName);

现在，让我们通过一个测试用例来确认一切按预期工作：

@Test
void givenQueryMethod_whenUsingValidProperty_thenCorrect() {

    Person person = personRepository.findByFirstName("Azhrioun");

    assertNotNull(person);
    assertEquals("Abderrahim", person.getLastName());
}