Spring WebFlux：非阻塞设置Content-Disposition头返回数据库文件

你遇到的问题是响应式编程里的典型场景——不能像传统同步代码那样阻塞获取Mono内的对象来设置响应头。不过解决思路很明确：我们可以利用flatMap操作符，在Attachment对象异步就绪后，再基于它的信息构建完整的响应，包括动态设置Content-Disposition头。

你的原代码用map只提取了文件字节数组，丢失了文件名信息，所以没法设置这个关键响应头。我们调整下逻辑，把整个响应的构建放在flatMap里：

public Mono<ServerResponse> getAttachment(ServerRequest request) {
    return documentManagerService.getAttachment(request.pathVariable("id"))
            .flatMap(attachment -> {
                // 从Attachment中获取文件数据和文件名
                byte[] fileData = attachment.getFileAttachment().getData();
                String fileName = attachment.getFileName();
                
                // 构建包含正确响应头的ServerResponse
                return ServerResponse.ok()
                        .contentType(MediaType.APPLICATION_OCTET_STREAM)
                        .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + fileName + "\"")
                        .bodyValue(fileData);
            });
}

这里的核心是flatMap：它会等待Mono<Attachment>异步完成，然后用拿到的Attachment对象创建新的Mono<ServerResponse>，全程非阻塞，完全符合WebFlux的响应式模型。

如果你的文件名可能包含特殊字符（比如空格、中文或非ASCII字符），推荐用Spring提供的ContentDisposition工具类构建响应头，它能自动处理编码问题，避免浏览器解析错误：

import org.springframework.http.ContentDisposition;
import java.nio.charset.StandardCharsets;

// ...

public Mono<ServerResponse> getAttachment(ServerRequest request) {
    return documentManagerService.getAttachment(request.pathVariable("id"))
            .flatMap(attachment -> {
                byte[] fileData = attachment.getFileAttachment().getData();
                String fileName = attachment.getFileName();
                
                // 构建规范的Content-Disposition头，自动处理特殊字符编码
                ContentDisposition disposition = ContentDisposition.attachment()
                        .filename(fileName, StandardCharsets.UTF_8)
                        .build();
                
                return ServerResponse.ok()
                        .contentType(MediaType.APPLICATION_OCTET_STREAM)
                        .header(HttpHeaders.CONTENT_DISPOSITION, disposition.toString())
                        .bodyValue(fileData);
            });
}

这样修改后，浏览器就能正确识别文件名和扩展名，同时全程没有任何阻塞调用，完美适配WebFlux的响应式环境。

内容的提问来源于stack exchange，提问作者Drunken Daddy