JPA原生查询中列表参数与IN子句的正确用法

// 错误示例：@Param注解的名称与查询中的参数名称不匹配
@Query(value = "select personal_recipes.name, personal_recipes.type, personal_recipes.comments, " +
        "personal_recipes.instructions, personal_recipes.rating, ingredients.name, ingredients.quantity " +
        "from personal_recipes " +
        "inner join ingredients on personal_recipes.name = ingredients.recipe_name " +
        "where (ingredients.name::citext in (:ingredientFilter))" , nativeQuery = true)
List<PersonalRecipesEntity> getPersonalRecipesByIngredient(@Param(value = "ingredient") List<String> ingredientFilter);

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import java.util.List;

// 假设PersonalRecipesEntity和IngredientsEntity是对应的JPA实体
// 假设PersonalRecipesEntity包含name, type, comments, instructions, rating等字段
// 假设IngredientsEntity包含name, quantity等字段，并有一个recipe_name字段关联PersonalRecipesEntity

public interface PersonalRecipesRepository extends JpaRepository<PersonalRecipesEntity, Long> {

    /**
     * 根据食材名称列表查询个人食谱。
     * 使用原生SQL查询，并通过citext进行不区分大小写的食材名称匹配。
     *
     * @param ingredientFilter 包含要查询的食材名称的列表。
     * @return 匹配到的个人食谱实体列表。
     */
    @Query(value = "select pr.name, pr.type, pr.comments, pr.instructions, pr.rating, i.name, i.quantity " +
            "from personal_recipes pr " +
            "inner join ingredients i on pr.name = i.recipe_name " +
            "where (i.name::citext in (:ingredientFilter))", nativeQuery = true)
    List<PersonalRecipesEntity> getPersonalRecipesByIngredient(@Param("ingredientFilter") List<String> ingredientFilter);

    /**
     * 另一个通用示例：根据日期范围和ID列表查询Pqrs实体。
     *
     * @param fechaInicial 查询起始日期。
     * @param fechaFinal 查询结束日期。
     * @param radicados 包含要查询的radicado（ID）列表。
     * @return 匹配到的Pqrs实体列表。
     */
    @Query(value = "select q.* from sde.pqrs q where q.fecha_radicado between :fechaInicial and :fechaFinal and q.radicado in (:radicados)", nativeQuery = true)
    List<Pqrs> consultaRadicadoDeVisita(@Param("fechaInicial") java.sql.Timestamp fechaInicial,
                                        @Param("fechaFinal") java.sql.Timestamp fechaFinal,
                                        @Param("radicados") List<String> radicados);
}