Oracle Apex动态动作中调用外部API的JavaScript代码执行失败求助

排查方向1：Apex内容安全策略（CSP）拦截 #

Apex 22.1默认CSP规则严格，即使外部API开启CORS，前端请求仍可能被页面CSP拦截：

• 进入页面属性 → 安全 → 内容安全策略，检查connect-src是否包含目标API域名，可临时设置为connect-src *测试（生产环境需指定具体域名）。
• 若页面启用了CSP报告模式，查看浏览器控制台的CSP违规报告，确认是否是该规则导致请求被拦截。

排查方向2：Fetch请求格式错误（requestContent相关报错） #

Cannot read properties of undefined (reading 'requestContent')通常和请求参数或Apex对Fetch的兼容有关：

• 确保请求头与API要求匹配，尤其是JSON类型的请求需明确指定Content-Type：

  fetch('https://你的API域名/接口路径', {
    method: 'GET',
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json'
    },
    credentials: 'omit' // 若API不需要身份凭证，显式关闭避免额外校验
  })
  .then(res => {
    if (!res.ok) throw new Error(`HTTP错误：${res.status}`);
    return res.json();
  })
  .then(data => {
    // 处理报表路径逻辑
    console.log(data.reportPath);
  })
  .catch(err => {
    console.error('请求失败:', err);
  });
  

• 避免混淆Apex内置的apex.server.fetch与原生Fetch，前者是封装后的AJAX方法，和原生Fetch的参数格式不兼容。

排查方向3：ACL配置有效性验证 #

确认ACL是针对Apex的解析用户配置（通常为APEX_220100）：

• 用SYS用户执行以下SQL，确保权限覆盖目标API的域名和端口：

  BEGIN
    DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
      host => '你的API域名',
      lower_port => 443, -- HTTPS端口，若为HTTP则填80
      upper_port => 443,
      ace => xs$ace_type(
        privilege_list => xs$name_list('connect'),
        principal_name => 'APEX_220100',
        principal_type => xs_acl.ptype_db
      )
    );
    COMMIT;
  END;
  /
  

• 查询ACL生效状态：

  SELECT host, lower_port, upper_port, principal_name
  FROM dba_network_acls
  JOIN dba_network_acl_aces ON dba_network_acls.acl = dba_network_acl_aces.acl
  WHERE principal_name = 'APEX_220100';
  

排查方向4：通过Apex Web服务代理转发请求 #

若前端跨域问题无法解决，可通过数据库侧转发请求：

• 在Apex中创建Web服务参考，指向目标API；
• 使用apex.server.invoke调用该参考，请求将从数据库服务器发出，绕过前端跨域限制：

  apex.server.invoke({
    serverType: 'webService',
    webService: '你的Web服务参考名称',
    method: 'GET',
    success: function(data) {
      console.log(data.reportPath);
    },
    error: function(xhr, status, err) {
      console.error('调用失败:', err);
    }
  });
  

额外检查点 #

• 确认API URL协议（http/https）与Apex页面协议一致，HTTPS页面无法发起HTTP请求；
• 查看浏览器开发者工具网络标签，确认请求是否发出：无请求记录则是CSP拦截，有请求则查看响应状态码和错误详情。

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