Oracle存储过程返回SYS_REFCURSOR与Entity Framework模型适配问题

我之前处理过好几例类似的版本不匹配+SYS_REFCURSOR的问题，结合你的环境（服务端11.2、客户端12.1，VS2017 + Oracle Managed DataAccess 12.1），这个PLS-00306错误大概率是版本兼容性导致的SYS_REFCURSOR参数映射问题，或者是ADO.NET实体模型向导导入时的参数类型识别错误。下面是几个亲测有效的解决办法：

一、绕开EDMX，手动构建OracleCommand调用存储过程 #

有时候EDMX向导会错误地把SYS_REFCURSOR映射成不合适的类型，这时候手动写调用代码反而更可靠。你可以直接用OracleManagedDataAccess的类来构建命令，明确指定游标参数的类型：

using (var conn = new OracleConnection(你的连接字符串))
{
    conn.Open();
    using (var cmd = new OracleCommand("my_procedure", conn))
    {
        cmd.CommandType = CommandType.StoredProcedure;
        
        // 配置输出游标参数
        var cursorParam = new OracleParameter("p_cursor", OracleDbType.RefCursor);
        cursorParam.Direction = ParameterDirection.Output;
        cmd.Parameters.Add(cursorParam);
        
        // 添加存储过程需要的输入参数（根据实际情况调整）
        cmd.Parameters.Add("p_input_param", OracleDbType.Varchar2).Value = "你的输入值";
        
        // 执行并读取游标数据
        using (var reader = cmd.ExecuteReader())
        {
            while (reader.Read())
            {
                // 这里处理读取到的数据，比如 reader.GetString(0) 之类的操作
            }
        }
    }
}

这种方式完全避免了EDMX的映射问题，直接和Oracle数据库交互，兼容性更好。

二、配置Oracle客户端的版本兼容性 #

因为你的服务端是11.2，客户端是12.1，版本差异可能导致游标类型的识别冲突。你可以在项目的app.config或web.config中添加兼容性设置，让客户端以11.2的模式工作：

<configuration>
  <oracle.manageddataaccess.client>
    <version number="*">
      <settings>
        <!-- 指定和服务端一致的版本兼容性 -->
        <setting name="OracleDbCompatibility" value="11.2"/>
        <setting name="StatementCacheSize" value="100"/>
      </settings>
    </version>
  </oracle.manageddataaccess.client>
</configuration>

这个设置会让Oracle客户端适配服务端的版本，减少因为版本差异带来的参数类型不匹配问题。

三、重新生成实体模型并检查参数映射 #

有时候EDMX向导导入时会因为缓存或者版本问题出现参数映射错误，你可以试试以下步骤：

• 删除当前的ADO.NET实体数据模型文件（EDMX）
• 右键项目选择清理，清除项目的编译缓存
• 重新运行“添加新ADO.NET实体数据模型”向导，在选择存储过程时，仔细核对每个参数的类型和方向：
  • 确保SYS_REFCURSOR类型的参数被识别为输出方向
  • 检查返回类型是否正确映射到对应的实体或复杂类型
• 如果存储过程有多个参数，务必确认每个参数的类型、数量和方向都和数据库中的存储过程定义一致

四、先在Oracle端验证存储过程的正确性 #

在排查.NET端问题之前，先确认存储过程本身是正常的。你可以在PL/SQL Developer或者SQL*Plus中执行以下测试代码：

DECLARE
  v_result_cursor SYS_REFCURSOR;
BEGIN
  -- 替换成你存储过程的实际参数
  my_procedure(p_input => '测试值', p_cursor => v_result_cursor);
  
  -- 测试读取游标数据（根据实际返回的字段调整）
  FETCH v_result_cursor INTO v_col1, v_col2;
  DBMS_OUTPUT.PUT_LINE(v_col1 || ' ' || v_col2);
  
  CLOSE v_result_cursor;
END;
/

如果这段代码能正常执行并输出结果，说明存储过程本身没问题，问题肯定出在.NET端的参数映射或者兼容性设置上。

内容的提问来源于stack exchange，提问作者Carl in 't Veld