有一個功能上線試用了一週都沒問題,某天卻突然出現亂碼——而且是只在某一台機器上發生。這種「別人正常、我這邊不行」的狀況,往往比全面性的錯誤更難查。
這個功能會把一組設備狀態整理成參數,送給後端查詢。參數組裝的部分長這樣:
AjaxRequestObj.createEqStatusParameter = function() {
if (eqStatusArray.length < 1) { return; }
var paramNameArray = new Array();
var paramValueArray = new Array();
// 取出狀態陣列
for (var index = 0, step = eqStatusArray.length; index < step; index++) {
var tempEqStatusObj = eqStatusArray[index];
paramNameArray.push(tempEqStatusObj.eqCode + "`" + tempEqStatusObj.opDateTime);
paramValueArray.push(tempEqStatusObj.status);
}
// 分解並生成請求串
var paramStr = "";
paramStr = paramStr.concat("eqStatusNames=")
.concat(encodeURIComponent(paramNameArray.join(",")))
.concat("&");
paramStr = paramStr.concat("eqStatusValues=")
.concat(encodeURIComponent(paramValueArray.join("`")));
return paramStr;
};
xmlHttpObj.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
xmlHttpObj.send(param);
客戶端把參數以 UTF-8 傳給應用端,後端使用時直接從 request 取值即可。這一段本身沒有問題。
if ("doQueryRequest".equals(actParam)) {
EquipUtils equipUtilsObj = EquipUtils.getInstance();
equipStatusMgrObj.setEquipCondition(equipUtilsObj.createEquipFilter(request));
equipStatusMgrObj.setEquipStatusCondition(equipUtilsObj.getEquipStatusDate(request));
List<DynaBean> equipArray = equipStatusMgrObj.queryEquip(null);
Map<String, Map<String, String>> equipStatusMapping =
equipStatusMgrObj.queryEquipState4Map(equipArray, null);
sessionObj.setAttribute("paginationEntity", equipStatusMgrObj.getPaginationEntity());
request.setAttribute("equipList", equipArray);
request.setAttribute("dateList", equipStatusMapping);
try {
request.getRequestDispatcher("/eq/detectPoint/InnerEqStatusRefresh.jsp")
.forward(request, response);
} catch (Exception e) {
e.printStackTrace();
}
} else if ("getPageToolBar".equals(actParam)) {
PaginationEntity pEntity = (PaginationEntity) sessionObj.getAttribute("paginationEntity");
String tempStr = pEntity.getPaginationTool();
try {
response.setContentType("text/html;charset=UTF-8");
OutputStream out = response.getOutputStream();
out.write(tempStr.getBytes("UTF-8"));
out.flush();
out.close();
} catch (IOException e) {
e.printStackTrace();
}
}
由於 xmlHttpObj.responseText 預設就是以 UTF-8 解讀,把 forward 目標頁面統一改成 UTF-8 是很合理的選擇,至少不必再為亂碼操心。
這個功能原本採用 GB18030 編碼,在其他人機器上一直正常,只有我自己的機器翻頁時出現亂碼。最後把相關的呈現檔案全部統一為 UTF-8 就解決了。老實說,問題是解決了,但為什麼只有那台機器出問題,始終沒找到確切原因——不同瀏覽器版本、安裝的字型或語言設定、快取中殘留的舊頁面,都有可能摻一脚在裡面。
response.setContentType("text/html;charset=UTF8"); 在我的機器上不報錯,在同事的機器上卻會拋例外。改成 response.setContentType("text/html;charset=UTF-8"); 之後一切正常。
這其實不是「機器挑人」,而是規格使然:MIME 的 charset 參數必須寫成 UTF-8,中間要有連字號。有些容器實作較寬鬆,願意接受 UTF8 這種寫法;較嚴格的實作則會直接判定為不支援的編碼而丟出 UnsupportedEncodingException。同一份程式碼在不同容器或不同版本上行為不一致,通常就是這種「規格邊界行為」造成的。
第一,編碼問題要在三個點上同時確認:頁面檔案本身的編碼、伺服器回應標頭宣告的 charset、以及前端解讀時的預設值。任何一處不一致都可能出亂碼。第二,把整個專案統一到 UTF-8(包含資料庫連線字串與檔案儲存格式)比逐頁修補省事得多。第三,寫 charset 時照規格來,不要依賴某個容器的寬鬆處理。第四,遇到「只有我這台不行」的問題,先排除快取與瀏覽器版本差異,往往比翻程式碼更快找到線索。