Express.js中用oracledb调用Oracle存储过程传对象数组报错求助

核心问题分析 #

• 直接传JS数组报错NJS-012：oracledb无法自动映射普通JS数组到Oracle自定义对象表类型，必须明确指定数据类型及对应关系。
• 指定DB_TYPE_OBJECT报错DPI-1025：参数是对象表类型而非单个对象，且未明确关联对应的基础对象类型。

具体解决步骤 #

1. 确认Oracle端类型定义（参考） #

确保你的类型和存储过程定义类似（PL/SQL示例）：

-- 自定义对象类型
CREATE OR REPLACE TYPE ORDER_HEADER_OBJ AS OBJECT (
    ORDER_ID NUMBER,
    CUSTOMER_ID NUMBER,
    ORDER_DATE DATE
);
/
-- 对象表类型
CREATE OR REPLACE TYPE ORDER_HEADER_TAB AS TABLE OF ORDER_HEADER_OBJ;
/
-- 接收表类型参数的存储过程
CREATE OR REPLACE PROCEDURE SP_SaleOrders(p_headers ORDER_HEADER_TAB)
IS
BEGIN
    -- 业务逻辑示例：插入数据到订单表
    FOR i IN 1..p_headers.COUNT LOOP
        INSERT INTO SALE_ORDERS (ORDER_ID, CUSTOMER_ID, ORDER_DATE)
        VALUES (p_headers(i).ORDER_ID, p_headers(i).CUSTOMER_ID, p_headers(i).ORDER_DATE);
    END LOOP;
    COMMIT;
END;
/

2. Node.js端正确实现调用 #

步骤2.1：获取自定义对象类型的元数据

在连接Oracle后，先获取ORDER_HEADER_OBJ的类型对象，用于后续绑定表类型参数：

const oracledb = require('oracledb');
const dbConfig = {
    user: 'your_user',
    password: 'your_password',
    connectString: 'your_host:1521/your_service'
};

async function callStoredProc() {
    let connection;
    try {
        connection = await oracledb.getConnection(dbConfig);
        
        // 获取自定义对象类型（注意schema，若类型属于当前用户可省略）
        const orderHeaderObjType = await connection.getDbObjectType('ORDER_HEADER_OBJ');

步骤2.2：构造符合结构的JS对象数组

每个对象的属性名必须和Oracle对象类型的属性完全一致（Oracle默认大写，建议JS键用大写）：

// 构造要传递的订单头数组
        const orderHeaders = [
            { ORDER_ID: 1001, CUSTOMER_ID: 5001, ORDER_DATE: new Date() },
            { ORDER_ID: 1002, CUSTOMER_ID: 5002, ORDER_DATE: new Date() }
        ];

步骤2.3：绑定参数并调用存储过程

绑定表类型参数时，指定type为oracledb.DB_TYPE_TABLE，并通过elementType关联对象类型：

// 调用存储过程
        await connection.execute(
            `BEGIN SP_SaleOrders(:p_headers); END;`,
            {
                p_headers: {
                    val: orderHeaders,
                    type: oracledb.DB_TYPE_TABLE,
                    elementType: orderHeaderObjType // 指定表元素对应的对象类型
                    // 若直接指定类型名称，也可以写成：elementType: 'ORDER_HEADER_OBJ'
                }
            },
            { autoCommit: true } // 若存储过程内未commit，可开启此选项
        );

        console.log('存储过程调用成功');
    } catch (err) {
        console.error('调用失败:', err);
    } finally {
        if (connection) {
            try {
                await connection.close();
            } catch (err) {
                console.error('关闭连接失败:', err);
            }
        }
    }
}

callStoredProc();

3. 关键注意事项 #

• 大小写匹配：Oracle对象属性默认是大写，JS对象的键必须和其完全一致，否则会出现属性映射失败。
• Schema指定：如果自定义类型不属于当前连接用户，必须在获取类型时指定Schema，比如connection.getDbObjectType('SCOTT.ORDER_HEADER_OBJ')。
• 版本兼容性：确保oracledb版本支持自定义对象/表类型操作，建议使用最新稳定版（oracledb 5.x及以上对自定义类型支持更完善）。
• 日期类型处理：如果传递日期，直接用JS的Date对象即可，oracledb会自动转换为Oracle的DATE类型。

内容的提问来源于stack exchange，提问作者Kevin Valencia Cruz