根本原因是Oracle不支持运行时重载函数解析，必须用命名调用+显式类型转换的PL/SQL匿名块包装；或改用非重载PROCEDURE分发调用。
ODP.NET调用Oracle重载函数为什么总报 PLS-00307？
根本原因是 Oracle 服务端不支持通过 PL/SQL 匿名块或直接 SQL 调用重载函数（overloaded function）——ODP.NET 发送的命令最终被 Oracle 解析时，无法根据参数类型/个数自动绑定到具体重载版本。你看到的 PLS-00307: too many declarations of 'XXX' match this call 就是典型表现。
这不是 ODP.NET 的 bug，而是 Oracle PL/SQL 的设计限制：重载解析只在编译期（即包体编译时）完成，运行时调用必须显式指定目标签名。
- 别试图用
cmd.CommandText = "SELECT my_pkg.get_value(123) FROM DUAL"直接调用重载函数 - 别指望 ODP.NET 自动推导参数类型来匹配重载 —— 它连 Oracle 的重载元信息都拿不到
- Oracle 12c+ 的
EDITIONABLE或SYNONYM也解决不了这个问题
必须用命名调用（named notation）+ 显式类型转换
唯一可靠方式是把调用包装进匿名 PL/SQL 块，并用命名参数 + CAST 或 TO_NUMBER/TO_CHAR 等强制类型标注，让 Oracle 编译器能唯一确定重载分支。
假设包 my_pkg 有两个重载函数：
FUNCTION get_value(p_id NUMBER) RETURN VARCHAR2; FUNCTION get_value(p_code VARCHAR2) RETURN NUMBER;
正确调用方式（C#）：
using (var cmd = conn.CreateCommand())
{
cmd.CommandText = @"
DECLARE
v_result VARCHAR2(100);
BEGIN
v_result := my_pkg.get_value(p_id => :p_id); -- 明确指定参数名和类型
:result := v_result;
END;";
cmd.Parameters.Add(new OracleParameter("p_id", OracleDbType.Int32) { Value = 42 });
cmd.Parameters.Add(new OracleParameter("result", OracleDbType.Varchar2, ParameterDirection.Output) { Size = 100 });
<pre class="brush:php;toolbar:false;">cmd.ExecuteNonQuery();
string output = cmd.Parameters["result"].Value.ToString();}
- 必须用
p_id => :p_id这种命名调用，不能省略参数名 - 如果传入的是
NULL，需额外加CAST(NULL AS NUMBER)，否则 Oracle 无法推断类型 - 输出参数类型（
OracleDbType）必须与目标重载函数返回类型严格一致，否则会触发隐式转换失败
用 REF CURSOR 返回多结果集时重载更危险
如果重载函数返回 REF CURSOR，而你又在 C# 中用 OracleDbType.RefCursor 绑定，ODP.NET 可能静默忽略类型不匹配，导致运行时报 ORA-06550 或游标为空。
- 务必在 PL/SQL 块中显式打开游标：
OPEN :rc FOR SELECT * FROM ...，不要依赖函数返回值自动赋给:rc - 避免在同一个包里对相同函数名混用
RETURN REF CURSOR和RETURN NUMBER—— 即使签名不同，某些 ODP.NET 版本（如 19.11）会在元数据缓存中冲突 - 测试时用
OracleCommand.DumpParameters()（需引用Oracle.ManagedDataAccess.Debug）确认实际绑定的参数类型
替代方案：改用过程（PROCEDURE）封装重载逻辑
比硬扛重载函数更稳健的做法，是在包里新增一个非重载的 PROCEDURE，由它根据输入类型分发到对应函数。这样 C# 端只需调用单一过程名，无需操心重载解析。
PROCEDURE get_value_dispatch(
p_input_type VARCHAR2, -- 'ID' or 'CODE'
p_input_val VARCHAR2,
p_result OUT VARCHAR2
)
然后在 C# 中统一调用这个过程，用字符串控制分支。虽然多了一层 PL/SQL，但彻底规避了重载解析不确定性，也方便后续加日志、权限校验等。
真正麻烦的从来不是写几行绑定代码，而是当包升级新增第三个重载时，所有用匿名块硬编码参数名的地方都要人工检查 —— 类型、顺序、空值处理，一个漏掉就线上报错。
