Spring Data Repository原生查询中如何为IN子句添加参数

嘿，我来帮你搞定Spring Data原生查询里IN子句传参的问题！之前好多开发者都踩过类似的坑，我给你梳理几个靠谱的实现方式，避开你之前踩过的拼接字符串的坑：

1. 直接用List作为参数（最推荐） #

Spring Data JPA本身就支持把List直接作为IN子句的参数，根本不需要手动拼接字符串。只要用@Query配合命名参数或者位置参数就行，示例代码如下：

命名参数写法 #

@Repository
public interface YourEntityRepository extends JpaRepository<YourEntity, Long> {

    @Query(value = "SELECT * FROM your_table WHERE id IN (:ids)", nativeQuery = true)
    List<YourEntity> findByIds(@Param("ids") List<Long> ids);
}

位置参数写法 #

如果不想用命名参数，也可以用位置索引来绑定：

@Repository
public interface YourEntityRepository extends JpaRepository<YourEntity, Long> {

    @Query(value = "SELECT * FROM your_table WHERE id IN (?1)", nativeQuery = true)
    List<YourEntity> findByIds(List<Long> ids);
}

这种方式下，Spring会自动把List转换成IN子句需要的格式（比如IN (1,2,3)），既安全又不会出错，还能避免SQL注入风险。

2. 用EntityManager手动创建查询 #

如果你的原生查询比较复杂，或者需要更灵活的参数控制，可以直接用EntityManager来构建查询：

@Service
public class YourEntityService {

    @Autowired
    private EntityManager entityManager;

    public List<YourEntity> findByIds(List<Long> ids) {
        Query query = entityManager.createNativeQuery(
            "SELECT * FROM your_table WHERE id IN (:ids)", 
            YourEntity.class
        );
        query.setParameter("ids", ids);
        return query.getResultList();
    }
}

你之前踩坑的原因 #

你之前尝试拼接字符串或者直接传逗号分隔的字符串，本质问题是JPA会把整个字符串当成单个参数，最终SQL会变成IN ('1,2,3')而不是IN (1,2,3)，自然查不到数据。而且手动拼接还会带来SQL注入的安全隐患，绝对不推荐。

注意事项 #

• 确保你的List元素类型和数据库字段类型匹配（比如数据库是VARCHAR类型，就传List<String>）
• 如果你用的是较老版本的Spring Data JPA（比如1.x），可能需要升级到2.x及以上版本来获得完整的List参数支持

内容的提问来源于stack exchange，提问作者a.valchev