其实在Java日常开发中，返回多个结果是高频场景，但Java原生不支持直接返回多值，**通过封装自定义对象、使用容器类、返回数组三种主流方案**可解决这类需求，**自定义对象方案可维护性最优**，同时需结合业务复杂度选择适配方案。

# Java返回两个值的6种实战方案

## 一、Java返回多值的底层限制与核心思路
其实Java方法的底层设计决定了单个方法仅能返回一个值，JVM栈帧的返回值槽位仅能存储一个引用类型或基本类型数据，无法直接承载多个独立结果。不难发现，所有多值返回方案本质都是将多个结果封装为单个可传递的对象载体，再通过方法返回该载体实现多值传递。接下来将拆解各类封装方案的优劣势，帮助开发者结合业务场景快速选型。

## 二、6种主流返回多值方案实战解析
### 1. 自定义实体类封装返回值
这是Java返回两个值最基础也是最通用的方案，开发者可创建包含两个结果字段的实体类，将需要返回的两个值赋值给实体类属性后返回。比如在用户登录场景中，可创建LoginResult类，包含token和userInfo两个字段，登录方法返回该实体类即可同时传递会话凭证与用户信息。值得注意的是，自定义实体类需遵循JavaBean规范，添加标准getter、setter方法，便于后续序列化与框架适配。这种方案的可读性极强，后续维护者可通过类名与字段名快速理解返回值含义，不会出现类型混淆问题。
### 2. 使用Map容器临时存储结果
如果仅需临时返回两个值且无需长期复用返回结构，可使用HashMap等容器类存储结果，以字符串作为键名标记返回值类型，比如将第一个结果存入"result1"键，第二个结果存入"result2"键。其实这种方案开发成本极低，无需额外创建实体类，适合临时调试或简单场景快速实现，但长期维护难度高，后续开发者需手动记忆键名含义，容易出现键名拼写错误导致的空指针异常。
### 3. 返回长度固定的数组
开发者可返回长度为2的Object[]数组，将两个结果按固定顺序存入数组中，调用方按下标获取对应结果。比如在计算矩形面积与周长的方法中，返回new Object[]{area, perimeter}，调用方通过下标0获取面积、下标1获取周长。这种方案代码简洁，但类型安全性差，调用方无法直接感知数组元素的实际类型，容易触发ClassCastException，仅适合返回值类型固定的简单计算场景。
### 4. 利用Java 8 Pair容器类
Java 8提供了javafx.util.Pair工具类，可直接存储两个泛型类型的结果，通过getKey()和getValue()方法分别获取第一个与第二个返回值。其实Pair类本质是JDK提供的通用多值封装类，省去了开发者自定义实体类的步骤，但该类属于javafx模块，部分轻量Java环境可能未默认集成，使用前需确认项目依赖是否完整。
### 5. 借助第三方工具库Tuple
除JDK自带工具类外，Apache Commons Lang3、Guava等第三方工具库提供了更完善的Tuple多值封装类，支持存储2到多个返回值，比如Guava的ImmutablePair类与Apache的Pair类，不仅提供类型安全的泛型支持，还内置了equals、hashCode等通用方法，适配更多复杂业务场景。值得注意的是，引入第三方库会增加项目依赖体积，需权衡依赖成本与开发效率。
### 6. 通过回调方法异步返回结果
对于异步执行的方法场景，可通过回调接口实现多值返回，将两个结果作为回调方法的参数传递给调用方。比如在文件上传方法中，传入包含onSuccess(uploadUrl, fileSize)方法的回调接口，上传完成后触发回调同时传递文件访问地址与文件大小。这种方案适合非阻塞的异步IO场景，避免主线程等待耗时操作，但开发复杂度较高，需额外定义回调接口实现类。

## 三、不同方案适配场景与成本对比
为帮助开发者快速匹配适配方案，整理了6种方案的核心维度对比表格，覆盖开发成本、维护成本等关键指标：

| 方案类型         | 开发成本 | 维护成本 | 类型安全性 | 可读性 | 适配场景                     |
|------------------|----------|----------|------------|--------|------------------------------|
| 自定义实体类     | 中       | 低       | 高         | 优     | 长期业务场景、多人协作项目   |
| Map容器          | 低       | 高       | 低         | 差     | 临时快速调试、简单单一场景   |
| 返回数组         | 低       | 中       | 中         | 一般   | 固定类型数量的简单计算场景   |
| Java 8 Pair类    | 中       | 中       | 高         | 良     | 通用工具方法、临时返回场景   |
| 第三方Tuple库    | 中       | 中       | 高         | 良     | 多值返回高频的复杂业务场景   |
| 回调异步返回     | 高       | 中       | 高         | 良     | 异步IO、耗时计算的非阻塞场景 |

根据JetBrains《2023 Java Developer Survey》数据，**自定义实体类是68%受访开发者首选的多值返回方案**，因为其可读性与维护性优势突出，适配多数企业级Java开发场景。

## 四、大厂实战避坑指南
不难发现，不同Java返回两个值的方案各有避坑要点，开发者需结合场景提前规避风险。首先使用Map容器返回多值时，需统一键名命名规范，比如采用驼峰命名法标记返回值类型，避免出现"res1"这类无意义键名，减少后续维护成本。其次使用数组返回多值时，需在方法注释中清晰标注每个下标对应的返回值类型，避免调用方因下标混淆获取错误结果。另外自定义实体类需实现Serializable接口，便于微服务场景下跨进程序列化传输返回值。
## 五、行业标准与最佳实践
根据开源中国《中国开源软件生态报告2024》，国内Java微服务项目中，**自定义统一返回结果实体类已成为行业通用标准**，多数企业会封装包含业务状态码、业务消息、多返回结果字段的通用返回类，适配全局异常处理与接口文档自动生成需求。其实在日常开发中，开发者应优先选择自定义实体类方案，仅在临时场景使用Map或数组方案，保证代码长期可维护性。同时需避免过度依赖第三方Tuple库，减少项目依赖体积，降低版本兼容风险。

JetBrains《2023 Java Developer Survey》
开源中国《中国开源软件生态报告2024》

Java方法默认只能返回单一值，但可以通过创建一个包含多个字段的自定义类来封装多个返回值，或者使用内置的数据结构如数组、List、Map等来传递多个数据。例如，可以定义一个含有两个字段的类，将两个值存入对象中并返回。

通过自定义类或使用数据结构返回多个值

我想在Java方法中返回两个不同类型的值，该怎么做比较合适？

Java中如何实现方法返回多个值？

Java标准库提供了AbstractMap.SimpleEntry类，可以用来存储一对键值对，适合返回两项数据。另外，Apache Commons Lang库中提供了Pair类，也能实现类似功能，这样避免了自定义类的麻烦。

使用AbstractMap.SimpleEntry或第三方库中的Pair类

不想自行创建新类，有没有已有类可以用来返回两个值？

能否在Java中使用内置类包装多个返回值？

可以在方法参数中传入可变对象（例如数组或自定义对象），方法内部修改传入对象的属性。这样虽然方法返回单一值，但通过参数的引用传递，实现类似返回多个值的效果。

通过传入可变对象参数修改内容实现多返回值

除了返回值，有没有其他方法让函数有效传回两个值？

Java方法如何通过参数传递实现返回多个值？

PingCodeDocs

本文围绕Java原生无法直接返回多值的底层限制展开，详解自定义实体类、Map容器、数组、Java 8 Pair类、第三方Tuple库与回调异步返回6种实战方案，结合对比表格分析各方案开发与维护成本等核心指标，引用行业报告指出自定义实体类是多数开发者首选方案，同时给出大厂开发避坑要点与行业最佳实践建议，帮助开发者结合业务场景快速选型Java返回两个值的适配方案。

java如何设置返回两个值

用户关注问题