MyBatis调用Oracle存储过程OUT参数为null的根本原因是mode或jdbcType配置错误：mode必须全大写（IN/OUT/INOUT），jdbcType必须严格匹配MyBatis枚举值且大小写敏感，同时Map中key名、XML占位符名及存储过程参数顺序三者必须完全一致。
MyBatis调用Oracle存储过程时out参数为null
根本原因几乎总是mode或jdbctype配置错误，而非sql语法或数据库权限问题。mybatis在解析#{xxx, mode=out, jdbctype=...}时，若任一属性缺失、拼写错误（比如mode首字母大写）、值非法（如jdbctype=string），就会跳过该参数注册，导致oracle驱动不为其分配绑定变量，最终params.get("xxx")返回null。
-
mode必须全大写：IN、OUT、INOUT——小写（in）或驼峰（inOut）均无效 -
jdbcType必须与Oracle实际类型严格匹配，且为MyBatis支持的枚举值：例如VARCHAR不能写成STRING，INTEGER不能写成INT，CURSOR不能漏掉 - 即使参数是
OUT，也必须在Map或实体中预先存在对应key（如params.put("outparam", null)），否则MyBatis不会注入结果 - Oracle的
CLOB/BLOB需显式指定jdbcType=CLOB或BLOB，仅靠javaType无法触发正确类型处理
Oracle存储过程多个OUT参数时jdbcType必须一一对应
当存储过程声明了PROCEDURE p_test(a OUT NUMBER, b OUT VARCHAR2, c OUT DATE)，Mapper中三个#{...}占位符的jdbcType顺序和类型必须与PL/SQL声明顺序完全一致。错位会导致值被写入错误的key，甚至抛SQLException: Invalid column type。
- 不要依赖“位置推断”——MyBatis按XML中
#{...}出现顺序绑定，而非按参数名匹配 - 使用
<parametermap></parametermap>方式（已废弃但仍有项目在用）时，<parameter property="a" ...></parameter>的property名必须与传入Map的key完全一致，且顺序不可变 - 对
CURSOR类OUT参数，除jdbcType=CURSOR外，javaType=ResultSet和resultMap缺一不可，否则返回的是原始OracleResultSetImpl对象，强转List必报ClassCastException
为什么jdbcType大小写敏感且必须大写
MyBatis内部通过JdbcType.valueOf("VARCHAR")反射解析jdbcType字符串，而JdbcType是Java枚举，其name()值全为大写。传入"varchar"会直接抛IllegalArgumentException，但MyBatis默认吞掉该异常并静默跳过参数绑定——表面无报错，实则OUT失效。
- 验证方法：开启MyBatis日志（
log4j.logger.org.apache.ibatis=DEBUG），搜索Binding to parameter，若某OUT参数未出现在日志中，基本可判定jdbcType解析失败 - 常见易错组合：
jdbcType=TIMESTAMP（不是time）、jdbcType=NUMERIC（非number）、jdbcType=CHAR（非character） - Oracle
NUMBER(1)建议用jdbcType=BIT或jdbcType=BOOLEAN（需配合typeHandler），直接用INTEGER可能因精度截断丢失值
Map传参时key名必须与Mapper中占位符变量名完全一致
这是最隐蔽的坑：哪怕只差一个下划线或大小写，MyBatis就无法将执行后的OUT值回填到Map中。例如Mapper里写#{out_result, mode=OUT, jdbcType=VARCHAR}，代码中却params.put("outResult", null)，调用后params.get("out_result")仍为null，而params.get("outResult")也为空——因为MyBatis只往声明的key写，不往其他key写。
- 实体类方式同理：字段名
private String outResult;，Mapper中就必须用#{outResult, ...}，不能写#{out_result} - 调试技巧：调用前打印
params.keySet()，确认key与XML中#{...}内名字逐字符相同 - 避免使用保留字作key名（如
order、group），某些旧版MyBatis会异常解析
OUT参数“消失”。真正要排查，得同时盯住三处：Mapper XML里的#{...}写法、Java传参Map的key、Oracle存储过程参数声明顺序和类型。少看一眼，就多花两小时。
