如何解决JDBC调用Oracle过程参数类型错误

阿敏君_5091

阿敏君_5091

2026-08-16

922人浏览

原创

mybatis或jdbc调用oracle存储过程报pls-00306/ora-06550,90%因参数类型声明缺失或错配:必须显式指定jdbctype(如varchar)和mode(in/out),不可依赖默认推断,否则oracle驱动将null或字符串映射为不被接受的other类型。

如何解决jdbc调用oracle过程参数类型错误

MyBatis 或原生 JDBC 调用 Oracle 存储过程时抛 PLS-00306 或 ORA-06550,90% 是参数类型声明缺失或错配,不是 SQL 写错,也不是存储过程本身有问题。

必须显式写死 jdbcType 和 mode,不能依赖默认推断

Oracle JDBC 驱动对 NULL 字符串、空字符串、动态字段一律映射为 JdbcType.OTHER,而 Oracle PL/SQL 不接受 OTHER 作为任何参数类型。哪怕 Java 传的是 String,驱动也不会自动认作 VARCHAR2。

  • #{paramName,jdbcType=VARCHAR,mode=IN}:所有字符串类 IN 参数都应加,尤其来自 Map 或可为空的字段
  • #{outParam,mode=OUT,jdbcType=VARCHAR}:OUT 参数缺 mode 或 jdbcType 任一者,绑定直接失败
  • 即使参数值确定非 null,也建议写全——上线后数据内容变化(比如某字段突然存了空值)就会触发报错
  • jdbcTypeForNull=NULL 全局配置对存储过程无效,因为 CallableStatement 不走通用参数解析路径

数组/自定义类型参数要转成 oracle.sql.ARRAY,不能直接传 List

Oracle 存储过程若声明了 IN TAB_CUSTOMER 这类自定义集合类型,Java 侧传 List<customer></customer> 会报“参数个数或类型错误”,因为 JDBC 无法自动把 Java 集合转成 Oracle 的 ARRAY 对象。

Market Oracle
Market Oracle

金融事件影响分析器 — 获取突发新闻,追踪金属/石油/加密货币/股票价格,预测短中长期市场连锁反应

下载
  • 必须用 ArrayDescriptor.createDescriptor("TAB_CUSTOMER", conn) 创建描述符
  • 每个元素要封装为 STRUCT,字段顺序、类型、长度需与 TYP_CUSTOMER 定义严格一致
  • STRUCT 构造时,DATE 字段要用 oracle.sql.DATE 包装,不能用 java.sql.Date
  • 别用 setObject(i, list, Types.ARRAY) —— 驱动不认识你的自定义类型名,会 fallback 到 OTHER

超长字符串传 CLOB 必须绕过 setString()

用 setString() 传超过 32KB 的字符串给 IN CLOB 参数,JDBC 驱动会自己拦截并抛 Data size bigger than max size for this type,这不是 Oracle 报错,是 ojdbc8 内部按 VARCHAR2 路径做的缓冲校验。

  • 必须改用 setCharacterStream(int, Reader, long),第三个参数传字符数(不是字节数)
  • MyBatis 场景下需自定义 TypeHandler,重写 setParameter(),强制调用 setCharacterStream
  • 不要用 setClob(int, Reader):旧版 ojdbc 可能触发额外内存拷贝,性能更差
  • 超 100MB 大文本需分段:先插 EMPTY_CLOB() 占位,再用 DBMS_LOB.WRITEAPPEND 分批写入(每批 ≤32KB),且事务不能提交

ORA-06550 错误里的 line 1, column 7 指的是什么

这个位置不是你 Java 代码行号,而是 JDBC 驱动生成的匿名 PL/SQL 块内部偏移,例如 { call p_test(?, ?, ?) } 中第一个 ? 的位置。它只说明参数绑定失败发生在第几个占位符,不反映存储过程定义问题。

  • 真正要看的是错误附带的子错误,比如 PLS-00306: wrong number or types of arguments in call to 'p_test'
  • 检查点优先级:参数个数是否匹配 → 参数物理顺序是否和存储过程定义一致 → 每个参数的 mode 和 jdbcType 是否都写了 → OUT 参数是否在 execute() 前注册了 registerOutParameter()
  • Oracle 存储过程中参数名大小写不敏感,但 MyBatis 的 #{xxx} 必须和 Java 对象字段名或 Map key 完全一致(区分大小写)

最容易被忽略的是:OUT 参数在 MyBatis XML 里漏写 mode=OUT,或者原生 JDBC 忘了调 registerOutParameter() —— 这会导致驱动根本不去分配返回缓冲区,后续取值必然失败,且错误信息极不直观。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

821

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

2273

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

2310

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

1349

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

1913

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

2489

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4109

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

237

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

626

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程