Oracle游标无返回行时%NOTFOUND为false问题排查

逻辑不生效有两个核心问题：

1. %NOTFOUND游标属性的触发时机不对：执行OPEN 游标 FOR SELECT语句时，Oracle仅完成游标初始化、SQL解析和执行计划生成，不会主动抓取结果集的第一行。此时%NOTFOUND的值为NULL，既不是TRUE也不是FALSE，在PL/SQL的条件判断中NULL会按非真处理，因此永远不会进入抛出异常的分支，直接走else逻辑。%NOTFOUND只有在执行FETCH语句抓取数据后才会更新状态：成功抓取到行时为FALSE，抓取不到行时才会置为TRUE。
2. 自定义异常绑定的错误码不合法：Oracle要求用户自定义异常的错误码必须在-20000 ~ -20999区间内，你绑定的-2001不在合法范围内，真的触发raise时会直接抛出ORA-21000的系统错误，无法按预期抛出自定义异常。

推荐用预校验的方式实现需求，性能最高也不存在版本兼容问题，不需要先开游标再回退数据：

create or replace function ReturnGroupsOfClass(class_id_in in integer) return sys_refcursor 
is
      FunctionResult sys_refcursor;
      v_data_exists number;
      exception_no_class_found exception;
      -- 注意自定义错误码必须在-20000到-20999区间，示例用-20001
      pragma exception_init(exception_no_class_found,-20001);

begin    
      -- 加rownum=1只要匹配到1条数据就停止扫描，性能最优
      select count(1) 
        into v_data_exists
        from Participant_In_Group 
       where class_id = class_id_in
         and rownum = 1;
    
      if v_data_exists = 0 then
          raise exception_no_class_found;
      end if;

      -- 确认有数据再打开返回游标
      open FunctionResult for  
      select class_ID, group_day, group_startHour, count(*) as num_of_participants
        from Participant_In_Group 
       where class_id = class_id_in
       group by class_ID, group_day, group_startHour
       order by class_ID;
    
      dbms_output.put_line('you can view the cursor in the test window');
      return FunctionResult;
end ReturnGroupsOfClass;

如果不想做预校验，也可以在打开游标后主动抓取第一行判断是否有数据，再通过游标滚动把指针复位到第一行之前，但这个方案仅支持Oracle 12c及以上版本，且写法更繁琐，容易出现返回结果丢失第一行的问题，不推荐使用。

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