Java URL 傳遞中文參數亂碼徹底解決方案：編碼/解碼最佳實踐

亂碼本質：編碼與解碼使用的字符集不匹配。

方案一：標準雙向處理（推薦，適用所有版本）

1. 發送端：URLEncoder.encode

String raw = "中文參數";
String encoded = java.net.URLEncoder.encode(raw, StandardCharsets.UTF_8.name());
// 结果：%E4%B8%AD%E6%96%87%E5%8F%83%E6%95%B0
String url = "/target?msg=" + encoded;

• 必須指定 UTF-8，避免平台默認編碼差異。
• 不要手動拼接，防止雙重編碼或漏編碼。

2. 接收端：request.getParameter + 手動轉碼（通用）

String encoded = request.getParameter("msg"); // 容器已按 ISO-8859-1 或 UTF-8 解碼一次
if (encoded != null) {
    // 關鍵：將容器解碼後的字符串「還原」為原始位元組，再按 UTF-8 重組
    String decoded = new String(encoded.getBytes(StandardCharsets.ISO_8859_1), StandardCharsets.UTF_8);
    // decoded 即為 "中文參數"
}

為什麼用 ISO-8859-1？ 它是單字節編碼，0x00~0xFF 一一映射，能無損「還原」容器解碼時產生的位元組序列，再按真實編碼（UTF-8）重組字符串。

方案二：Tomcat 8+ 全局配置 UTF-8（一勞永逸）

修改 server.xml 的 ``，添加 URIEncoding="UTF-8"：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           URIEncoding="UTF-8"
           useBodyEncodingForURI="true" />

• URIEncoding：指定 URL 解碼字符集（含 Query String）。
• useBodyEncodingForURI：若為 true，優先用請求體編碼（request.setCharacterEncoding）解碼 URL。

效果：配置後，request.getParameter("msg") 直接返回正確中文，**無需手動轉碼**。但需確保前端頁面編碼也是 UTF-8（``）。

方案三：Spring Boot / Spring MVC 統一攔截器

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Bean
    public FilterRegistrationBean<CharacterEncodingFilter> encodingFilter() {
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        filter.setForceEncoding(true); // 強制 request/response 編碼
        filter.setForceRequestEncoding(true);
        filter.setForceResponseEncoding(true);
        FilterRegistrationBean<CharacterEncodingFilter> bean = new FilterRegistrationBean<>(filter);
        bean.addUrlPatterns("/*");
        bean.setOrder(Ordered.HIGHEST_PRECEDENCE);
        return bean;
    }
}

配合 Tomcat URIEncoding="UTF-8"，實現全鏈路 UTF-8 無感知。

常見坑與避雷指南

總結

• 最穩健：前端 `encodeURIComponent` + 後端 Tomcat `URIEncoding="UTF-8"` + 頁面 `charset=UTF-8`，零代碼侵入。
• 無法改容器配置：後端統一用 new String(param.getBytes(ISO_8859_1), UTF_8) 手動轉碼，或封裝工具類/攔截器。
• 核心鐵律：編碼解碼字符集**必須完全一致**，全鏈路統一 UTF-8。