MyBatis调用存储过程必须设置statementType="CALLABLE",显式声明参数mode(IN/OUT/INOUT)和jdbcType,OUT参数须用实体类接收,支持结果集与OUT参数共存。

MyBatis 调用存储过程的关键不在“能不能”,而在“怎么配对、怎么传、怎么取”。它不走常规 SQL 流程,必须显式告诉框架:这是个存储过程,参数有方向(IN/OUT/INOUT),类型要明确(jdbcType),执行后值会回写到 Java 对象里。
必须设置 statementType="CALLABLE"
这是识别存储过程的开关。无论用
- XML 中写法:
<select id="xxx" statementType="CALLABLE"> - 注解方式需配合
@Select+statementType = StatementType.CALLABLE
入参(IN)和出参(OUT)要按 mode 显式声明
MyBatis 不自动推断参数方向。每个占位符都得注明 mode 和 jdbcType,尤其 OUT 参数缺一不可,否则值不会写回 Java 变量。
- IN 参数示例:
#{userId, mode=IN, jdbcType=INTEGER} - OUT 参数示例:
#{userName, mode=OUT, jdbcType=VARCHAR} - INOUT 参数示例:
#{totalCount, mode=INOUT, jdbcType=INTEGER} - jdbcType 必须与数据库字段类型匹配,比如 VARCHAR、INTEGER、DATE、BIGINT,不能省略
接收输出参数推荐用实体类,不是原始类型
用 String、Integer 等基本类型或包装类接收 OUT 参数,运行时不会被赋值——因为 Java 是值传递,MyBatis 无法修改局部变量的引用。正确做法是用可变对象封装:
立即学习“Java免费学习笔记(深入)”;
- 定义实体类,含对应字段(如
private String userName;) - Mapper 接口方法参数为该实体类(
void getUser(Param param)) - XML 中用
#{userName, mode=OUT, jdbcType=VARCHAR}绑定字段名 - 调用后,
param.getUserName()即可拿到数据库返回值
返回结果集(SELECT)和 OUT 参数可以同时存在
一个存储过程既能查数据(返回 ResultSet),又能设 OUT 参数(如统计信息、状态码)。MyBatis 支持两者共存:
- 在 XML 的
{call xxx(...)}写法中,OUT 参数照常声明 - 如果过程内有 SELECT,且你希望映射成 Java 对象列表,需额外配置
resultMap或resultType - 注意:OUT 参数值在执行完成后才写入,所以必须等整个调用返回后再读取


















