使用CompletableFuture时Thymeleaf视图找不到问题排查

核心原因 #

拆分异步任务后，thenApply的执行线程与supplyAsync的线程上下文不一致，导致Thymeleaf无法正确加载模板：

• supplyAsync默认使用JDK的ForkJoinPool.commonPool()，thenApply的执行线程可能切换到不同的线程，而异步线程没有继承主线程的类加载器（ClassLoader）或Spring线程上下文。
• Thymeleaf的模板资源解析器（比如SpringResourceTemplateResolver）依赖当前线程的上下文来定位模板文件，异步线程中缺失这些上下文信息时，就会找不到模板路径。

解决方案 #

1. 使用Spring的异步执行器替代默认线程池 #

Spring提供的TaskExecutor会自动传递线程上下文（包括ClassLoader、Spring上下文），确保异步任务能访问到正确的资源：

// 注入Spring的TaskExecutor
@Autowired
private TaskExecutor taskExecutor;

// 使用自定义执行器执行异步任务
return CompletableFuture
        .supplyAsync(() -> this.acknowledgementTemplatingService.prepareHtmlViewForDocument(offer), taskExecutor)
        .thenApply(htmlContent -> documentService.generatePdfDocumentFromHtml(htmlContent, ASSETS));

2. 保持任务逻辑在同一个异步块中 #

这是你已经验证可行的方式，避免线程切换带来的上下文丢失：

return CompletableFuture
        .supplyAsync(() -> {
            String htmlContent = this.serviceDescriptionTemplatingService.prepareHtmlViewForDocument(offerDto);
            return documentService.generatePdfDocumentFromHtml(htmlContent, ASSETS);
        });

3. 手动传递类加载器到异步线程 #

如果必须拆分任务，可以在异步任务中手动设置线程的ClassLoader为主线程的ClassLoader：

ClassLoader mainClassLoader = Thread.currentThread().getContextClassLoader();
return CompletableFuture
        .supplyAsync(() -> {
            Thread.currentThread().setContextClassLoader(mainClassLoader);
            return this.acknowledgementTemplatingService.prepareHtmlViewForDocument(offer);
        })
        .thenApply(htmlContent -> {
            Thread.currentThread().setContextClassLoader(mainClassLoader);
            return documentService.generatePdfDocumentFromHtml(htmlContent, ASSETS);
        });

内容的提问来源于stack exchange，提问作者Thomas Lang