Linux 部署 Web 應用亂碼問題根因分析與統一編碼解決方案

核心結論

Linux 下 Web 應用亂碼的根本原因是應用層、數據庫層、文件存儲層編碼不一致。解決之道只有一條：全鏈路統一編碼（推薦 UTF-8）。

完整編碼鏈路檢查清單

關鍵配置詳解

1. 數據庫創建（MySQL 5.5+ / MariaDB 10+）

-- 僅支持 BMP 字符（無 Emoji）
CREATE DATABASE mydb DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

-- 支持完整 Unicode（含 Emoji，推薦）
CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

注意：MySQL 的 utf8 僅支持 3 字節字符，utf8mb4 才是真正的 UTF-8。

2. JDBC 連接字符串（關鍵）

# MySQL 5.1.13+ (Connector/J 5.1+)
jdbc:mysql://host:3306/mydb?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&serverTimezone=Asia/Shanghai

# MySQL 8.0+ (Connector/J 8.0+)
jdbc:mysql://host:3306/mydb?characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai

驅動版本陷阱：舊版驅動（如 3.0.9）不支持 utf8mb4，需升級至 5.1.47+ 或 8.0.23+。

3. Spring / Spring Boot 統一編碼配置

# Spring Boot application.yml
server:
  servlet:
    encoding:
      charset: UTF-8
      force: true
      enabled: true

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb?characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai
    hikari:
      connection-init-sql: SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci

4. Tomcat 8/9 server.xml

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

5. JSP/HTML 頁面聲明

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />

為什麼不需要修改系統級配置？

很多教程建議修改 /etc/sysconfig/i18n 或 /etc/my.cnf 的 default-character-set，實際上這些是服務端默認值，不影響已顯式指定編碼的連接。只要應用層在連接時顯式聲明 characterEncoding=utf8mb4，系統級配置即可忽略。

常見亂碼場景診斷表

一鍵驗證腳本

#!/bin/bash
echo "=== 數據庫編碼 ==="
mysql -e "SHOW VARIABLES LIKE 'character_set%'; SHOW VARIABLES LIKE 'collation%';"

echo -e "\n=== 當前連接編碼 ==="
mysql -e "SHOW VARIABLES LIKE 'character_set_connection';"

echo -e "\n=== 表編碼樣例 ==="
mysql -e "SELECT TABLE_NAME, TABLE_COLLATION FROM information_schema.TABLES WHERE TABLE_SCHEMA='your_db' LIMIT 5;"

echo -e "\n=== JDBC 驅動版本 ==="
find ~/.m2 -name "mysql-connector-java*.jar" 2>/dev/null | head -1 | xargs -I{} unzip -p {} META-INF/MANIFEST.MF | grep Implementation-Version

總結

Linux Web 亂碼治理三部曲：

1. 統一編碼：全鏈路 UTF-8 (utf8mb4)，拒絕 GB2312/GBK
2. 顯式聲明：JDBC URL、JSP pageEncoding、Tomcat URIEncoding、Spring Filter 全部顯式配置
3. 驅動升級：MySQL Connector/J 5.1.47+ 或 8.0.23+，舊版驅動是隱形殺手

遵循此原則，無需動系統配置，亂碼問題可徹底根治。