Java方法重载中，编译器优先匹配基本类型参数方法；传字面量或基本类型变量调用基本类型版本，传包装类对象调用包装类版本，传null则因歧义报错，强制类型转换可指定版本。
Java 中基本类型和包装类在方法重载里的调用，核心在于**编译期的参数匹配优先级**：当存在同名但参数分别为基本类型和对应包装类的方法时，编译器会**优先选择基本类型版本**，除非传入的是明确的包装类对象或 null。
参数匹配按“最精确匹配”原则进行
编译器不会自动把基本类型“升级”去匹配包装类方法，也不会把包装类“降级”去匹配基本类型方法。它只找能直接接受实参类型（或经自动转换后可接受）的方法：
- 传 字面量或基本类型变量（如
5、int x = 10;）→ 优先匹配基本类型参数方法 - 传 包装类对象（如
Integer.valueOf(5)、new Integer(5)）→ 匹配包装类参数方法 - 传 null → 只能匹配包装类参数方法（因为基本类型不能为 null）
常见调用场景与结果示例
假设有如下重载方法：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
public void handle(int x) { System.out.println("int version"); }
public void handle(Integer x) { System.out.println("Integer version"); }
-
handle(100);→ 输出 int version（字面量直接匹配基本类型） -
Integer i = 100; handle(i);→ 输出 Integer version（明确传入包装类对象） -
handle(null);→ 编译报错：reference to handle is ambiguous（两个方法都可能接受 null，编译器无法决定） -
handle((Integer) null);→ 输出 Integer version（强制类型指定）
自动装箱不影响重载决策时机
自动装箱（如 Integer i = 100;）发生在赋值阶段，而重载解析发生在**编译期**。也就是说：
立即学习“Java免费学习笔记（深入）”；
- 写
handle(100);时，编译器看到的是int字面量，直接绑定到handle(int) - 写
handle(i);时，编译器看到的是变量i的声明类型Integer，于是绑定到handle(Integer) - 自动装箱不改变重载解析逻辑，它只是让
int → Integer的转换对开发者透明
避免歧义的实用建议
当同时提供基本类型和包装类重载方法时，容易引发可读性差或意外调用问题：
- 尽量避免仅靠“基本类型 vs 包装类”做重载区分，尤其在公共 API 中
- 若必须共存，可通过命名区分（如
processInt(int)和processOptionalInt(Integer)） - 处理可能为 null 的参数时，直接使用包装类参数，并在方法内判空，比依赖重载更清晰
- 测试时注意覆盖
null、Integer.valueOf(128)（超出 Integer 缓存范围）等边界情况
