Spring Boot REST接口中文乱码主因是字符编码未对齐，涉及客户端提交、服务端接收与响应三环节；需配置URI编码、Content-Type charset、RestTemplate默认字符集及文件名RFC 5987编码。

Spring Boot 中 REST 接口出现中文乱码，多数情况不是“接口写错了”，而是请求或响应环节的字符编码未对齐。核心问题集中在三处：客户端提交参数时编码不对、服务端接收时未指定解码方式、服务端返回时未声明响应编码。下面从实际开发中最常踩坑的几个点展开说明。

接口接收中文参数乱码

GET 请求的中文参数（如 URL 中的 query 参数）在 Tomcat 8.5+ 默认使用 UTF-8 解码，但若部署在旧版容器或被反向代理（如 Nginx）拦截后未配置编码，就可能按 ISO-8859-1 解析，导致乱码。POST 请求体中的中文（尤其是 form-data 或 raw JSON）则依赖 Content-Type 是否带 charset=UTF-8。

• 确保 Controller 方法参数用 @RequestParam 或 @RequestBody 正确标注，避免用 HttpServletRequest.getParameter() 手动取值
• 在 application.yml 中显式配置 URI 编码：
  server:   tomcat:     uri-encoding: UTF-8
• 如果是前端 AJAX 调用，确认请求头设置了 Content-Type: application/json; charset=UTF-8

接口返回中文乱码

浏览器或调用方看到中文变问号或方块，大概率是响应头缺失 Content-Type: application/json; charset=UTF-8，导致客户端按默认编码（如 ISO-8859-1）解析 UTF-8 字节流。

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

• 全局生效：在 application.yml 添加
  spring:   http:     encoding:       force: true        charset: UTF-8
• 对单个接口，可在 @RequestMapping 或 @GetMapping 上加 produces 属性：
  @GetMapping(value = "/api/data", produces = "application/json;charset=UTF-8")
• 若使用 ResponseEntity，手动设置 header：
  HttpHeaders headers = new HttpHeaders();
  headers.setContentType(MediaType.APPLICATION_JSON_UTF8);

RestTemplate 调用第三方接口时乱码

你用 RestTemplate 调用百度 AI、支付平台等外部接口，返回中文乱码，根本原因常是对方响应头没带 charset（如只写 Content-Type: application/json），而 RestTemplate 默认用 ISO-8859-1 解码响应体字节流，再转 String 就已损坏。

• 自定义 RestTemplate，添加 StringHttpMessageConverter 并设为 UTF-8：
  restTemplate.getMessageConverters().stream()
    .filter(converter -> converter instanceof StringHttpMessageConverter)
    .findFirst().ifPresent(c -> ((StringHttpMessageConverter) c).setDefaultCharset(StandardCharsets.UTF_8));
• 更稳妥的做法：不用 String.class 接收，改用 ResponseEntity，再手动按 UTF-8 构造字符串：
  String body = new String(response.getBody(), StandardCharsets.UTF_8);
• 若需复用 JSON 反序列化，可搭配 Jackson2ObjectMapperBuilder 设置 UTF-8 编码

文件下载时中文文件名乱码

通过 @ResponseBody 返回文件流并设置 Content-Disposition 时，中文文件名在 Chrome、Edge 下正常，但在 Firefox 或旧版 IE 中显示为乱码，是因为 filename 参数不支持直接传中文。

• 不要用：
  Content-Disposition: attachment; filename="报告2026年10月.pdf"
• 应改用标准的 filename* 参数（RFC 5987）：
  Content-Disposition: attachment; filename="report.pdf"; filename*=UTF-8''%E6%8A%A5%E5%91%8A2026%E5%B9%B410%E6%9C%88.pdf
• Java 中可用 URLEncoder.encode(fileName, "UTF-8") 生成百分号编码，并拼接成 filename* 字段