mybatis调用mysql存储过程需设statementtype="callable"、用{call...}语法、严格匹配参数顺序及mode/jdbctype;jdbc url须含allowprocedurecalls=true;out参数值自动回填至map或pojo。

MyBatis 调用 MySQL 存储过程时,关键在于正确声明 statementType="CALLABLE"、使用 {call ...} 语法、合理配置入参(IN)与出参(OUT/INOUT),并确保 JDBC 驱动和 MySQL 配置支持存储过程调用。
配置 Mapper XML 中的存储过程调用
在 XML 映射文件中,需将 <select></select> 或 <update></update> 的 statementType 设为 CALLABLE,SQL 使用标准 JDBC 调用语法:{call proc_name(?, ?, ?)}。问号顺序必须严格对应存储过程中参数的定义顺序(包括 IN/OUT 位置)。
示例:MySQL 中有如下存储过程:
DELIMITER $$
CREATE PROCEDURE get_user_by_id(
IN p_id INT,
OUT p_name VARCHAR(50),
OUT p_age INT
)
BEGIN
SELECT username, age INTO p_name, p_age
FROM users WHERE id = p_id;
END$$
DELIMITER ;
对应 Mapper XML 写法:
<select id="callGetUserById" statementtype="CALLABLE" parametertype="map">
{call get_user_by_id(#{id, mode=IN}, #{name, mode=OUT, jdbcType=VARCHAR}, #{age, mode=OUT, jdbcType=INTEGER})}
</select>
注意:mode=OUT 表示该参数是输出参数;jdbcType 必须显式指定,否则 MyBatis 无法正确注册 OUT 参数类型,导致返回 null 或报错。
Java 接口与参数封装方式
Mapper 接口方法应接收一个 Map 或自定义 POJO 对象作为参数(推荐 Map,更灵活)。MyBatis 会自动将 OUT 参数值回填到该 Map 中对应 key 下。
- 使用
Map<string object></string>:入参 key 与 XML 中#{key}一致,OUT 参数也会以相同 key 写回 Map - 若用 POJO,需确保字段名与 XML 中占位符 key 完全匹配,并添加 getter/setter
- 调用后直接从 Map 中获取
map.get("name")、map.get("age")即可
确保 JDBC 连接支持存储过程
MySQL Connector/J 默认禁用存储过程调用,需在 JDBC URL 中显式启用:
jdbc:mysql://localhost:3306/mydb?allowMultiQueries=true&useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true&autoReconnect=true&allowProcedureCalls=true
其中 allowProcedureCalls=true 是必需项。同时确认驱动版本兼容性(建议 8.0.22+),旧版驱动可能对 OUT 参数支持不完整。
处理多结果集或返回码(可选进阶)
若存储过程内含 SELECT 语句(非仅 INTO),MyBatis 默认只处理第一个结果集。如需多个结果集,可在 XML 中用 resultSets 属性声明多个结果集名称,并配合 <resultmap></resultmap> 分别映射:
<select id="procWithMultipleResults" statementtype="CALLABLE" resultsets="rs1,rs2" resultmap="resultMap1">
{call proc_multi_result(#{param, mode=IN})}
</select>
此时 Java 端需通过 SqlSession.selectList(...) 获取第一个结果集,其余结果集需在存储过程中用 SELECT 显式输出,并按顺序被 MyBatis 捕获。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











