在 Spring MVC 中,若 Controller 使用 @ResponseBody 回傳 JSON,中文有時會在前台變成問號或亂碼。這通常是回應編碼與專案實際編碼不一致造成的。
部分 Spring 版本中,@ResponseBody 的預設編碼可能不是 UTF-8,而是 ISO-8859-1。若資料庫、頁面與專案都使用 UTF-8,但回應仍採用舊編碼,中文就會在轉換過程中遺失。
最直接的方式是在方法對應的路徑中加入 produces:
@RequestMapping(value = "/echarts.do", produces = "application/json; charset=utf-8")
這樣 Spring 在產生回應時,會依指定編碼輸出 JSON,前台即可正常顯示中文。
若專案中有大量 JSON 回應,逐一在每個方法設定會很繁瑣。此時可調整 Spring MVC 的訊息轉換器,例如設定 MappingJackson2HttpMessageConverter 或 FastJson 的編碼為 UTF-8,讓所有 JSON 回應一致採用相同編碼。
遇到中文亂碼時,可先確認三件事:資料庫連線編碼是否為 UTF-8、頁面與請求標頭是否一致、伺服器回應標頭中的 charset 是否正確。三者都一致後,前台才不會出現問號。