如何在Oracle存储过程中检查TIMESTAMP类型入参是否为NULL？

我们有一个接收多个TIMESTAMP类型输入参数的Oracle存储过程，由TypeScript调用。调用时部分TIMESTAMP参数可能会传入NULL值。需要实现存储过程中TIMESTAMP参数的NULL检查，注意不能为TIMESTAMP设置默认值——因为存储过程的SELECT语句包含大于/小于、等于的条件判断。

当前存储过程的NULL检查逻辑未生效，无法返回预期提示信息：

CREATE OR REPLACE PROCEDURE get_task_list (
    p_startdate         IN   TIMESTAMP,
    p_enddate           IN   TIMESTAMP,
    .
    .
    .
    p_message           OUT  VARCHAR2
)
AS
BEGIN
    IF p_startdate IS NULL THEN
        p_message := 'p_startdate is null ';
    END IF;
    
END get_task_list;

对应的TypeScript绑定参数代码片段：

const p_startdate: OracleDB.BindParameter = {
    dir: OracleDB.BIND_IN,
    val: new Date(request.tasklist.startdate as unknown as string),
    type: OracleDB.DB_TYPE_TIMESTAMP,
}

调试时发现TypeScript解析后的startdate绑定参数如下：

p_startdate: {
     "dir": 3001,
     "val": null,
     "type": {
         "num": 2012,
         "name": "DB_TYPE_TIMESTAMP",
         "columnTypeName": "TIMESTAMP",
         "_bufferSizeFactor": 11,
         "_oraTypeNum": 180,
         "_csfrm": 0
     }
 }

使用版本：

• node: ^21.6.1
• oracledb: ^6.3.0
• typescript: ^5.3.3

问题原因及解决办法 #

原因分析 #

从调试结果看，TypeScript端确实传递了val: null，但存储过程的检查未触发——核心问题是Oracle处理NULL传入TIMESTAMP参数的特殊逻辑：当客户端传入NULL时，Oracle会将其视为未绑定参数，而非显式的NULL值，导致存储过程内的IS NULL判断失效。

解决方案 #

1. 存储过程端优化检查逻辑

修改存储过程，初始化提示信息并在检查到NULL后立即终止后续逻辑，避免干扰：

CREATE OR REPLACE PROCEDURE get_task_list (
    p_startdate         IN   TIMESTAMP,
    p_enddate           IN   TIMESTAMP,
    .
    .
    .
    p_message           OUT  VARCHAR2
)
AS
BEGIN
    -- 初始化提示信息为空
    p_message := '';
    
    -- 检查p_startdate是否为NULL
    IF p_startdate IS NULL THEN
        p_message := p_message || 'p_startdate is null; ';
    END IF;
    
    -- 检查其他TIMESTAMP参数
    IF p_enddate IS NULL THEN
        p_message := p_message || 'p_enddate is null; ';
    END IF;
    
    -- 若存在错误提示，直接返回，不执行后续查询逻辑
    IF p_message <> '' THEN
        RETURN;
    END IF;
    
    -- 后续SELECT查询逻辑
    -- ...
    
END get_task_list;

2. TypeScript端参数传递优化

避免直接将null传入new Date()，先判断值是否有效再绑定，确保NULL值正确传递：

const startDateVal = request.tasklist.startdate ? new Date(request.tasklist.startdate as unknown as string) : null;

const p_startdate: OracleDB.BindParameter = {
    dir: OracleDB.BIND_IN,
    val: startDateVal,
    type: OracleDB.DB_TYPE_TIMESTAMP,
}

3. 调试辅助：用DUMP函数确认参数值

如果问题仍存在，可在存储过程中添加DUMP函数输出参数的实际存储内容，排查NULL是否正确传入：

CREATE OR REPLACE PROCEDURE get_task_list (
    p_startdate         IN   TIMESTAMP,
    p_enddate           IN   TIMESTAMP,
    .
    .
    .
    p_message           OUT  VARCHAR2
)
AS
BEGIN
    -- 输出参数的DUMP信息，用于调试
    DBMS_OUTPUT.PUT_LINE('p_startdate DUMP: ' || DUMP(p_startdate));
    
    IF p_startdate IS NULL THEN
        p_message := 'p_startdate is null ';
    END IF;
    
END get_task_list;

内容的提问来源于stack exchange，提问作者Ranjeet