Java中不推荐仅用boolean或int返回值表示操作成败，应结合异常机制与Result<T>等专用类型：受检异常用于必须处理的业务错误，RuntimeException子类用于编程错误，避免吞异常；有返回值时用Result<T>或Vavr的Try/Either封装成功值与错误信息；纯副作用操作可谨慎使用语义明确的boolean方法（如trySaveConfig）；禁用魔数、null或状态字段隐式表达失败。
Java 中不推荐用返回值（如 boolean 或 int）单独承载“操作成功/失败”语义，而应结合异常机制与明确的返回类型设计——这是保障可读性、可维护性和调用方健壮性的关键。
优先抛出受检或非受检异常表示失败
当方法有明确的业务前提（如参数校验、资源不可用、权限不足），失败属于“意外但可预期”的情况，应抛出异常：
- 对必须处理的错误（如文件不存在、数据库连接失败），使用 受检异常（
Exception子类），强制调用方决策； - 对编程错误或系统级问题（如空指针、非法参数），使用 非受检异常（
RuntimeException子类），如IllegalArgumentException、IllegalStateException； - 避免吞掉异常或仅返回
false而不说明原因，这会让调用方无法诊断问题。
若需返回结果且附带状态，用专用封装类（推荐）
当操作天然有返回值（如查询用户、解析 JSON），又需同时表达是否成功，不要用 null 或魔数（如 -1）表示失败，而应定义清晰的结果容器：
- 例如自定义
Result<T>类，含boolean isSuccess()、T getValue()、String getError()； - 或使用成熟库如
Vavr的Try<T>、Either<E, T>，或Guava的Optional<T>（仅适用于“无结果即失败”，不适用于含错误信息的失败）； - 这样调用方能明确区分“成功拿到值”和“失败并获知原因”，避免空指针或逻辑歧义。
仅在极简场景下用 boolean 返回值，且方法名必须体现意图
对于无返回数据、纯副作用操作（如保存配置、发送通知），且失败原因无需暴露给调用方时，可用 boolean，但必须配合语义明确的方法命名：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- ✅ 好名字：
trySaveConfig()、isUserActive()、removeTempFile()（暗示可能失败）； - ❌ 避免：
saveConfig()（承诺成功）、doSomething()（含义模糊）； - 注意：
boolean无法携带失败细节，调用方只能重试或忽略，不适合关键路径。
绝不依赖返回值类型本身隐式表达状态
避免以下反模式：
- 用
int返回码（如0=成功, 1=参数错, 2=超时），迫使调用方硬编码理解数字含义； - 用
null表示失败（如findUser() == null），导致空指针风险且无法区分“未找到”和“出异常”； - 在返回对象中混用状态字段（如
user.isValid() == false表示加载失败），破坏单一职责。
核心原则是：让成功路径清晰自然，失败路径可感知、可追溯、可响应。状态传达不是技巧问题，而是接口契约的设计选择。
