mybaits 参数问题

关注

原创 2026-07-09 09:34:06 187 阅读 AI 写同款· GEO 优化 ›

Mybaits-plus2升级3实战 Mybaits-plus2升级3实战 2.0到3.0主要升级的点： 1.升级 JDK 8 + 优化性能 Wrapper 支持 lambda 语法 2.模块化 MP 合理的分配各个包结构 3.重构注入方法，支持任意方法精简注入模式 4.全局配置下划线转换消灭注入 AS 语句 5.改造 Wrapper 更改为 QueryWrapper UpdateWrapper 6.重构分页插件消灭固定分页模型，支持 Mapper 直接返回 IPage 接口 7.新增 Rest Api 通过 Controller 层 8. 阅读详情

MyBatis 中 @Param(“searchBean”) 用在 Map 参数上的详解

在 MyBatis 的 Mapper 接口中，当方法参数是 Map 类型时，加上 @Param(“searchBean”) 注解，是为了给这个 Map 参数起一个别名，方便在 XML 映射文件中引用。

public interface UserMapper {
    
    List<User> searchUsers(@Param("searchBean") Map<String, Object> params);
}

<select id="searchUsers" resultType="User">
    SELECT * FROM user
    WHERE 1=1
    <if test="searchBean.username != null and searchBean.username != ''">
        AND username LIKE CONCAT('%', #{searchBean.username}, '%')
    </if>
    <if test="searchBean.age != null">
        AND age >= #{searchBean.age}
    </if>
</select>

Map<String, Object> params = new HashMap<>();
params.put("username", "张三");
params.put("age", 18);

List<User> users = userMapper.searchUsers(params);

参数里的值配赋予了@Param(“searchBean”) 里的searchBean searchBean就拥有了 map对象的key

不加@Param

// 不加 @Param
List<User> searchUsers(Map<String, Object> params);

<!-- 方式一：直接用 key 访问（推荐） -->
<if test="username != null">
    AND username LIKE CONCAT('%', #{username}, '%')
</if>

<!-- 方式二：通过 param1 访问 -->
<if test="param1.username != null">
    AND username LIKE CONCAT('%', #{param1.username}, '%')
</if>

加 @Param 的好处

场景	不加 @Param	加 @Param(“searchBean”)
单个 Map 参数	用 `key` 或 `param1.key`	用 `searchBean.key`
多个参数（Map + 其他）	❌ 无法区分	✅ 每个参数都有名字
代码可读性	较差	更好，语义清晰

多参数场景（必须用 @Param）

List<User> searchUsers(
    @Param("searchBean") Map<String, Object> params,
    @Param("offset") int offset,
    @Param("limit") int limit
);

<select id="searchUsers" resultType="User">
    SELECT * FROM user
    WHERE 1=1
    <if test="searchBean.username != null">
        AND username LIKE CONCAT('%', #{searchBean.username}, '%')
    </if>
    LIMIT #{offset}, #{limit}
</select>

单个参数时：@Param 不是必须的，但加上后 XML 中的表达式更清晰、更有语义。
多个参数时：@Param 是必须的，否则 MyBatis 无法区分各个参数。
命名规范：searchBean 只是一个约定俗成的名字，你可以取任何合法的标识符，如 params、query、condition 等。

@Param(“searchBean”) 的作用就是给 Map 参数起个别名，让 XML 中可以通过 searchBean.xxx 的方式访问 Map 里的值。单个 Map 参数时可选，多个参数时必加，加上后代码可读性更好。

param1 ?

刚才不加@Param的例子里有个 param1

原因：MyBatis 自动给未命名的参数分配了默认名字
当你没有使用 @Param 注解时，MyBatis 会按照参数的顺序，自动给它们分配默认名称：param1、param2、param3……以此类推。

// Mapper 接口
List<User> searchUsers(Map<String, Object> params);

MyBatis 内部会把这个唯一的参数同时绑定到以下几个名字上：

param1 → 指向这个 Map 对象
param → 也指向这个 Map 对象（单个参数时的别名）

<!-- 方式一：直接用 Map 的 key（MyBatis 会直接解析 Map） -->
<if test="username != null">
    AND username = #{username}
</if>

<!-- 方式二：通过 param1 访问 -->
<if test="param1.username != null">
    AND username = #{param1.username}
</if>

<!-- 方式三：通过 param 访问（单个参数时可用） -->
<if test="param.username != null">
    AND username = #{param.username}
</if>