onErrorReturn是Reactor和RxJava中用于异常降级的核心操作符，作用是在上游发生错误时返回预设默认值而非传播异常，适用于可容忍失败且有合理兜底值的场景，如缓存查询失败返回空对象或远程调用超时返回本地默认配置。
onErrorReturn 是 Reactor 和 RxJava 中用于异常降级的核心操作符，它的作用是在上游发生错误时，不传播异常，而是返回一个预设的默认值，让流继续正常执行。
onErrorReturn 的基本用法
它适用于那些可以容忍失败、且有合理兜底值的场景，比如查询缓存失败时返回空对象、远程调用超时返回本地默认配置等。
- Reactor（Mono/Flux）中：调用
onErrorReturn(T fallback)或onErrorReturn(Class extends Throwable> type, T fallback)指定异常类型和对应默认值 - RxJava（Single/Observable）中：类似地使用
onErrorReturnItem(T item)或onErrorReturn(Throwables::isInstanceOf, () -> defaultValue) - 注意：它只捕获直接上游抛出的异常，不会处理
flatMap内部未被捕获的错误，除非该内部流也做了 onError 处理
按异常类型做差异化降级
生产环境中不同异常往往需要不同应对策略。例如网络超时可返回缓存，而参数校验失败则应返回空或特定错误对象。
- Reactor 示例：
flux.onErrorReturn(TimeoutException.class, defaultItem) - RxJava 示例：
single.onErrorReturnItem(() -> { if (e instanceof IOException) return cachedValue; else throw e; })（需配合onErrorResumeNext或自定义逻辑） - 更推荐用
onErrorResume+ 条件判断实现精细控制，onErrorReturn更适合简单、统一的兜底场景
与 onErrorResume 的关键区别
onErrorReturn 只能返回一个静态值，无法执行异步逻辑或依赖上下文；而 onErrorResume 可以返回新流，支持重试、查缓存、调降级服务等复杂恢复动作。
立即学习“Java免费学习笔记（深入）”；
- 适合用
onErrorReturn的情况：返回常量、空对象、枚举默认值（如Status.UNKNOWN） - 不适合的情况：需要查 Redis、调用本地 fallback 接口、记录告警后再返回——这些都得用
onErrorResume - 误用
onErrorReturn做耗时操作（如同步 DB 查询）会阻塞线程，破坏响应式非阻塞特性
常见陷阱与注意事项
看似简单，但容易因理解偏差导致降级失效或掩盖问题。
- 它不会终止流，也不会记录日志——异常被静默吞掉，建议搭配
doOnError主动记录 - 对
Flux使用时，若上游在发完部分元素后报错，onErrorReturn只影响错误信号，不补全缺失数据（它不生成新元素） - 不要在 lambda 中抛出新异常，否则会再次触发错误处理链，可能造成无限循环或状态混乱
