mybatis向oracle传入null时报错，因默认转为jdbctype.other（oracle不支持），需显式指定jdbctype=null：①sql中单参数写法如#{name,jdbctype=null}；②全局配置jdbctypefornull=“null”（xml/yaml/configurationcustomizer）。
MyBatis 在向数据库（尤其是 Oracle）传入 null 值时，若未明确指定 JDBC 类型，会默认使用 JdbcType.OTHER，而 Oracle 驱动不支持该类型，从而抛出“无效的列类型：1111”或“Parameter index out of range”等异常。解决核心是让 MyBatis 知道：这个 null 应按 SQL 标准的 NULL 类型处理，即 JdbcType.NULL。
在 SQL 映射中为单个参数显式指定 jdbcType=NULL
适用于局部、可控、字段类型明确的场景。直接在 #{...} 占位符中补充类型声明：
-
#{name, jdbcType=NULL}—— 通用写法，适配所有可能为 null 的字段 -
#{age, jdbcType=NUMERIC}或#{remark, jdbcType=VARCHAR}—— 更推荐：既兼容非空值，又在值为 null 时由 JDBC 驱动按对应类型安全设为 NULL - 注意：Oracle 中
jdbcType=NULL是合法且被广泛支持的；MySQL 和 PostgreSQL 通常更宽松，但显式声明仍可提升兼容性
通过全局配置统一设置 jdbcTypeForNull
避免每个参数都手动加类型，适合项目中大量存在可空字段的场景：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- XML 配置（
mybatis-config.xml）： - YAML 配置（Spring Boot）：
mybatis:
configuration:
jdbc-type-for-null: 'NULL'（单引号必须，否则 YAML 解析为布尔值） - Java 配置类（MyBatis-Plus 用户）：
实现ConfigurationCustomizer，调用configuration.setJdbcTypeForNull(JdbcType.NULL)
注意动态 SQL 与参数数量匹配问题
仅设 jdbcType 不够——若使用 <if></if> 等标签导致最终 SQL 实际参数数少于传入参数数，也会触发 “Parameter index out of range” 错误：
- 检查
<if test="xxx != null"></if>条件是否覆盖所有分支，确保 SQL 拼接后参数索引连续 - 避免在同一个语句中混用
@Param注解参数和 Bean 属性参数，易引发映射错位 - 调试时开启 MyBatis 日志（
log-impl=org.apache.ibatis.logging.stdout.StdOutImpl），观察最终生成的 SQL 和绑定参数列表
额外提醒：警惕“假 null”字符串
前端或 JSON 传参时，有时实际收到的是字符串 "null" 而非 Java 的 null，导致 test="name == null" 判断失效：
- 在 Controller 或 Service 层做预处理：
if ("null".equalsIgnoreCase(name)) name = null; - 或改用更健壮的判断：
test="name == null or name.trim().length() == 0"
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
