java方法重载优先选择无需装箱的方法，匹配分三阶段：①精确匹配与基本类型提升，②装箱/拆箱，③varargs；装箱仅在前两阶段无匹配时触发，且不参与跨阶段比较。
Java 中方法重载与自动装箱的匹配过程，遵循“编译期静态分派”规则，优先选择**无需类型转换或仅需基本类型提升（widening）的方法**；只有在找不到更优匹配时，才会考虑自动装箱/拆箱（boxing/unboxing）和可变参数（varargs）。自动装箱本身不具有高优先级，它属于较“宽泛”的转换层级。
重载解析的三阶段优先级
Java 编译器按严格顺序尝试匹配重载方法，共三个阶段：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
第一阶段（最优先）：只考虑不涉及装箱、拆箱、varargs 的方法。例如传入
int，能直接匹配void m(int)或void m(long)（因int → long是 widening），但不会选void m(Integer)（需装箱）。 -
第二阶段：允许装箱/拆箱，但排除 varargs。此时
int可匹配void m(Integer)（装箱）、void m(int...)不参与此阶段。 -
第三阶段（兜底）：允许 varargs，同时支持装箱/拆箱。例如
void m(Integer...)或void m(Object...)。
常见冲突场景与实际例子
当多个重载方法在某阶段都“可行”，编译器会报错（ambiguous）：
void test(int x) { }
void test(Integer x) { }
test(5); // ✅ 调用 test(int) —— 第一阶段就匹配成功，不进第二阶段
void test(long x) { }
void test(Integer x) { }
test(5); // ✅ 调用 test(long) —— int→long 是 widening，优于 int→Integer 装箱
void test(Integer x) { }
void test(int... x) { }
test(5); // ❌ 编译错误！第二阶段（Integer）和第三阶段（int...）在不同阶段，但编译器要求“同一阶段内唯一最优”，此处跨阶段不比较，而第二阶段有 Integer 匹配，第三阶段也有 int... 匹配，导致模糊
如何避免意外匹配或编译失败
- 明确传参类型：如调用
test((Integer)5)强制走装箱路径，或test(5L)触发 long 版本。 - 避免设计语义相近的重载：例如同时提供
f(int)和f(Integer)，易引发维护困惑和歧义。 - 注意 null 值：传
null给重载方法时，若多个引用类型参数都可接受（如f(String)和f(Integer)），编译器无法推断，直接报错。
自动装箱不是“隐式升级”，而是显式转换步骤
装箱（如 int → Integer）本质是编译器插入 Integer.valueOf(x) 调用，并非类型兼容性提升。因此它永远排在 widening（如 byte → int）之后。这也是为什么 short s = 1; m(s); 若有 m(int) 和 m(Short)，一定选 m(int) —— short 到 int 是 widening，short 到 Short 才是装箱。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
