如何在Oracle ORDS集合服务中设置401未授权状态码？

集合查询是否支持直接返回401状态码？ #

集合查询本身不支持直接在查询逻辑中修改HTTP状态码。它的核心作用是处理数据查询、分页并返回结果集，HTTP状态码通常由服务框架默认处理（比如查询无结果时返回200+空列表），无法通过纯SQL查询逻辑直接覆盖。

替代实现方案 #

方案一：给集合查询添加前置权限校验 #

在集合查询执行前，新增一个PL/SQL块做权限校验，无权限时主动抛出异常并设置状态码，让框架捕获后返回401：

1. 编写权限校验的PL/SQL块，示例如下：

   DECLARE
     v_has_access BOOLEAN;
   BEGIN
     -- 替换为你的实际权限校验逻辑，比如检查用户与实体的关联权限
     SELECT EXISTS(
       SELECT 1 FROM entity_permissions 
       WHERE entity_id = :target_entity_id 
         AND user_id = :current_user_id
     ) INTO v_has_access FROM DUAL;
   
     IF NOT v_has_access THEN
       :status_code := 401;
       RAISE_APPLICATION_ERROR(-20001, '未授权访问该实体');
     END IF;
   END;
   

2. 将这个PL/SQL块配置为集合服务的前置处理步骤：框架会先执行该校验，若权限不通过，直接终止后续集合查询，返回401状态码；校验通过则正常执行集合查询和分页逻辑。

方案二：手动实现分页逻辑（不依赖集合服务） #

如果无法使用集合服务的自带分页，可手动实现分页并结合权限校验：

• 步骤1：权限校验
  先执行与方案一相同的PL/SQL权限校验逻辑，无权限时直接设置:status_code为401并返回，跳过后续查询。
• 步骤2：手动分页查询
  使用ROW_NUMBER()窗口函数实现分页，同时获取总记录数用于分页信息：

  -- 获取当前页数据
  SELECT * FROM (
    SELECT 
      t.*,
      ROW_NUMBER() OVER(ORDER BY t.create_time DESC) AS row_num
    FROM target_entity t
    -- 这里添加你的业务查询条件
  ) temp
  WHERE row_num BETWEEN (:page_num - 1)*:page_size + 1 AND :page_num*:page_size;
  
  -- 获取总记录数（用于分页导航）
  SELECT COUNT(*) FROM target_entity t
  -- 与上面一致的业务查询条件
  

• 步骤3：组装响应
  将分页数据、总记录数、当前页、每页大小组装成响应结构，权限校验不通过时确保返回401状态码。

关于你之前尝试失败的原因 #

• 直接在集合查询中绑定:status_code输出参数：集合查询是纯SQL语句，不是PL/SQL块，无法处理输出参数和异常抛出逻辑，因此该方式无效。
• 添加and :status_code = 401作为查询条件：:status_code是HTTP响应的状态参数，不属于SQL查询的条件参数，系统无法识别它作为查询过滤条件，因此不会生效。

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