Oracle中不存在私有重载函数，因为重载要求所有同名子程序必须在同一作用域（即包规范）内声明，编译器才能在编译期完成签名匹配；若仅在包体中定义，则视为重复声明而非重载。
Oracle 不允许在包规范（PACKAGE）中声明私有函数，私有元素只能出现在包体（PACKAGE BODY）里；而重载（overloading）要求所有同名子程序必须在**同一作用域内声明**——也就是说，所有重载版本都得一起出现在包规范中，否则编译器无法做签名比对。所以，“私有重载函数”这个说法本身在 Oracle PL/SQL 中是矛盾的：你要么公开（进包头），要么不能重载（只能在包体内单个定义）。
为什么包规范里必须放所有重载版本
Oracle 编译器靠包规范中的完整声明列表来识别哪些子程序构成重载组。它在解析调用语句时，根据实参个数、位置和数据类型，在规范中匹配最合适的签名。如果某个重载版本只写在包体里，编译器在编译包体前根本不知道它的存在，更无法参与重载解析——直接报 PLS-00307: too many declarations of 'XXX' match this call 或 PLS-00306: wrong number/type of arguments。
- 重载判断发生在**编译期**，依赖包规范中并列声明的全部同名子程序
- 包体里的子程序若未在包规范中声明，就是“不可见”的，对外不可调用，对内也不能参与重载调度
- 即使两个过程逻辑相似、参数仅差一个
OUT，只要没同时列在包规范里，就不算重载
想实现“类似私有重载”的实际做法
没有真正私有的重载，但可通过组合策略隐藏实现细节：
- 在包规范中只声明**一组公有重载接口**（比如两个
get_employee_info，参数不同），它们都调用同一个内部逻辑 - 把真正干活的逻辑抽成**包体内的私有函数**（不带重载，名字不暴露），由公有重载过程统一委派
- 避免在包体里另写一个同名函数——那只会导致编译失败或静默覆盖，不是重载
- 例如：
pkg_emp.get_employee_info(p_id IN NUMBER)和pkg_emp.get_employee_info(p_name IN VARCHAR2)都在包规范中声明；包体里用一个私有函数get_emp_by_key(p_key VARCHAR2, p_type VARCHAR2)统一查库
常见错误：试图在包体里单独重载
下面这种写法会失败：
CREATE OR REPLACE PACKAGE pkg_test IS FUNCTION calc(p_val NUMBER) RETURN NUMBER; END; <p>CREATE OR REPLACE PACKAGE BODY pkg_test IS FUNCTION calc(p_val NUMBER) RETURN NUMBER IS BEGIN RETURN p_val <em> 2; END; -- ❌ 错误：这里再加一个同名函数，编译报 PLS-00307 FUNCTION calc(p_val NUMBER, p_factor NUMBER) RETURN NUMBER IS BEGIN RETURN p_val </em> p_factor; END; END;
原因：包规范里只声明了一个 calc，包体里却试图定义两个，Oracle 认为这是重复定义，不是重载。要支持第二个签名，必须先加到包规范中：
CREATE OR REPLACE PACKAGE pkg_test IS FUNCTION calc(p_val NUMBER) RETURN NUMBER; FUNCTION calc(p_val NUMBER, p_factor NUMBER) RETURN NUMBER; -- ✅ 必须补上 END;
真正难处理的点在于：一旦放进包规范，就等于公开了接口。所谓“私有重载”，本质上是个伪需求——Oracle 的设计决定了重载必须可见，而可见就意味着可被外部调用。绕不开这点，就别强求“私有”。
