如何解决ORA-06502: PL/SQL数值或值错误？CLOB调用htp.prn报错

问题背景 #

存储在CLOB中的长文本包含中文内容，调用htp.prn输出时触发ORA-06502: PL/SQL: numeric or value error错误。代码逻辑中通过dbms_lob.getlength获取到字符数为31745，小于预设的32000阈值，但依然报错，怀疑问题出在dbms_lob.getlength的判断逻辑上。

出错代码片段：

n := dbms_lob.getlength(html);      -- n is 31745 characters

if n<32000 then
    htp.prn(HTML);                  -- << Error raised here 
else
    do something else
end if;

问题根源 #

dbms_lob.getlength返回的是CLOB中的字符数，但htp.prn接收的VARCHAR2类型参数在PL/SQL中的限制是32767字节（而非字符数）。中文属于多字节字符（比如UTF-8编码下每个中文占3字节），31745个中文字符对应的字节数会远超过32767，当Oracle隐式将CLOB转换为VARCHAR2时，就会触发数值/值错误。

解决方法 #

放弃基于字符数的判断，直接按VARCHAR2的最大字节限制拆分CLOB，分多次调用htp.prn输出。以下是可靠的实现代码：

DECLARE
    v_clob CLOB := html; -- 替换为你的CLOB变量
    v_offset NUMBER := 1;
    v_max_bytes NUMBER := 32767; -- PL/SQL VARCHAR2的最大字节容量
    v_chunk VARCHAR2(32767);
BEGIN
    WHILE v_offset <= DBMS_LOB.GETLENGTH(v_clob) LOOP
        -- 按字节数安全截取CLOB，自动处理多字节字符避免截断
        v_chunk := DBMS_LOB.SUBSTR(v_clob, v_max_bytes, v_offset);
        htp.prn(v_chunk);
        v_offset := v_offset + v_max_bytes;
    END LOOP;
END;

补充说明 #

• DBMS_LOB.SUBSTR在按字节数截取时，会自动调整实际截取的字符数，确保不会拆分多字节字符（比如不会把一个中文拆成两半），因此无需额外处理字符边界问题。
• 无论CLOB的字符数多少，这种循环拆分的方式都能避免触发ORA-06502错误，同时保证输出内容完整。

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