当方法参数超过4～5个，尤其含多个同类型时，应重构为参数对象；需命名带业务上下文、优先不可变、校验前移、用Builder模式、对可变类型做保护性拷贝。

方法签名参数一多，就容易看花眼、传错顺序、改起来战战兢兢——这不是风格问题，是设计信号。当一个方法参数超过 4～5 个，尤其含多个同类型（比如三个 String、两个 long），基本就该动手重构了。

识别该出手的“危险信号”

别等出 Bug 才反应过来。以下情况出现任意一条，就是参数列表已失控的明确提示：

• 调用时得反复对照方法定义才能确认第四个参数是 tenantId 还是 locale
• 同一组参数（如 startTime、endTime、timezone）在多个地方重复传入
• 参数之间有隐含约束（比如 minPrice <= maxPrice），但签名完全不体现
• 新增一个可选参数，就得加一个重载方法，接着再加一个……循环开始

用参数对象（Parameter Object）替代裸参数

不是简单把参数塞进一个 Map<String, Object>，而是封装成有业务含义、带约束逻辑的类。例如搜索场景，别叫 SearchParam，而应命名为 ProductSearchRequest：

• 字段命名带上下文：用 categoryIds 而非 ids，用 isPreviewMode 而非 flag
• 优先不可变：字段声明为 final，通过构造器或 Builder 初始化
• 校验前移：在构造器或 Builder 的 build() 中做非空、范围、逻辑一致性检查（如 startTime.before(endTime)）
• 避免 setter：如需修改，提供 withStartTime(Instant) 这类链式方法，保持对象语义不变

配合构建器模式提升调用体验

字段较多时，直接用构造器易出错且难读。Builder 模式让调用像说话一样自然：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

立即学习“Java免费学习笔记（深入）”；

ProductSearchRequest request = ProductSearchRequest.builder()
    .categoryIds(List.of("laptop", "monitor"))
    .priceRange(PriceRange.between(2000, 15000))
    .isPreviewMode(true)
    .locale("zh-CN")
    .build();

IDE 自动补全友好，顺序无关，缺失必填字段编译期报错，比裸参数安全得多。

别忘了校验和保护性拷贝

参数对象内部若持有可变类型（如 Date、ArrayList），必须做防御处理：

• 构造时对入参做保护性拷贝（new ArrayList(inputList)）
• getter 方法返回不可变视图（Collections.unmodifiableList(...)）或新副本
• 对外暴露的永远是“快照”，防止外部修改影响内部逻辑

不复杂，但容易忽略——参数列表不是越全越好，而是越清晰、越安全、越贴近业务才越好。