Spring Boot嵌套对象Example查询失效：如何按Crop ID精确查询Field？

API 探路者

2026-7-12

解决Query by Example关联实体Crop ID查询失效问题

问题根源

Query by Example（QBE）处理关联实体时，会默认遍历关联对象的所有属性。你构建的Crop示例包含非空的id和null的name，再加上withIncludeNullValues()配置，会导致QBE尝试匹配crop.name IS NULL，同时未正确识别crop.id的匹配规则，最终忽略了Crop ID的查询条件。

修正代码

public Optional<Field> getField(FieldRequest request) {
    Field fieldExample = Field.builder()
            .name(request.name)
            .crop(Crop.builder().id(request.cropId).build())
            .build();

    ExampleMatcher matcher = ExampleMatcher.matching()
            // 忽略无关属性：Field的id、Crop的name
            .withIgnorePaths("id", "crop.name")
            // 精确匹配Field的name
            .withMatcher("name", ExampleMatcher.GenericPropertyMatcher::exact)
            // 精确匹配关联实体Crop的id
            .withMatcher("crop.id", ExampleMatcher.GenericPropertyMatcher::exact);

    return fieldRepository.findOne(Example.of(fieldExample, matcher));
}

核心调整说明

忽略Crop的name属性：通过withIgnorePaths("crop.name")排除Crop的name作为查询条件，避免因null值生成无效匹配规则，同时确保仅用Crop的id进行匹配。
移除withIncludeNullValues()：该配置会将null属性也作为查询条件（如name IS NULL），不符合你"精确匹配传入参数"的需求。如果需要支持部分条件查询（如name或cropId可能为空），可替换为withIgnoreNullValues()，此时QBE会自动忽略null的属性。
显式声明匹配规则：虽然QBE默认是精确匹配，但显式配置能避免歧义，确保查询逻辑完全符合预期。