在DB2数据库开发中，存储过程是封装业务逻辑、减少网络开销的重要工具。存储过程的参数传递机制直接决定了数据能否在调用方与过程体之间正确流转。DB2存储过程支持IN、OUT和INOUT三种参数模式，许多开发者在首次接触时容易混淆它们的赋值与返回值行为，导致过程执行失败或输出结果不符合预期。本文将从参数模式定义、调用语法、常见错误三个维度深入解析DB2存储过程输入输出参数传递的细节，并通过完整代码示例展示不同场景下的正确用法。
一、DB2存储过程参数模式详解
IN参数用于向存储过程传入数据，调用方赋予该参数的值在过程体内部可以读取，但过程体对IN参数的任何修改都不会回传给调用方。这种模式适用于查询条件、业务标识等只读数据。例如，根据用户编号查询用户姓名时，用户编号就应定义为IN参数。
OUT参数用于从存储过程向调用方返回数据。在过程体内部，必须对OUT参数进行赋值操作，否则该参数将返回NULL。调用方在调用前赋予OUT参数的任何值都会被忽略，因为数据库在进入过程体时不会读取该参数。这种模式通常用于返回计算结果、状态码或查询得到的单个值。
INOUT参数同时具备输入和输出能力。调用方可以将初始值传入过程体，过程体读取并可能修改这个值，最终修改后的结果会返回给调用方。典型场景包括计数器累加、需要保持状态的会话变量等。需要注意的是，INOUT参数在过程体内被修改后，输出值会覆盖调用方原来的值，因此调用方需要预留变量接收返回值。
在CREATE PROCEDURE语句中，参数模式需要显式声明在参数名称之前。下面创建一个示例存储过程，它同时使用三种参数模式：
CREATE PROCEDURE demo_param_proc (
IN p_input_id INTEGER,
OUT p_output_name VARCHAR(50),
INOUT p_counter INTEGER
)
LANGUAGE SQL
BEGIN
SELECT name INTO p_output_name FROM users WHERE id = p_input_id;
SET p_counter = p_counter + 1;
END
上述过程中，p_input_id是输入参数，p_output_name是输出参数，p_counter是输入输出参数。如果省略参数前的模式关键字，DB2将默认视为IN模式，这一点与其他数据库的默认行为可能不同，建议始终显式写出模式。
二、CALL语句与参数占位符的使用
在DB2命令行环境（CLP）中调用存储过程时，输出参数需要使用问号?作为占位符，而不能直接传入常量或表达式。例如，调用上面的demo_param_proc时，如果直接写CALL demo_param_proc(101, 'name', 0)，DB2会抛出SQLCODE -440错误，因为OUT和INOUT参数必须对应可赋值的变量。
正确的CLP调用方式如下：
db2 "CALL demo_param_proc(101, ?, ?)"
执行时，DB2会为每个问号提示输入，对于输出参数，执行完成后会显示返回值。这种方式适合交互式调试，但在脚本中不够灵活。
在应用程序中，通常使用JDBC或嵌入式SQL传递参数。以JDBC为例，需要使用CallableStatement，通过setXXX方法设置输入值，通过registerOutParameter注册输出参数，对于INOUT参数，还需要先调用setXXX设置初始值。示例代码如下：
Connection conn = DriverManager.getConnection(url, user, password);
CallableStatement cstmt = conn.prepareCall("{CALL demo_param_proc(?, ?, ?)}");
cstmt.setInt(1, 101); // 设置IN参数
cstmt.registerOutParameter(2, Types.VARCHAR); // 注册OUT参数
cstmt.setInt(3, 0); // 为INOUT参数设置初始值
cstmt.registerOutParameter(3, Types.INTEGER); // 注册INOUT输出
cstmt.execute();
String outputName = cstmt.getString(2); // 获取OUT参数值
int counter = cstmt.getInt(3); // 获取INOUT参数值
上述代码中，第三个参数因为既是输入又是输出，所以既调用了setInt又调用了registerOutParameter。执行完成后，通过对应的getXXX方法获取返回值。如果忘记注册输出参数，JDBC驱动会抛出异常。
三、NULL值处理与结果集返回
存储过程参数传递中，NULL值的处理容易引发隐蔽问题。DB2存储过程的参数默认允许NULL，如果调用方传入NULL给IN参数，过程体需要做好NULL判断，否则后续的查询或运算可能返回空集或异常。对于OUT参数，如果过程体没有执行到赋值语句，返回值就是NULL。因此，建议在过程体开头对输入参数进行NULL检查，并给出明确的错误提示。
例如，可以在过程体中使用IF p_input_id IS NULL THEN语句主动抛出异常或设置默认值。下面是一个包含NULL检查和结果集返回的完整示例：
CREATE PROCEDURE get_user_orders (
IN p_user_id INTEGER,
OUT p_status VARCHAR(20)
)
LANGUAGE SQL
BEGIN
DECLARE SQLSTATE CHAR(5) DEFAULT '00000';
DECLARE c_orders CURSOR WITH RETURN TO CLIENT FOR
SELECT order_id, order_date, amount FROM orders WHERE user_id = p_user_id;
IF p_user_id IS NULL THEN
SET p_status = 'INVALID_ID';
RETURN;
END IF;
OPEN c_orders;
SET p_status = 'OK';
END
该过程声明了一个返回给客户端的游标c_orders，并根据输入参数是否为空设置输出状态。调用方在执行完CALL后，除了可以通过p_status获取执行状态，还可以遍历游标返回的结果集。在JDBC中，需要先获取p_status输出参数，再通过getResultSet获取结果集。这一点在混合使用OUT参数和结果集时尤为重要，顺序不当可能导致结果集无法读取。
四、常见错误与最佳实践
参数传递相关的错误主要集中在调用方与定义方不匹配。最常见的是SQLCODE -440，表示参数模式不兼容，例如用常量作为OUT参数的实参。其次是SQLCODE -313，表示参数个数不匹配，这通常发生在存储过程定义变更后调用方代码没有同步更新。还有一种情况是INOUT参数未在过程体中赋值，导致返回值一直是初始值，难以排查。
为了避免这些问题，开发时应遵循以下最佳实践。第一，显式声明所有参数模式，不依赖默认行为。第二，对于OUT参数，在过程体所有可能的执行路径上都确保有赋值语句，包括异常处理分支。第三，调用方应使用变量接收输出参数，并为变量赋予明确的初始值。第四，参数类型和长度应尽量与业务表字段保持一致，避免隐式转换带来的截断或精度丢失。第五，在存储过程中添加异常处理程序，将SQLSTATE和错误信息通过输出参数返回给调用方，便于快速定位问题。
另外，如果存储过程涉及事务控制，输出参数的赋值应在提交或回滚之前完成。虽然DB2允许在事务结束后读取输出参数，但某些驱动或中间件可能缓存输出参数，导致返回旧值。为了可移植性和确定性，建议在过程体内部完成所有业务逻辑和参数赋值，事务操作放在最后执行。通过以上实践，可以显著降低DB2存储过程参数传递过程中的故障率，提升代码的健壮性和可维护性。