Spring Boot原生查询中如何传递String列表参数获取课程？

直接用SQL的IN子句替代多个OR条件，Spring Data JPA支持直接将List<String>参数绑定到原生查询的IN语句中，具体实现步骤如下：

1. 编写Repository接口方法 #

在课程Repository接口中，定义带原生查询的方法，通过@Param绑定参数，SQL中使用:teacherIds作为占位符：

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;

public interface CourseRepository extends JpaRepository<Course, Long> {

    @Query(value = "SELECT * FROM course WHERE teacher_id IN (:teacherIds)", nativeQuery = true)
    List<Course> findCoursesByTeacherIds(@Param("teacherIds") List<String> teacherIds);
}

2. 关键说明 #

• 替代多OR的原因：IN子句是数据库原生支持的多值匹配语法，比手动拼接多个teacher_id = ? OR teacher_id = ?更简洁，且数据库对IN的执行优化更友好。
• 参数绑定规则：@Param("teacherIds")的名称必须和SQL中的:teacherIds完全一致，Spring会自动将List中的元素展开为IN的参数列表（比如传入["t1","t2"]，最终SQL会变成teacher_id IN ('t1','t2')）。
• 空列表处理：如果传入的teacherIds为空，会生成IN ()的无效SQL，建议在调用该方法前先做非空校验，或者在查询中添加兜底逻辑（比如WHERE (teacher_id IN (:teacherIds) OR :teacherIds IS NULL)，需注意参数绑定的兼容性）。

3. 实体类示例（参考） #

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Table;

@Entity
@Table(name = "course")
public class Course {
    @Id
    private Long id;
    private String name;
    private String teacherId; // 对应数据库的teacher_id字段
    
    // 省略getter、setter和构造方法
}

4. 业务层调用示例 #

@Service
public class CourseService {
    private final CourseRepository courseRepository;

    public CourseService(CourseRepository courseRepository) {
        this.courseRepository = courseRepository;
    }

    public List<Course> getCoursesByTeacherIds(List<String> teacherIds) {
        // 先校验参数，避免空列表导致SQL错误
        if (teacherIds == null || teacherIds.isEmpty()) {
            return Collections.emptyList();
        }
        return courseRepository.findCoursesByTeacherIds(teacherIds);
    }
}

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