Oracle升级后BLOB下载失效，求存储过程下载到本地的正确方法

针对Oracle 19c + ORDS/mod_owa环境下的BLOB下载问题，以下是经过验证的正确实现，同时分析你之前方案的问题：

完整实现代码 #

CREATE OR REPLACE PROCEDURE download_blob(
    p_blob_id    IN NUMBER,    -- 用于定位BLOB数据的主键/标识
    p_filename   IN VARCHAR2,  -- 下载后显示的文件名
    p_mime_type  IN VARCHAR2   -- 文件对应的MIME类型
) IS
    l_blob       BLOB;
    v_buf        RAW(32767);   -- 二进制缓冲区，匹配PL/SQL RAW最大长度限制
    v_blob_len   NUMBER;
    v_offset     NUMBER := 1;
BEGIN
    -- 从业务表中获取目标BLOB数据，请替换为你的实际查询逻辑
    SELECT your_blob_column 
      INTO l_blob 
      FROM your_document_table 
     WHERE id = p_blob_id;

    -- 设置HTTP响应头
    owa_util.mime_header(p_mime_type, FALSE);
    -- 转义文件名特殊字符（空格、中文等），避免浏览器解析异常
    htp.p('Content-Disposition: attachment; filename="' || UTL_URL.escape(p_filename, TRUE) || '"');
    -- 输出文件总长度，帮助浏览器显示下载进度
    htp.p('Content-Length: ' || DBMS_LOB.GETLENGTH(l_blob));
    owa_util.http_header_close;

    -- 分块读取并输出BLOB二进制数据
    v_blob_len := DBMS_LOB.GETLENGTH(l_blob);
    WHILE v_offset <= v_blob_len LOOP
        -- 每次读取最多32767字节的二进制数据
        DBMS_LOB.READ(
            lob_loc => l_blob,
            amount  => LEAST(v_blob_len - v_offset + 1, 32767),
            offset  => v_offset,
            buffer  => v_buf
        );
        -- 用二进制输出函数发送数据，避免字符编码转换
        owa_util.print_raw(v_buf);
        v_offset := v_offset + 32767;
    END LOOP;
EXCEPTION
    WHEN NO_DATA_FOUND THEN
        htp.send_error(404, '请求的文件不存在');
    WHEN OTHERS THEN
        htp.send_error(500, '下载失败: ' || SQLERRM);
END;
/

你之前方案的问题分析 #

1. 第一个方案（文件损坏）
   你使用dbms_lob.substr(l_data, v_buf_len, v_start)将BLOB转换为VARCHAR2，再用htp.prn输出。这会把二进制数据按数据库字符集进行编码转换，破坏PDF、docx等二进制文件的字节结构，导致文件损坏。必须使用RAW类型存储二进制片段，并用owa_util.print_raw直接输出二进制数据，避免编码转换。

2. 第二个方案（缓冲区溢出）
   将BLOB转换为CLOB完全不适用于二进制文件——这类文件不是纯文本格式，转换过程会丢失关键二进制信息。同时你在循环中重复执行dbms_lob.writeappend和dbms_lob.write，导致CLOB数据重复写入，加上utl_raw.cast_to_varchar2的长度限制，触发了ORA-06502错误。

环境升级相关的注意事项 #

• 原wpg_docload.download_file失效：Oracle 19c与新版本ORDS/mod_owa的兼容性问题导致该内置包无法正常工作，官方推荐使用OWA原生API手动处理二进制输出。
• MIME类型必须匹配文件类型：例如：
  • PDF: application/pdf
  • DOCX: application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • XLSX: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
• 文件名转义：必须用UTL_URL.escape处理特殊字符，避免浏览器解析文件名时出现乱码或截断。

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