Oracle Apex使用apex_data_export.download无文件下载且无报错排查

代码中的直接问题 #

你的代码里有两处关键错误导致下载失败：

1. APEX_JSON.free_output; 清空了下载输出：apex_data_export.download 依赖APEX的JSON输出缓冲区生成下载响应，你在调用download后立即执行free_output，会直接清空要发送给浏览器的下载内容，导致没有文件输出。
2. 无效的DBMS_OUTPUT.put_line(l_context);：l_context是apex_exec.t_context类型的对象，直接打印无意义；且这行代码位于EXCEPTION块之后，此时l_context已经被apex_exec.close关闭，执行时会引发未捕获的错误（虽然你没看到报错，但可能被APEX的错误处理机制屏蔽）。

修正后的代码 #

DECLARE
    l_context apex_exec.t_context;
    l_export  apex_data_export.t_export;
BEGIN
    l_context := apex_exec.open_query_context(
        p_location    => apex_exec.c_location_local_db,
        p_sql_query   => 'select output from TFA_USER',
        p_where_clause => :P0_SUB );

    l_export := apex_data_export.export (
        p_context   => l_context,
        p_format    => apex_data_export.c_format_json,
        p_file_name => 'test' );

    apex_exec.close( l_context );

    apex_data_export.download( p_export => l_export );

EXCEPTION
    WHEN OTHERS THEN
        IF apex_exec.is_open(l_context) THEN
            apex_exec.close( l_context );
        END IF;
        RAISE;
END;

无报错情况下的排查步骤 #

如果修正代码后仍无法下载，按以下步骤排查：

• 确认代码执行时机：确保这段代码在**页面进程（Process）**中执行，且进程的执行点设置为On Submit - After Computations and Validations；如果是按钮触发，按钮行为需设为Submit Page，不要用AJAX或JavaScript触发（除非你手动处理了响应）。
• 检查HTTP响应：打开浏览器开发者工具（F12），切换到Network标签，触发下载操作后查看请求的响应：
  • 确认存在Content-Disposition响应头，格式应为attachment; filename="test.json"
  • 查看响应体是否包含正确的JSON数据，若为空则说明导出逻辑未生成有效内容
• 验证导出数据：在调用download前，添加临时代码验证导出内容：

  DBMS_OUTPUT.put_line(apex_data_export.get_content(l_export));
  

  运行后查看DBMS输出，确认导出的JSON内容非空且正确。
• 排除浏览器干扰：使用浏览器隐私模式测试，或关闭广告拦截、安全类扩展，部分扩展会拦截未标记为安全的文件下载。
• 检查APEX版本：旧版本APEX的apex_data_export可能存在兼容性问题，确保使用20.2及以上的稳定版本，若版本过低建议升级后测试。
• 排查其他代码干扰：检查页面是否有其他进程、动态动作在同一时间执行，避免多个操作同时修改HTTP响应头，导致下载响应被覆盖。

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