萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

解決 AJAX 回調中文亂碼:設定 Response Content-Type 與編碼

現象

Struts2 / Spring MVC / Servlet 回傳中文 JSON/文字,前端 AJAX `success` 回調收到亂碼 (如 `涓婂竷`、 )。

核心修正:回應前設定正確 Content-Type 與 Charset

Struts2 / Servlet API

HttpServletResponse response = ServletActionContext.getResponse();
// 必須在 getWriter() / getOutputStream() **之前** 呼叫
response.setContentType("application/json;charset=UTF-8"); // JSON 建議
// 或純文字
// response.setContentType("text/plain;charset=UTF-8");
response.getWriter().write(jsonString);

Spring MVC @ResponseBody

@Controller
@RequestMapping("/api")
public class ApiController {

  @GetMapping(value = "/data", produces = "application/json;charset=UTF-8")
  @ResponseBody
  public Map data() {
    return Map.of("msg", "中文內容正常");
  }
}

`produces` 屬性自動設定 `Content-Type` 標頭。

Spring MVC 全域設定 (WebMvcConfigurer)

@Configuration
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
  @Override
  public void configureMessageConverters(List> converters) {
    MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
    converter.setDefaultCharset(StandardCharsets.UTF_8);
    converters.add(0, converter); // 優先使用
  }
}

傳統 JSP 頁面輸出 JSON

<%@ page contentType="application/json;charset=UTF-8" pageEncoding="UTF-8" %>
<%
  response.setCharacterEncoding("UTF-8"); // 保雙重保障
  out.print("{\"msg\":\"中文正常\"}");
  out.flush();
%>

前端接收端確認

$.ajax({
  url: '/api/data',
  dataType: 'json', // jQuery 會依據 Content-Type 自動解析
  success: function(res) {
    console.log(res.msg); // 正確顯示中文
  }
});

// 原生 fetch
fetch('/api/data')
  .then(r => r.json()) // 自動依據 charset 解碼
  .then(console.log);

常見誤區

只設 `response.setCharacterEncoding("UTF-8")`
此方法**僅影響** `getWriter()` 取得的 `PrintWriter` 內部編碼,**不會**設定 HTTP `Content-Type` 標頭。瀏覽器若無標頭會猜測編碼 (常猜錯)。**必須**用 `setContentType("...;charset=UTF-8")` 或 `setHeader("Content-Type", "...")`。
JSP `pageEncoding` vs `contentType`
`pageEncoding` 決定 JSP 檔案**讀取**編碼;`contentType` 決定**輸出** HTTP 標頭。兩者皆需設為 UTF-8。
  • 資料庫連線編碼未設定:JDBC URL 加 `characterEncoding=utf8&useUnicode=true` (MySQL) 或確認 NLS_LANG (Oracle)。
  • 除錯檢查清單

    1. 瀏覽器 Network → Response Headers → `Content-Type: application/json;charset=UTF-8` 存在?
    2. Response 原始內容 (Raw) 是否為正確 UTF-8 位元組?
    3. 前端 `dataType: 'json'` 是否匹配?
    4. 資料庫/檔案讀取層編碼是否一致?
    copyright © 萬盛學電腦網 all rights reserved