Spring Boot中Java设置Response Entity的Content-Length头遇截断问题求助

你遇到的响应截断问题，核心有两个原因：

1. 手动序列化的responseString和Spring最终序列化responseMap生成的JSON内容不一致——Spring使用容器内统一配置的ObjectMapper实例，和你new的实例可能存在配置差异（比如日期格式、空值处理、序列化规则等），导致实际输出的JSON长度和你计算的不一致。
2. String.length()返回的是字符数量，而HTTP协议中Content-Length要求的是响应体的字节数。如果响应包含非ASCII字符（比如中文、特殊符号），字符数和字节数会存在差异，直接用字符数作为长度会导致计算错误。

方案一：返回序列化后的字符串，确保长度匹配 #

直接返回手动序列化好的字符串，保证计算的字节长度和实际响应内容完全一致：

import java.nio.charset.StandardCharsets;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class EmployeeController {

    // 建议注入Spring容器中的ObjectMapper，而非手动new
    private final ObjectMapper objectMapper;

    public EmployeeController(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @GetMapping(value = "/employees", produces = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity<String> getEmployeeDetails(@RequestParam(value = "organization_id", required = false) Integer orgId) throws Exception {
        Map<String, List<Object>> responseMap = // 替换为你的数据获取逻辑
        String responseString = objectMapper.writeValueAsString(responseMap);
        // 按响应编码（默认UTF-8）计算字节数
        byte[] responseBytes = responseString.getBytes(StandardCharsets.UTF_8);
        
        HttpHeaders httpHeaders = new HttpHeaders();
        httpHeaders.add(HttpHeaders.CONTENT_LENGTH, String.valueOf(responseBytes.length));
        
        return ResponseEntity.ok().headers(httpHeaders).body(responseString);
    }
}

方案二：返回字节数组，直接基于字节计算长度 #

如果不想返回字符串，可以直接序列化字节数组，避免字符/字节转换的误差：

import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class EmployeeController {

    private final ObjectMapper objectMapper;

    public EmployeeController(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @GetMapping(value = "/employees", produces = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity<byte[]> getEmployeeDetails(@RequestParam(value = "organization_id", required = false) Integer orgId) throws Exception {
        Map<String, List<Object>> responseMap = // 替换为你的数据获取逻辑
        byte[] responseBytes = objectMapper.writeValueAsBytes(responseMap);
        
        HttpHeaders httpHeaders = new HttpHeaders();
        httpHeaders.add(HttpHeaders.CONTENT_LENGTH, String.valueOf(responseBytes.length));
        
        return ResponseEntity.ok().headers(httpHeaders).body(responseBytes);
    }
}

• 不要手动new ObjectMapper：注入Spring容器中的实例，保证序列化配置和全局一致，避免内容差异。
• 必须用字节数计算长度：严格遵循HTTP协议要求，Content-Length的值是响应体的字节数，而非字符数。
• GZIP压缩场景需谨慎：如果应用启用了GZIP压缩，手动设置的Content-Length会失效（压缩后的字节数和原始内容不同），这种情况下建议让容器自动处理长度，不要手动设置。

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