微服务架构中需统一UTF-8编码以避免中文乱码，覆盖传输链路、运行环境、配置加载三维度：一、Spring Boot服务端通过application.yml、Feign配置、JVM参数强制UTF-8；二、网关用GlobalFilter预解码，配置中心确保UTF-8保存与加载；三、Kafka/RabbitMQ/Redis/HTTP客户端显式指定UTF-8；四、Logback、Filebeat、Sleuth等日志监控组件均需配置UTF-8。

微服务架构中，各节点（如 Spring Boot 服务、网关、配置中心、日志收集器等）若字符编码不一致，极易在 HTTP 请求/响应、Feign 调用、消息队列（如 Kafka/RabbitMQ）、日志输出、配置加载等环节出现中文乱码。统一编码不是“设一次”，而是要覆盖传输链路 + 运行环境 + 配置加载三个维度，核心目标是让所有节点默认使用 UTF-8，且不依赖系统 locale。

一、Spring Boot 服务端强制统一编码

这是最常出问题的一环。不能只靠 -Dfile.encoding=UTF-8，需多层加固：

• Web 层请求/响应编码：在 application.yml 中显式开启并指定字符集：
  server:
  servlet:
    encoding:
      force: true
      force-request: true
      force-response: true
      charset: UTF-8
• Feign 客户端编码控制：Feign 默认不带 Content-Type: charset=UTF-8，需自定义 Encoder 或通过拦截器注入：
  @Bean
public Encoder feignFormEncoder() {
  return new SpringFormEncoder(); // 使用支持 UTF-8 的 encoder
}
  同时确保所有 @RequestBody 对象序列化为 JSON 时使用 UTF-8（Jackson 默认已满足，无需额外配置）。
• JVM 启动参数固化：在 Dockerfile 或启动脚本中强制写入：
  java -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -jar service.jar
  注意：sun.jnu.encoding 影响文件路径解析（尤其 Windows 容器），建议一并设置。

二、网关与配置中心同步 UTF-8 策略

网关（如 Spring Cloud Gateway）是流量入口，必须提前拦截并标准化编码：

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

• Gateway 全局过滤器强制解码：添加 GlobalFilter，对 ServerWebExchange 的请求体做 UTF-8 解码预处理（适用于表单或 JSON POST）；
• 配置中心（Nacos/Apollo）内容编码：确保配置项以 UTF-8 格式保存（Nacos 控制台编辑时右下角确认编码为 UTF-8）；
  若使用 bootstrap.yml 加载远程配置，需在 spring.cloud.nacos.config.encode 中显式设为 UTF-8（Nacos 2.2+ 支持）；
• 配置文件本身无 BOM：所有 application-*.yml、bootstrap.yml 必须保存为 UTF-8 无 BOM —— IDE 右下角状态栏点击编码 → “Convert to UTF-8” 并取消 BOM。

三、跨节点通信环节显式指定编码

微服务间调用不经过 Web 容器时（如直接 Socket、gRPC、Kafka），默认编码不可靠，必须显式声明：

立即学习“Java免费学习笔记（深入）”；

• Kafka 生产/消费端：字符串序列化器必须用 StringSerializer / StringDeserializer（它们内部固定用 UTF-8），禁用 ByteArraySerializer + 手动 new String(bytes)；
• RabbitMQ 消息头：发送时设置 MessageProperties.setContentEncoding("UTF-8")；消费者读取时也应校验该 header，而非依赖默认解码；
• Redis 存储字符串：Spring Data Redis 的 StringRedisTemplate 默认使用 UTF-8，但若用原生 Jedis，所有 set(key, value) 前需确保 value.getBytes(StandardCharsets.UTF_8)；
• HTTP 客户端（RestTemplate / WebClient）：构造时指定 UTF-8 编码器：
  WebClient.builder().codecs(configurer -> configurer.defaultCodecs().maxInMemorySize(2 * 1024 * 1024)).build();
  并确保请求头含 Content-Type: application/json;charset=UTF-8。

四、日志与监控链路统一输出编码

ELK 或 Prometheus + Grafana 中中文显示异常，往往因日志采集环节编码丢失：

• Logback 配置强制 UTF-8：在 logback-spring.xml 中，所有 <encoder></encoder> 下加：
  <charset>UTF-8</charset>；
• FileAppender 的 fileNamePattern 不含中文：避免日志轮转时因文件名编码问题失败；
• 日志采集器（Filebeat/Fluentd）配置：明确指定输入编码为 UTF-8，例如 Filebeat 中：
  input:
  encoding: utf-8；
• Zipkin/Sleuth 链路日志：确保 spring.sleuth.log.slf4j.enabled=true，且底层 Logback 已配 UTF-8，避免 span tag 中文被截断或乱码。