Oracle存储过程的参数设置直接决定了调用的成败与执行效率。无论是数据库内部通过PL/SQL块调用，还是Java、Python等外部程序通过驱动访问，参数的模式、顺序和类型映射都是核心环节。不少团队在接口联调时耗费大量时间，根本原因是对Oracle参数机制理解不够完整。
一、存储过程参数模式基础
Oracle存储过程的参数分为三种模式：IN、OUT和IN OUT。IN模式用于接收调用者传入的值，在过程内部该参数相当于常量，不能被重新赋值。OUT模式用于过程向调用者返回结果，调用时传入的实参会被忽略，过程执行结束后实参获得返回值。IN OUT则兼具两者特性，既传入又传出，要求实参必须是变量而不能是字面量。
下面创建一个简单的示例过程，展示三种模式的使用差异：
CREATE OR REPLACE PROCEDURE demo_params( p_in IN NUMBER, p_out OUT NUMBER, p_io IN OUT NUMBER ) AS BEGIN -- p_in 是输入，不能赋值 p_out := p_in * 2; p_io := p_io + p_in; END demo_params; /
在PL/SQL中调用时，必须准备变量接收OUT和IN OUT的结果。如果直接写demo_params(10, 20, 30)把20作为OUT实参，编译器会报表达式不能作为赋值目标错误，因为OUT参数需要可写变量。
二、PL/SQL中的调用与命名传参
当存储过程参数较多时，位置传参容易出错。Oracle支持命名传参，通过"形参 => 实参"的方式指定，顺序可以打乱，也方便跳过有默认值的参数。命名传参在维护老接口时尤其有用。
以下代码演示变量声明与命名传参调用：
DECLARE
v_out NUMBER;
v_io NUMBER := 5;
BEGIN
demo_params(
p_in => 10,
p_io => v_io,
p_out => v_out
);
DBMS_OUTPUT.PUT_LINE('out=' || v_out || ' io=' || v_io);
END;
/
如果过程定义了默认值，例如p_in NUMBER DEFAULT 1，那么调用时可以省略该参数。但注意，位置传参省略只能从最右参数开始，而命名传参可省略任意带默认值的参数。混合使用时，位置参数必须排在命名参数之前，否则语法错误。
三、JDBC程序中的参数设置
在Java应用中，通常使用CallableStatement调用Oracle存储过程。问号占位符对应参数位置，OUT参数必须通过registerOutParameter声明SQL类型。类型不匹配是常见故障源，例如Oracle的NUMBER应对应Types.NUMERIC或Types.INTEGER。
下面示例展示JDBC正确调用方式：
import java.sql.*;
public class CallProc {
public static void main(String[] args) throws Exception {
Connection conn = DriverManager.getConnection(
"jdbc:oracle:thin:@127.0.0.1:1521:orcl", "user", "pass");
CallableStatement cs = conn.prepareCall("{call demo_params(?, ?, ?)}");
// 设置IN参数
cs.setInt(1, 10);
// 注册OUT参数类型
cs.registerOutParameter(2, Types.NUMERIC);
// IN OUT参数先设置再注册
cs.setInt(3, 5);
cs.registerOutParameter(3, Types.NUMERIC);
cs.execute();
int out = cs.getInt(2);
int io = cs.getInt(3);
System.out.println("out=" + out + " io=" + io);
cs.close();
conn.close();
}
}
上述代码中，第三个占位符既是输入又是输出，必须先setInt提供初始值，再registerOutParameter声明输出类型。若遗漏注册，执行后取值会得到null或零值。对于游标类型OUT参数，应注册为Types.REF_CURSOR，并通过getObject转型为ResultSet处理。
四、NOCOPY提示与性能注意点
对于OUT和IN OUT的大对象参数（如集合、大字符串、记录类型），Oracle默认按值传递，会在调用前后发生拷贝。使用NOCOPY提示可改为按引用传递，减少拷贝开销，但异常发生时可能让实参处于不完整状态。它仅是提示而非强制，语法为"参数名 OUT NOCOPY 类型"。
示例定义如下：
CREATE OR REPLACE PROCEDURE big_copy( p_tab OUT NOCOPY SYS.ODCINUMBERLIST ) AS BEGIN p_tab := SYS.ODCINUMBERLIST(1,2,3,4,5); END big_copy; /
在批量数据处理中，NOCOPY能明显降低PGA内存消耗。但编写关键事务逻辑时需评估异常安全性，避免过程异常回滚后调用端变量已被部分修改。小型标量参数使用NOCOPY通常收益极小，不必刻意添加。
五、常见错误与排查清单
实际开发中，参数设置错误集中在几类：把OUT参数传常量、CallableStatement漏注册、类型映射错误、默认值与位置混用违规、忽略IN OUT需先赋值。排查时优先核对过程定义与调用签名的参数数量和模式。
可参考如下对照表快速定位：
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| ORA-06550 表达式不能用作赋值目标 | OUT参数传入字面量 | 改为传入变量 |
| JDBC取出为null | 未registerOutParameter | 按索引注册对应SQL类型 |
| 类型转换异常 | Java类型与NUMBER不匹配 | 使用Numeric或BigDecimal接收 |
掌握这些参数设置方法后，Oracle存储过程调用会更加稳定，也能在接口设计阶段就规避大部分低级错误。建议在团队内部统一调用规范，明确IN OUT使用场景与JDBC类型映射表。