为何将CompletableFuture先存入变量再配置回调会无法正常工作？

• CompletableFuture的所有链式操作方法（包括exceptionally、thenApply、thenCompose、whenComplete等）不会修改原实例的状态或配置，而是返回一个全新的CompletableFuture实例，你配置的回调逻辑只会作用于这个新返回的实例，原有实例不会感知到回调的存在，也不会修改自身的异常状态。
• 该问题本质是不可变对象的通用特性：所有修改配置的方法都不会修改原对象，只会返回配置更新后的新对象，你必须接收返回值才能让配置生效。

两个测试用例的差异说明 #

正常执行的simple方法 #

你在链式调用后直接将exceptionally返回的新实例赋值给了future变量，最后调用join()时是等待这个已经配置了异常处理的新实例返回，异常会被回调捕获并返回HANDLED，所以执行符合预期。

抛异常的withVar方法 #

你调用future.exceptionally()时没有接收它返回的新实例，相当于配置的异常回调被直接丢弃了。最后你调用join()的对象仍然是最初supplyAsync返回的原始异常实例，这个实例没有配置任何异常处理逻辑，所以会直接抛出未捕获的CompletionException。

修正后的withVar写法 #

@Test
void withVarFixed() {
    CompletableFuture<String> future = CompletableFuture.supplyAsync(this::throwException);
    // 接收exceptionally返回的新实例，异常回调才会生效
    CompletableFuture<String> handledFuture = future.exceptionally(throwable -> HANDLED);
    assertEquals(HANDLED, handledFuture.join());
}

你遇到的RestTemplateBuilder链式调用失效问题本质完全相同：Spring的RestTemplateBuilder是不可变类，所有配置方法（rootUri、additionalMessageConverters、errorHandler等）都会返回新的Builder实例，不会修改原有实例的配置。如果调用配置方法后不接收返回值，你的配置就相当于没有生效。

错误写法示例 #

RestTemplateBuilder builder = new RestTemplateBuilder();
builder.rootUri("https://example.com"); // 没有接收返回值，配置不生效
RestTemplate restTemplate = builder.build(); // 构建出来的实例没有rootUri配置

正确写法示例 #

RestTemplateBuilder builder = new RestTemplateBuilder();
builder = builder.rootUri("https://example.com"); // 接收返回的新实例
RestTemplate restTemplate = builder.build(); // 配置正常生效

内容的提问来源于stack exchange，提问作者Денис Старакожев