Spring Boot控制器HttpServletResponse响应体设置失败及异步问题排查

问题分析与修复方案 #

咱们先拆解你遇到的两个核心问题，再一步步给出针对性的修复：

1. HttpMediaTypeNotAcceptableException 异常的根源

这个异常本质是响应体的处理方式不符合Spring的媒体类型校验逻辑，具体原因有两点：

• 错误使用字符流Writer处理二进制CSV内容：CSV文件是二进制流（你用了OctetStream接收），而Writer是专门处理字符的工具，直接将字节数组转字符串写入会导致编码混乱，Spring无法识别响应的实际媒体类型，从而抛出不兼容异常。
• 控制器返回CompletableFuture<HttpServletResponse>不符合Spring异步响应规范：手动操作HttpServletResponse容易出现上下文管理问题，Spring更推荐用标准化的响应类型或协程原生支持来处理异步场景。

2. Inappropriate blocking method call 警告的根源

这个警告是因为你破坏了Ktor Client的非阻塞特性：

• response.content.toByteArray()是阻塞式读取Ktor的ByteReadChannel，会卡住协程线程，违背了异步IO的设计初衷。
• 使用GlobalScope.async不规范：GlobalScope的生命周期不受Spring管控，容易引发内存泄漏，且完全没必要——Spring Boot 2.3+原生支持协程suspend函数，不需要手动封装CompletableFuture。

修复后的完整代码 #

第一步：优化服务层（解决阻塞读取问题）

首先封装一个自定义的响应对象（避免直接复用Ktor的HttpResponse，防止通道资源被提前消费），并改用异步方式读取内容：

// 自定义响应数据类，封装文件头、内容和状态码
data class FileDownloadResponse(
    val headers: Headers,
    val content: ByteArray,
    val status: HttpStatusCode
)

suspend fun getFile(myObjectRq: myObjectRq): FileDownloadResponse { 
    val response = ktorClient.post<HttpResponse> { 
        accept(ContentType.Application.OctetStream) 
        url(externalWebServerUrl) 
        body = myObjectRq 
        contentType(ContentType.Application.Json) 
    } 
    // 用Ktor提供的suspend方法异步读取内容，避免阻塞
    val contentBytes = response.content.readRemaining().readBytes()
    log.info(String(contentBytes)) 
    
    return FileDownloadResponse(
        headers = response.headers,
        content = contentBytes,
        status = response.status
    )
}

第二步：优化控制器（解决媒体类型异常+异步规范问题）

改用Spring原生支持的suspend函数，用二进制流输出内容，同时遵循Spring响应规范：

@PostMapping(path = ["/download"]) 
suspend fun getFile(@RequestBody myObjectRq: myObjectRq): ResponseEntity<ByteArray> { 
    val fileResponse = webService.getFile(myObjectRq)
    
    // 转换Ktor Headers为Spring HttpHeaders
    val responseHeaders = HttpHeaders()
    fileResponse.headers.forEach { (key, values) ->
        values.forEach { value ->
            responseHeaders.add(key, value)
        }
    }
    
    // 用ResponseEntity返回，Spring自动处理响应写入，避免手动操作HttpServletResponse
    return ResponseEntity.status(fileResponse.status.value)
        .headers(responseHeaders)
        .body(fileResponse.content)
}

额外最佳实践提示 #

• 完全避免手动操作HttpServletResponse：用ResponseEntity或StreamingResponseBody（大文件场景）更符合Spring的设计理念，减少上下文错误。
• 禁止使用GlobalScope：如果需要自定义协程Scope，可以注入Spring提供的CoroutineScope（@Autowired private val coroutineScope: CoroutineScope），由Spring统一管理生命周期。
• 大文件场景优化：如果CSV文件体积较大，建议用StreamingResponseBody配合Ktor的ByteReadChannel流式输出，避免一次性加载整个文件到内存。

内容的提问来源于stack exchange，提问作者J.Doe