微服务文件下载响应头重复值问题排查及解决咨询

问题根源 #

直接返回上游服务的Response对象时，当前服务的JAX-RS容器会自动为响应追加标准头（比如Content-Type），而上游的Response已经携带了这些头，两者叠加就造成了重复。你打印的是上游服务返回的原始头，还没经过当前容器的二次处理，所以看起来正常。

可行解决方案 #

方案1：手动重新构建响应 #

不要直接返回上游Response，而是提取它的实体和头信息，重新构建新的Response，只保留需要的头：

@POST
@Path(PRINT_PREVIEW)
fun printPreview(@Valid request: NewAdhocContractRequest): Response {
    log.info("printPreview: request=$request")
    val upstreamResp = contractService.printPreview(request)
    
    return Response.ok(upstreamResp.entity)
        .header("Content-Disposition", upstreamResp.headers.getFirst("Content-Disposition"))
        .type(upstreamResp.headers.getFirst("Content-Type"))
        .build()
}

方案2：用Response.fromResponse()复用并去重 #

Response.fromResponse()可以基于上游Response创建Builder，你可以在这里明确覆盖头，避免重复：

@POST
@Path(PRINT_PREVIEW)
fun printPreview(@Valid request: NewAdhocContractRequest): Response {
    log.info("printPreview: request=$request")
    val upstreamResp = contractService.printPreview(request)
    
    return Response.fromResponse(upstreamResp)
        .type(upstreamResp.mediaType) // 强制覆盖Content-Type，避免重复
        .header("Content-Disposition", upstreamResp.headers.getFirst("Content-Disposition"))
        .build()
}

方案3：检查客户端自动加头配置 #

如果你的客户端（调用上游服务的部分）是JAX-RS实现（比如Jersey、RestEasy），看看是否开启了自动添加Content-Type这类头的功能，禁用后也能避免重复。

注意点 #

• transfer-encoding: chunked一般由容器自动处理，别手动设置，否则也可能导致重复。
• 你打印的头是上游服务的原始响应头，还没经过当前服务容器的处理，所以看不到重复现象。

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