Spring WebFlux服务跨调用出现5000ms无信号报错如何定位根因

该报错是Reactor框架抛出的TimeoutException，由你代码中配置的.timeout(Duration.ofSeconds(userPrefsAPITimeout))操作符触发，代表WebClient向服务B发起的请求，在配置的5秒内没有返回成功响应、也没有抛出错误/取消等终止信号，因此触发超时逻辑。你看到的报错日志就是代码中onErrorResume分支打印的异常信息，说明降级逻辑已经正常触发。

• 排查服务B接口性能：查看服务B对应接口的访问日志、监控指标，确认接口实际处理耗时是否超过5秒，是否存在线程池阻塞、FullGC停顿、数据库慢查询等导致响应延迟的问题。
• 排查网络链路问题：确认两个服务之间的网络连通性、延迟是否正常，是否存在网关限流、防火墙拦截、网络丢包等情况，导致请求无法正常到达服务B或响应无法返回服务A。
• 排查WebClient配置问题：检查WebClient的连接池配置，是否存在并发请求过多导致连接池耗尽、请求排队等待时间超过5秒的情况；同时确认WebClient全局超时配置是否和代码中单独配置的5秒冲突。

• 直接给timeout操作符配置默认返回值，避免不必要的异常抛出开销，示例如下：

// 超时后直接返回默认值，无需走异常捕获分支
.timeout(Duration.ofSeconds(userPrefsAPITimeout), Mono.just(new UserSubscription(userId,null, new ArrayList<>())))

• 增加全链路耗时埋点：在请求发起前、收到响应时分别打印时间戳，明确耗时是出在连接等待、服务B处理还是响应解析阶段，缩小排查范围。
• 补充服务B的错误状态捕获：可以在retrieve()后添加onStatus处理，提前捕获服务B返回的4xx、5xx错误，避免这类错误被超时异常掩盖。

内容的提问来源于stack exchange，提问作者Dinesh N