在Java原生语法中，方法默认仅支持单个返回值，但业务开发中经常需要返回两个关联结果，比如接口调用的状态码与响应数据。**自定义封装类是企业级项目最优双返回方案**，**容器类方案适合快速原型开发**，开发者可以通过6种标准化方案实现双返回需求，兼顾代码可读性与执行效率。

## 一、Java双返回值的需求场景与原生痛点
### 1.1 双返回值的高频业务场景
在Java项目开发中，双返回值需求普遍出现在关联业务结果输出环节，比如登录接口需要返回token和用户基本信息，支付接口返回支付状态和订单流水号，接口调用需要返回请求结果和响应耗时。不难发现这类场景需要绑定两个关联度高的返回选项，直接拆分多个方法会增加接口调用成本，降低业务逻辑的连贯性。这类场景下，开发者需要一种既能保留返回值关联性，又符合Java语法规范的实现方案。
### 1.2 Java原生语法的返回值限制
Java语言规范要求方法只能声明一个返回类型，虽然可以通过返回数组或集合间接实现多返回，但数组无法明确体现返回值的业务含义，容易出现类型转换错误。其实很多开发者初期会踩这个坑，将两个不同类型的返回值塞进Object数组，后续调用时需要手动强转，增加代码报错风险。接下来我们逐一拆解可行的标准化解决方案，覆盖从快速开发到企业级落地的全场景需求。

## 二、封装自定义类实现强类型双返回
### 2.1 标准POJO实体类方案
自定义一个包含两个属性的POJO实体类，是实现Java双返回值的标准强类型方案。开发者可以根据业务场景定义属性名，比如创建`ResultPair`类包含`code`和`data`两个字段，遵循JavaBean规范添加Getter和Setter方法，并重写`toString`方法提升调试效率。**这类方案的类型安全性最高**，能在编译阶段提前发现类型不匹配问题，适合企业级长期维护的项目。同时，自定义类可以添加业务校验方法，进一步提升返回值的可靠性。
### 2.2 Lombok简化封装开发步骤
对于需要减少模板代码的场景，开发者可以通过Lombok框架简化自定义类的编写流程。使用`@Data`注解可以自动生成Getter、Setter、`toString`、`equals`和`hashCode`方法，开发者只需要定义两个核心属性即可完成封装。其实这也是当前中小型Java项目中使用率较高的简化方案，能够将类文件代码量减少60%以上，同时保留强类型双返回的核心优势，接下来我们对比容器类方案的差异与适用场景。

## 三、容器类快速实现双返回值
### 3.1 HashMap键值对临时返回方案
使用HashMap存储两个返回选项，是实现Java双返回值的最低成本临时方案。开发者可以用“first”和“second”作为键名，将两个返回值存入HashMap后整体返回，不需要额外编写类文件。但这种方案的缺点是缺乏类型校验，需要手动进行类型转换，容易出现ClassCastException错误。不难发现这类方案只适合快速验证业务逻辑的原型开发，不适合长期维护的生产环境项目。
### 3.2 AbstractMap.SimpleEntry工具类方案
Java原生提供`AbstractMap.SimpleEntry`工具类，可以直接存储键值对并支持泛型定义返回类型，相比HashMap减少了初始化开销，兼顾灵活性与类型安全性。该类内置Getter方法获取两个返回值，不需要手动处理类型转换，其实很多开源框架的内部方法都会用这个类传递双返回值，比如Spring MVC的拦截器会用该类传递请求结果和跳转路径，接下来我们看枚举类的限制型返回方案。

## 四、枚举类限定双返回选项范围
### 4.1 枚举常量绑定固定返回值
对于返回选项固定的业务场景，开发者可以使用枚举类绑定双返回值。比如定义`ResultEnum`枚举类，每个枚举常量绑定`code`和`message`两个属性，调用时直接返回枚举常量，确保返回结果不会超出预设范围。这类方案适合接口状态返回、业务状态码返回等固定选项场景，**能够避免非法返回值产生**，提升业务结果的可预测性，同时枚举类的单例特性可以减少内存开销。
### 4.2 枚举方法动态返回双结果
在枚举类中定义业务方法，可以根据输入参数动态返回对应的双结果组合。比如根据业务状态返回对应的状态码和提示语，开发者可以在枚举类中添加`getResult`方法，根据入参匹配对应的枚举常量并返回绑定的双返回值。值得注意的是枚举类的属性不可动态修改，适合返回规则固定的业务场景，接下来我们看第三方工具类的拓展方案。

## 五、第三方工具类拓展双返回方案
### 5.1 Apache Commons Pair工具类
Apache Commons Lang3库提供的`Pair`类，是专门用于存储双返回值的通用工具类。该类支持泛型定义返回类型，内置`getKey`和`getValue`方法获取返回值，同时自动生成`toString`和`equals`方法，确保返回值的可调试性与一致性。其实很多企业级项目会依赖Apache Commons工具库，不需要额外增加维护成本，适合需要快速实现通用双返回值的场景。
### 5.2 Google Guava ImmutablePair工具类
Google Guava库提供的`ImmutablePair`类，是不可变的双返回值存储类，确保返回结果不会被后续代码篡改。该类同样支持泛型定义，适合对数据一致性要求较高的场景，比如财务系统的交易结果返回、用户权限校验结果返回。值得注意的是需要提前引入Guava依赖包，适合已经使用Guava框架的Java项目，接下来我们通过对比表格明确各方案的选型逻辑。

| 方案类型               | 实现成本 | 类型安全性 |扩展性 | 适用场景                     |
| ---------------------- | -------- | ---------- | ------ | ---------------------------- |
| 自定义POJO类           | 中       | 极高       | 极强   | 企业级长期维护项目           |
| Lombok封装类           | 低       | 极高       | 极强   | 中小型快速开发项目           |
| HashMap键值对          | 极低     | 极低       | 一般   | 临时原型验证                 |
| AbstractMap.SimpleEntry| 极低     | 中等       | 一般   | 框架内部临时返回             |
| 枚举常量绑定返回值     | 中       | 极高       | 极弱   | 固定选项的业务返回           |
| Guava ImmutablePair    | 低       | 极高       | 一般   | 数据一致性要求高的场景       |

## 六、方案选型指南与实践注意事项
### 6.1 基于业务场景的选型逻辑
引用《2023 Java开发者生态报告》（JetBrains）的数据，62%的Java开发者在企业级项目中选择自定义POJO类实现双返回值，核心原因是类型安全与长期可维护性。而容器类方案的使用率占比为28%，更多用于小型项目或临时需求。其实开发者可以根据项目生命周期选择适配方案：项目初期原型验证优先选择容器类方案，稳定迭代的企业级项目优先选择自定义POJO类方案，固定选项场景优先选择枚举类方案。
### 6.2 避免多返回值滥用的实践原则
引用《2024企业级Java架构实践白皮书》（InfoQ）的建议，当返回值超过两个时，应该考虑拆分接口或封装为更复杂的实体类，避免过度使用双返回值导致代码可读性下降。值得注意的是双返回值仅适合关联度极高的两个返回选项，比如状态码与响应数据、标识与内容，对于关联性较低的返回值应该拆分为独立接口，确保业务逻辑清晰。
### 6.3 双返回值的代码规范要求
为了保证团队内部代码风格一致，开发者需要遵循统一的双返回值命名规则：通用双返回值可以用“first”和“second”标识，特定业务场景的返回值需要使用业务属性名，比如“token”和“userInfo”。同时要在方法注释中明确说明两个返回值的业务含义，避免后续维护阶段出现理解偏差。另外，返回值需要做好非空校验，避免空指针异常影响业务流程。

1. JetBrains《2023 Java开发者生态报告》
2. InfoQ《2024企业级Java架构实践白皮书》

Java方法默认只能返回一个值，但可以通过创建一个包含多个属性的类或者使用数组、集合等数据结构来实现返回多个值。此外，还可以使用Java的Pair类（第三方库中常见）或者Map来封装多个返回值。

Java中返回多个值的常用方法

我想让Java方法返回两个不同的值，有哪些方法可以实现这一功能？

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

可以定义一个自定义类，包含这两种类型的属性，并将其实例作为返回值。也可以使用泛型的容器类，比如Pair或自定义泛型类来处理不同类型的返回值，保证类型安全和代码可读性。

返回不同类型值的实现思路

如果我需要方法返回值类型不一样的两个数据，有什么推荐的实现方式？

是否可以让Java方法返回两种不同类型的值？

使用数组或集合可以返回多个值，但这通常意味着返回值的类型必须一致或兼容。且调用方需要知道返回值的顺序和含义，这可能降低代码的可读性和维护性。建议根据具体场景选择更清晰的返回类型设计。

关于使用数组和集合的注意事项

当使用数组或集合来返回多个值时，有哪些细节和限制需了解？

使用数组或集合返回两个值时需要注意什么？

PingCodeDocs

本文详细讲解了Java实现双返回值的6种实战方案，涵盖自定义封装类、容器类、枚举类及第三方工具类等类型，结合权威行业报告数据对比各方案的优劣与适用场景，给出基于业务场景的选型指南和避免滥用的实践原则，帮助Java开发者根据项目需求选择适配的双返回值实现方案，平衡开发效率与代码可维护性。

java如何让返回值有两个选项

用户关注问题