如何使用Specification映射关联实体属性 报无法定位属性错误如何解决

你遇到的Unable to locate Attribute with the the given name错误是Spring Data JPA Specification的常见报错，问题根源是JPA无法在你指定的实体中找到你调用的属性，常见原因和对应解决方法如下：

• 属性名拼写/大小写不匹配
  JPA Specification检索属性基于实体类的Java字段名而非数据库列名，且Java大小写敏感。请确认你在root.get()中传入的属性名，和实体类中定义的成员变量名完全一致，包括大小写。例如实体字段为addressDetail，错写为address_detail或者AddressDetail都会触发该错误。
• 嵌套关联属性未提前关联
  如果你要筛选的是主实体关联的地址实体中的字段，不能直接把嵌套路径作为参数传入get()方法，需要先关联对应的关联实体再取字段，示例如下：

// 错误写法
root.get("address.city");

// 正确写法
Join<你的主实体类, Address> addressJoin = root.join("address");
// 用关联对象取地址实体的字段做筛选
predicateList.add(cb.equal(addressJoin.get("city"), 目标筛选城市));

• 实体属性缺少JPA注解
  检查主实体类是否添加了@Entity注解，关联的地址属性是否添加了@OneToOne/@ManyToOne等合法的JPA关联注解，未添加注解的字段不会被JPA识别为持久化属性，也会触发该错误。
• 静态元模型未正确生成
  如果你使用JPA静态元模型编写Specification，需要确认静态元模型已正确生成，对应的属性常量存在，且导入的元模型包路径正确。

内容的提问来源于stack exchange，提问作者Igor Vinicius