SYS_REFCURSOR能动态适配不同结构结果集，因其是弱类型引用游标，本质为运行时绑定查询的指针，不校验编译期结构；同一变量可先后OPEN FOR不同SELECT语句，由调用方按实际元数据解析。
为什么 SYS_REFCURSOR 能动态适配不同结构结果集
SYS_REFCURSOR 是弱类型引用游标，本质是一个运行时才绑定查询的指针，不依赖编译期确定的列名或数据类型。它不像强类型 REF CURSOR 那样要求 RETURN emp%ROWTYPE，所以同一变量可先后 OPEN FOR SELECT id, name FROM users 和 OPEN FOR SELECT dept_name, count(*) FROM depts GROUP BY dept_name，只要调用方能处理对应结构即可。
关键点在于：Oracle 不在声明游标变量时校验查询结构，而是在 FETCH 或客户端取数时才按实际结果集元数据解析。这就给了存储过程“一个出口、多种形态”的能力。
- 不能用于静态 SQL 场景（如 PL/SQL 块内直接
FETCH），因为编译器需要知道列定义；必须配合客户端（JDBC、ODP.NET、cx_Oracle）或动态 SQL（EXECUTE IMMEDIATE+OPEN FOR）使用 - 强类型 REF CURSOR（如
TYPE t_cur IS REF CURSOR RETURN users%ROWTYPE）无法跨表复用，一换查询就报错 - 所有动态行为都发生在
OPEN p_cursor FOR ...这一行，前面的声明只是占位
如何在存储过程中用 IF/ELSE 切换不同查询
典型场景是权限控制或前端传参决定返回字段粒度，比如 p_view_mode IN ('LIST', 'DETAIL')。此时不能拼接字符串再 EXECUTE IMMEDIATE（易 SQL 注入），而应直接在 OPEN FOR 后写分支查询。
示例存储过程片段：
CREATE OR REPLACE PROCEDURE get_data_by_mode(
p_view_mode IN VARCHAR2,
p_result OUT SYS_REFCURSOR
) AS
BEGIN
IF p_view_mode = 'LIST' THEN
OPEN p_result FOR
SELECT id, name, status FROM users WHERE status = 'ACTIVE';
ELSIF p_view_mode = 'DETAIL' THEN
OPEN p_result FOR
SELECT u.id, u.name, u.email, d.dept_name
FROM users u
JOIN departments d ON u.dept_id = d.id;
ELSE
OPEN p_result FOR
SELECT id, name FROM users WHERE 1=0; -- 空结果集兜底
END IF;
END;
- 每个
OPEN FOR必须对应完整、合法的 SELECT 语句，不能只写字段列表 - 不同分支返回列数、类型不要求一致，但调用方代码需自行适配（比如 Java 用
Map接收） - 避免用
EXECUTE IMMEDIATE 'SELECT ...' || p_col_list拼接，除非你严格过滤p_col_list中的字符（如只允许字母、下划线、逗号）
JDBC / MyBatis 中读取动态结构游标要注意什么
MyBatis 默认用 resultMap 绑定固定实体类，遇到列不匹配会抛 Invalid column type 或静默跳过字段。要支持动态结构，得绕过字段映射，改用通用容器。
- MyBatis XML 中游标参数仍需设
jdbcType=CURSOR和javaType=java.sql.ResultSet，但resultMap改为指向resultType="map"或留空（让框架自动转成LinkedHashMap） - Java 层别写
List接收，改用List，再根据实际列名判断是否存在"email"字段 - JDBC 原生调用时，
ResultSetMetaData可在运行时获取列名：rsmd.getColumnName(i)，这是唯一可靠方式 - 不要依赖
rs.getString("email")在所有模式下都存在——先rsmd.getColumnCount()再循环取值更安全
动态游标在 .NET SqlSugar 中怎么配才不丢数据
SqlSugar 的 SugarParameter 对 Oracle 游标支持较隐晦：它不自动识别 SYS_REFCURSOR 类型，必须显式标记 IsRefCursor = true，否则当成普通输出参数，返回空集合且不报错。
- 参数方向必须是
ParameterDirection.Output，初始值设为null或""（实测 Oracle.ManagedDataAccess 19.15+ 推荐null） - 不能用
Ado.UseStoredProcedure直接返回List，必须用Ado.UseCommand获取OracleDataReader，再调NextResult()（即使只有一个游标） - 若存储过程有多个
SYS_REFCURSOR输出，必须按声明顺序全部OPEN，哪怕某分支不需要数据——用OPEN p_cur FOR SELECT * FROM DUAL WHERE 1=0占位，否则驱动报ORA-01008 - SqlSugar 本身不提供动态列元数据 API，得从底层
OracleDataReader.GetSchemaTable()拿列定义
最易被忽略的是：动态结构意味着调用方永远不能假设“第 3 列一定是 email”，必须靠列名查值，且每次查询都要重新检查元数据——缓存列序号在多分支逻辑下必然出错。
