Spring Boot 拦截器返回中文乱码的解决方案(附全局优化思路)

在 Spring Boot 项目开发中,我们常常会在 拦截器 中进行登录校验,并在未登录时直接返回 JSON 提示信息。但很多同学会遇到一个问题:中文提示信息出现乱码 (如 ??? 或乱码字符)。


一、问题原因

根源在于:
HTTP 响应的字符编码(Charset)未正确设置,导致前端解析中文失败。

  • 拦截器中直接使用 response.getWriter().write(...) 输出字符串;
  • Tomcat 默认使用 ISO-8859-1 编码,不支持中文;
  • 前端一般默认用 UTF-8 解析,编码不一致 → 乱码。

二、临时方案:手动设置响应编码

这是最快速见效的办法。在 response.getWriter().write(...) 之前,明确设置字符编码和 Content-Type:

java 复制代码
response.setCharacterEncoding("UTF-8");
response.setContentType("application/json;charset=UTF-8");
response.getWriter().write("{\"code\":401,\"msg\":\"请先登录!\"}");

修改拦截器示例:

java 复制代码
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    String token = request.getHeader(jwtProperties.getTokenName());
    if (StringUtils.isBlank(token)) {
        response.setCharacterEncoding("UTF-8");
        response.setContentType("application/json;charset=UTF-8");
        response.getWriter().write("{\"code\":401,\"msg\":\"请先登录!\"}");
        return false;
    }
    return true;
}

👉 这样可以立刻解决乱码问题,但存在硬编码 JSON、不可复用的问题。


三、优雅方案:使用统一的 Result 类

如果项目里已经有统一的返回对象(如 Result),建议复用,避免硬编码 JSON。

1. 注入 ObjectMapper

Spring Boot 默认集成了 Jackson,可直接注入:

java 复制代码
@Autowired
private ObjectMapper objectMapper;

2. 生成统一响应

用 Result 封装后,再转成 JSON 输出:

java 复制代码
Result<?> result = Result.fail(401, "请先登录!");
response.setCharacterEncoding("UTF-8");
response.setContentType("application/json;charset=UTF-8");
response.getWriter().write(objectMapper.writeValueAsString(result));

这样既能保证编码正确,又能保持返回格式一致。


四、根治方案:全局配置响应编码

如果你不想每次都手动设置编码,可以通过全局配置彻底解决。

方式 1:在 application.yml 配置

yaml 复制代码
spring:
  http:
    encoding:
      force: true
      charset: UTF-8
      enabled: true

方式 2:全局配置消息转换器

在 WebMvcConfig 中统一设置编码:

java 复制代码
@Bean
public StringHttpMessageConverter stringHttpMessageConverter() {
    StringHttpMessageConverter converter = new StringHttpMessageConverter(StandardCharsets.UTF_8);
    return converter;
}

这样项目中所有返回字符串的响应都会默认使用 UTF-8。


五、验证效果

  1. 启动项目后,访问需要登录的接口(不带 Token);
  2. 查看返回结果:
json 复制代码
{"code":401,"msg":"请先登录!"}

若能正常显示中文而不是乱码,说明问题已解决 ✅。

相关推荐
码事漫谈41 分钟前
以后人人都可以成为导演
后端
Resean02231 小时前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿1 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
小毛球.1 小时前
第 3 篇:IDEA 最新版下载与完整安装教程(Mac)
java·macos·intellij-idea·idea
北城笑笑2 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
Misnearch2 小时前
ScheduledExecutorService
java·线程池
ServBay3 小时前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
ashiho3 小时前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
其实防守也摸鱼4 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构