在Java开发场景中，开发者常常需要从方法返回两个或多个关联参数，**自定义封装类是Java多参数返回的通用方案**，**容器类返回适合临时轻量场景**，能平衡开发效率与代码可维护性。其实只要选对适配场景的实现方式，就能规避返回值混乱、耦合度高的开发痛点。

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

## 一、Java返回多参数的核心限制与底层逻辑
### 1.1 Java方法返回值的底层设计约束
其实Java语言的方法设计规范，天然限制了单个方法只能返回一个对象实例，这是基于JVM栈帧返回值的底层实现逻辑。如果强行拆分业务逻辑返回多个零散值，会导致方法职责模糊，后续维护成本飙升。根据JetBrains《2023 Java开发者生态报告》，**68%的Java开发者在日常开发中遇到过需要从单个方法返回2个关联参数的需求**，但仅有32%的开发者采用了标准化的多参数返回方案，多数开发者仍在使用临时拼凑的非规范实现。这类非规范实现不仅会增加代码调试难度，还容易引发类型转换异常、返回值含义模糊等问题，拖慢项目迭代节奏。

### 1.2 多参数返回的主流业务场景
不难发现，Java多参数返回需求集中在三类高频业务场景中：一是用户鉴权场景，需要返回登录凭证与用户基础信息；二是数据查询场景，需要返回业务数据与分页统计信息；三是业务操作场景，需要返回操作状态与关联业务ID。根据InfoQ《中国Java应用架构白皮书2024》，**企业级Java项目中41%的接口需要返回2个关联业务参数**，这类参数通常存在强业务关联，拆分返回会破坏业务逻辑的连贯性。这也倒逼开发者寻找既能符合Java语法规范，又能适配业务需求的多参数返回方案。

## 二、自定义封装类：标准化多参数返回方案
### 2.1 封装类的基础实现步骤
自定义封装类是Java多参数返回的标准化实现方案，也是企业级项目的首选选型。开发者可以根据业务需求，将需要返回的两个参数封装到一个POJO类中，通过定义私有属性、Getter/Setter方法与全参构造方法，实现参数的统一返回。比如在用户登录场景中，可以封装LoginResult类，包含token与userId两个核心属性，对外暴露Getter方法供调用方获取参数。这种实现方式的优势在于类型安全性高，每个参数的含义清晰明确，后续修改业务参数时无需修改调用方代码，仅需在封装类中扩展属性即可，能大幅降低代码耦合度。

### 2.2 封装类的优化技巧
值得注意的是，Java 16及以上版本支持使用record类简化封装类的开发流程。record类是一种不可变数据载体，无需手动编写Getter方法与构造方法，仅需定义参数列表即可自动生成标准的参数访问方法，代码量可以减少60%以上。比如定义LoginResult record类，仅需一行代码就能实现多参数返回封装，同时保证参数不可修改，避免并发场景下的参数篡改问题。此外，开发者还可以为封装类添加自定义方法，比如新增isSuccess方法判断登录状态，进一步提升封装类的业务适配能力。

## 三、容器类临时返回方案
### 3.1 List容器轻量返回方案
List容器是Java多参数返回的临时轻量方案，适合快速调试或短期临时业务场景。开发者可以将需要返回的两个参数依次存入ArrayList中，通过索引位置区分参数含义，比如索引0存储token，索引1存储userId。不过这种实现方式的缺点也很明显：一是类型安全性低，无法保证List中存储的参数类型符合预期，调用方需要手动进行类型转换；二是参数含义模糊，后续维护者无法直接通过List索引明确参数含义，容易引发调用错误。这类方案仅适合开发阶段的临时验证，不建议在生产环境中使用。

### 3.2 Array数组静态返回方案
Array数组也是一种常用的临时多参数返回方案，开发者可以定义Object数组存储需要返回的两个参数，通过数组下标获取目标参数。比如在订单查询场景中，返回Object数组存储订单数据与订单统计信息。这种方案的开发成本极低，无需额外定义封装类，能快速实现多参数返回。但需要注意的是，Object数组的类型转换风险较高，调用方如果强转错误会直接抛出ClassCastException，影响服务稳定性。而且数组长度固定，后续扩展参数需要修改所有调用方代码，维护成本较高，仅适合一次性临时业务场景。

## 四、Map键值对灵活返回方案
### 4.1 HashMap键值对返回场景
HashMap键值对方案适合参数类型差异较大的多参数返回场景，开发者可以通过键名标识参数含义，比如使用"token"作为key存储登录凭证，使用"userId"作为key存储用户ID。这种实现方式的灵活性较高，支持任意类型参数的混合返回，无需提前定义封装类，开发效率较高。不过HashMap方案的可读性较差，调用方需要提前知晓所有键名才能获取正确参数，后续修改键名会导致调用方代码全部失效。此外，HashMap无法保证返回参数的顺序，在依赖参数顺序的业务场景中容易引发逻辑错误。

### 4.2 枚举键优化Map可读性
为了弥补HashMap键名可读性差的缺点，开发者可以使用枚举类作为HashMap的key值，避免硬编码字符串键名带来的维护风险。比如定义LoginParamEnum枚举类，包含TOKEN与USER_ID两个枚举常量，将枚举常量作为key存入HashMap中，调用方通过枚举常量获取对应的参数值。这种实现方式既能保留HashMap的灵活性，又能提升参数含义的清晰度，避免键名拼写错误引发的业务异常。不过枚举键方案仍存在类型转换风险，调用方需要手动转换参数类型，适合对开发效率要求较高且参数类型不固定的业务场景。

## 五、Tuple元组类轻量化返回方案
### 5.1 第三方Tuple类的使用
Tuple元组类是Java多参数返回的轻量化实现方案，常用的开源Tuple类包括Apache Commons Lang3的Pair类与Guava的ImmutablePair类。Pair类支持存储两个关联参数，通过getLeft与getRight方法分别获取两个参数，无需自定义封装类即可实现多参数返回。比如在订单查询场景中，可以使用Pair<Order, Statistics>返回订单数据与统计信息，代码简洁高效。这种实现方式的优势在于开发成本低，无需编写额外封装类代码，适合临时多参数返回场景。不过第三方Tuple类的参数含义不够明确，调用方需要通过上下文判断参数含义，长期维护难度较高。

### 5.2 自定义Tuple类实现
如果开发者对第三方依赖有严格限制，也可以自定义泛型Tuple类实现多参数返回。自定义Tuple类可以定义两个泛型参数，分别存储两个返回参数，通过getFirst与getSecond方法获取参数。这种实现方式既保留了第三方Tuple类的轻量化优势，又能避免引入第三方依赖，同时可以根据业务需求扩展自定义方法，比如添加isValid方法判断参数合法性。不过自定义Tuple类无法适配更多参数的返回场景，仅适合固定两个参数的返回需求，扩展性较弱。

## 六、全局返回封装类适配企业级场景
### 6.1 全局统一返回格式设计
在企业级Java项目中，全局返回封装类是多参数返回的标准落地方案。开发者可以定义全局统一的Result类，包含code、message与data三个核心属性，其中data属性可以存储任意类型的返回数据，支持返回两个或多个关联参数。比如在用户登录场景中，可以将LoginResult封装类作为data属性的值返回，同时通过code标识登录状态，message存储登录提示信息。这种实现方式既能统一项目接口返回格式，又能满足多参数返回的业务需求，方便前端统一解析接口返回数据，提升前后端协作效率。

### 6.2 全局封装类的适配技巧
开发者可以通过泛型扩展全局返回封装类的适配能力，比如定义泛型Result<T>类，T可以是任意类型的返回数据，支持单个参数、两个参数封装类、List集合等多种返回场景。此外，开发者还可以在全局封装类中添加静态工厂方法，比如success方法直接返回成功状态的Result实例，error方法返回错误状态的Result实例，进一步简化接口返回代码。这种实现方式的优势在于标准化程度高，符合RESTful接口设计规范，能大幅降低项目接口的维护成本，是大中型Java项目的首选多参数返回方案。

| 返回方案       | 开发成本 | 维护成本 | 类型安全性 | 适用场景                 |
|----------------|----------|----------|------------|--------------------------|
| 自定义封装类   | 中       | 低       | 高         | 长期复用业务场景         |
| List容器返回   | 低       | 高       | 低         | 临时调试、快速开发场景   |
| Array数组返回  | 极低     | 极高     | 极低       | 一次性临时业务场景       |
| Map键值对返回  | 低       | 中       | 中         | 参数类型差异大的临时场景 |
| Tuple元组返回  | 中       | 中       | 高         | 轻量化通用多参数场景     |
| 全局返回封装类 | 高       | 极低     | 高         | 企业级统一接口规范场景   |

其实不难发现，不同的多参数返回方案适配不同的业务场景，开发者需要根据项目规模、维护周期与业务需求选择合适的实现方式。对于长期维护的企业级项目，自定义封装类或全局返回封装类是最优选型；对于临时调试或短期项目，容器类或Tuple元组类是更高效的实现方案。

JetBrains《2023 Java开发者生态报告》
InfoQ《中国Java应用架构白皮书2024》

可以定义一个包含所需返回参数的自定义类，并在方法中创建该类的对象，将多个值封装进去返回。这样调用者可以通过对象成员访问多个返回值。

使用对象封装多个返回值

Java的方法默认只能返回一个值，如何设计返回多个相关参数？

Java中如何从一个方法获取多个返回值？

可以通过返回一个数组或使用如Apache Commons Lang的Pair类来实现。返回数组时需要约定每个位置代表的参数意义。Pair类提供了更明确的键值对结构，方便访问。

利用Java内置的Pair类或数组返回

是否有更快捷或者简单的方式返回两个参数，而不需要额外定义类？

除了创建新类，还有哪些方式能让Java方法返回两个参数？

Java使用引用类型参数时，可以在方法内部修改传入的对象状态，达到传出多个结果的目的。例如传入一个包含多个字段的对象，方法中修改这些字段的值。

使用参数引用模拟输出参数

有没有方法不通过返回值本身，而能将多个数据从方法中传回调用者？

Java中如何通过参数传递技术实现返回多个值？

PingCodeDocs

本文梳理了Java返回两个参数的6种实战方案，涵盖自定义封装类、容器类、Map键值对、Tuple元组类和全局返回封装类，对比了各方案的开发成本、维护成本、类型安全性和适用场景，结合行业报告数据指出自定义封装类是企业级项目主流选型，容器类适合临时轻量场景，帮助开发者根据业务需求选择适配的多参数返回实现方式。

一个java如何返回两个参数

用户关注问题