每个人都可以，
拥有SSL证书

MyBatis 里写 IN 查询，传个 List 或者数组进去，差不多是个高频需求。

核心就两步：接口上用 @Param 给集合起个名字，XML 里用 标签把 IN 后面的括号和占位符拼出来。这俩配合好，绝大多数场景都够用了。

先说最简写法。

接口里别直接传 List，拿 @Param 明确指定一个参数名。不然 MyBatis 默认用 "list" 或 "array"，多参数时容易乱，而且代码读起来不直观。

import org.apache.ibatis.annotations.Param;
import java.util.List;

public interface UserMapper {
    List<User> findUsersByIdList(@Param("userIds") List<Integer> idList);
}

XML 这边， 几个属性这样用：

• item：循环里的变量名，下面 #{id} 就指这个；
• collection：写 @Param 里那个名字，比如 "userIds"；
• open：循环开始前拼的字符，一般是左括号；
• close：结束后拼的字符，右括号；
• separator：元素间的分隔符，逗号最常见。

拼出来的 SQL 大概就是 WHERE id IN ( ? , ? , ? ) 的样子。

<select id="findUsersByIdList" resultType="User">
    SELECT id, username, email
    FROM users
    WHERE id IN
    <foreach item="id" collection="userIds" open="(" separator="," close=")">
        #{id}
    </foreach>
</select>

传数组的情况几乎一模一样，只是参数类型从 List 换成 Integer[]，XML 里 collection 指向数组对应的 @Param 名就行。

List<User> findUsersByIdArray(@Param("idArray") Integer[] ids);

<foreach collection="idArray" item="id" open="(" separator="," close=")">
    #{id}
</foreach>

这里其实容易踩坑的地方是——多参数场景。

如果除了集合还有别的条件，每个参数都必须用 @Param 命名，少一个都会导致绑定异常。比如同时传 ID 列表和一个 status：

List<User> findUsersByCriteria(
    @Param("userIds") List<Integer> ids,
    @Param("status") Integer status
);

XML 里 的 collection 依然写 "userIds"，剩下的参数正常用 #{status} 引用，别混了。

<select id="findUsersByCriteria">
    SELECT * FROM users
    WHERE id IN
    <foreach collection="userIds" item="id" open="(" separator="," close=")">
        #{id}
    </foreach>
    AND status = #{status}
</select>

实际写的时候有几个点值得留心。

始终用 @Param 给集合起个有意义的名字，别图省事用默认的 list。一两个月后回来看代码，readability 会好很多，排查线上问题时也少绕一步。

空集合的问题要提前在业务层拦住。如果集合是空的还传给 MyBatis， 拼不出任何占位符，最终跑到数据库的就是 WHERE id IN ( )，直接报语法错误。要么调用 mapper 前判断一下直接返回空列表，要么在 SQL 里加个 判空分支，但前者更干净。

大集合 IN 查询，数据库那边也可能扛不住。几百上千个 ID 砸进去，SQL 解析变慢，IN 列表太长甚至触发数据库自身的限制。

这种情况该分批查就分批查，单次控制在几百条以内，或者考虑用临时表连表查询。别等线上慢查询告警了再改。

安全方面多说一句。动态拼接表名、排序字段这种场景才去用 ${}，IN 查询这里都用 #{} 预编译，跟 配合是安全的。

但如果哪天有人想灵活到把字段名也动态传进来，一定要做白名单校验，否则 SQL 注入的风险就在那。

完整代码差不多就长这样，方便复制的时候有个参考。

接口：

import org.apache.ibatis.annotations.Param;
import java.util.List;

public interface UserMapper {
    List<User> findUsersByIdList(@Param("userIds") List<Integer> idList);
    List<User> findUsersByCriteria(
        @Param("userIds") List<Integer> ids,
        @Param("status") Integer status
    );
}

XML 映射文件：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.mapper.UserMapper">
    <select id="findUsersByIdList" resultType="User">
        SELECT id, username, email
        FROM users
        WHERE id IN
        <foreach item="id" collection="userIds" open="(" separator="," close=")">
            #{id}
        </foreach>
    </select>
    <select id="findUsersByCriteria" resultType="User">
        SELECT * FROM users
        WHERE id IN
        <foreach item="id" collection="userIds" open="(" separator="," close=")">
            #{id}
        </foreach>
        AND status = #{status}
    </select>
</mapper>

就这么点东西，搞清楚 @Param 和 的关系，基本不会写出问题。踩过一次空集合的坑以后，自然就养成手动判空的习惯了。