Spring Boot JPA查询报错:prices字段SIMPLE_PROPERTY需标量参数

问题根因 #

异常已经明确指出错误来源：你在ItemRepository中定义的findAllByPrices方法不符合Spring Data JPA的命名规则。没有加In后缀时，JPA默认会按照「prices属性等于传入参数」的逻辑生成查询，但prices是集合类型，不能直接匹配List类型的参数，所以抛出了需要标量参数的错误。
你之前尝试修改集合类型为Set、调整关联的FetchType都没有命中问题核心，自然无法解决报错。

解决方案 #

方案1：最小改动适配现有逻辑 #

仅修改ItemRepository的方法名，添加In后缀即可解决启动报错，该后缀代表查询prices属性包含传入列表中任意元素的Item：

public interface ItemRepository extends JpaRepository<Item, Long>, JpaSpecificationExecutor<Item> {
    Page<Item> findAllByPricesIn(List<Price> prices, Pageable pageable);
}

注意：该方案存在性能缺陷，需要先全量查询符合价格区间的Price再关联查Item，数据量大时效率极低；且同一个Item如果有多个符合条件的Price会重复返回，需要额外做去重处理。

方案2：关联查询优化（推荐） #

无需先查Price表，直接通过JPA的属性嵌套查询一次性拿到结果，自带去重逻辑，性能更高：

1. 修改ItemRepository方法：

public interface ItemRepository extends JpaRepository<Item, Long>, JpaSpecificationExecutor<Item> {
    // Distinct用于避免同一个Item多个符合条件的Price导致的重复返回
    Page<Item> findDistinctByPricesPriceBetween(BigDecimal minPrice, BigDecimal maxPrice, Pageable pageable);
}

2. 调整Controller逻辑，删除冗余的PriceRepository调用，同时补全Sort的排序字段（你之前的代码仅指定排序方向未指定字段，运行会报错）：

@GetMapping("/get-item")
@PreAuthorize(RoleExpressions.PERMIT_ALL)
public Page<Item> getItems(BigDecimal minPrice, BigDecimal maxPrice){
    return itemRepository.findDistinctByPricesPriceBetween(
            minPrice,
            maxPrice,
            PageRequest.of(0, 10, Sort.Direction.DESC, "id")
    );
}

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