Quarkus native image中文编码问题，尝试多类配置后仍未解决

排查步骤 #

• 确认问题触发场景
  先明确乱码出现的场景：接口响应乱码、本地文件读取乱码、控制台/日志打印乱码，不同场景对应不同根因：
  • 接口响应乱码：优先排查HTTP响应头是否携带charset=utf-8标识
  • 文件读取乱码：检查源文件存储编码是否为UTF-8，读取逻辑是否显式指定编码
  • 日志/控制台乱码：检查运行环境的系统编码，以及日志框架的编码配置
• 验证配置生效状态
  给native镜像添加启动参数-Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8启动后，输出System.getProperty("file.encoding")和System.getProperty("sun.jnu.encoding")，确认两个参数均为UTF-8。如果参数不生效，说明构建环节的配置被覆盖。
• 验证GraalVM版本兼容性
  旧版本GraalVM存在字符集裁剪逻辑不兼容Quarkus配置的问题，可先升级到当前Quarkus版本匹配的最新GraalVM LTS版本复现验证。

解决方案 #

• 接口响应乱码修复
  在application.properties中添加全局HTTP编码配置：

  # 全局HTTP响应编码
  quarkus.http.response-charset=UTF-8
  # 根据你使用的REST框架二选一
  quarkus.resteasy-reactive.default-charset=UTF-8
  # quarkus.resteasy.default-charset=UTF-8
  

• 文件读取乱码修复
  所有文件读取逻辑强制显式指定UTF-8编码，禁止依赖系统默认编码：

  // 错误写法
  new FileReader("test.txt");
  // 正确写法
  new InputStreamReader(new FileInputStream("test.txt"), StandardCharsets.UTF_8);
  

• 构建环节字符集强制引入
  替换原有native构建参数，优先使用GraalVM原生字符集引入参数：

  quarkus.native.add-all-charsets=true
  quarkus.native.additional-build-args=-J-Dfile.encoding=UTF-8,-J-Dsun.jnu.encoding=UTF-8,-H:-CheckToolchain,-H:+AddAllCharsets
  

• 容器运行环境编码配置
  如果使用容器部署，在Dockerfile中添加系统编码环境变量：

  ENV LANG=C.UTF-8
  ENV LC_ALL=C.UTF-8
  

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