亂碼本質是**「編碼宣告與實際位元組序列不匹配」**。涉及 HTTP 標頭、HTML Meta、資料庫連線、程式語言內部編碼、瀏覽器解析順序五大層面。本文建立「編碼一致性鏈路」檢查清單，覆蓋 Apache、PHP、Java (JSP/Servlet)、CGI (Perl) 四大主流棧，提供標準配置模板與避坑指南。
核心原則：全鏈路 UTF-8 (或全鏈路 GBK/Big5)，拒絕混用
現代應用**強制推薦全鏈路 UTF-8**：資料庫、連線、伺服器、程式、頁面、瀏覽器。僅在極舊系統維護時才考慮 GBK/Big5。
Apache (httpd.conf) 關鍵配置
# 關閉預設字元集宣告，讓頁面 Meta/HTTP 標頭決定
# AddDefaultCharset ISO-8859-1
AddDefaultCharset Off
# 或明確宣告 UTF-8 (若確定全站 UTF-8)
# AddDefaultCharset UTF-8
# 輸出過濾器確保 Content-Type 標頭攜帶 charset
AddType 'text/html; charset=UTF-8' .html .htm .php .jsp
AddCharset UTF-8 .html .htm .php .jsp .css .js .xml .json
# mod_deflate/mod_gzip 壓縮不改變編碼，確保不雙重壓縮
HTML 頁面：Meta 標籤放在 `` 最開頭
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>...</title>
...
</head>
關鍵： IE 解析順序為「HTML Meta → HTTP 標頭」；Firefox/Chrome 反之。Meta 必須在**任何非 ASCII 字元 (含 `
` 中文) 之前**，否則 IE 會以預設編碼解析前段內容導致亂碼。</p>
<h2>PHP (php.ini) 配置</h2>
<pre><code>; 內部編碼
default_charset = "UTF-8"
; 輸入/輸出/內部編碼統一 (PHP 5.6+)
input_encoding = "UTF-8"
output_encoding = "UTF-8"
internal_encoding = "UTF-8"
; 多位元組字串函數預設編碼
mbstring.language = Neutral
mbstring.internal_encoding = UTF-8
mbstring.http_input = pass
mbstring.http_output = pass
mbstring.encoding_translation = Off
mbstring.detect_order = "UTF-8,ASCII,JIS,EUC-JP,SJIS"
; 輸出緩衝區編碼轉換 (舊專案過渡用)
; output_handler = mb_output_handler</code></pre>
<p>程式碼層面：資料庫連線 `SET NAMES utf8mb4` (MySQL) / `PGCLIENTENCODING=UTF8` (PostgreSQL) / `charset=UTF-8` (PDO DSN)。</p>
<h2>Java (JSP/Servlet) 編碼鏈路</h2>
<table border="1" cellpadding="5" cellspacing="0" style="width:100%; border-collapse:collapse;">
<tr><th>層面</th><th>配置/代碼</th><th>說明</th></tr>
<tr><td>JSP 頁面指令</td><td>`<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>`</td><td>pageEncoding 決定 JSP 編譯時讀取編碼；contentType 決定輸出 HTTP 標頭</td></tr>
<tr><td>Servlet 輸出</td><td>`response.setContentType("text/html;charset=UTF-8"); response.setCharacterEncoding("UTF-8");`</td><td>必在 `getWriter()` 前調用</td></tr>
<tr><td>請求參數解碼 (GET/POST)</td><td>Tomcat `server.xml` Connector 加 `URIEncoding="UTF-8" useBodyEncodingForURI="true"`<br>或 Filter: `request.setCharacterEncoding("UTF-8")` (必在 `getParameter()` 前)</td><td>GET 參數在 URL 經 URIEncoding 解碼；POST 經 request 編碼解碼</td></tr>
<tr><td>資料庫連線</td><td>JDBC URL: `useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai` (MySQL)<br>`charSet=UTF-8` (Oracle/PostgreSQL)</td><td>連線層編碼協商</td></tr>
<tr><td>檔案讀寫</td><td>`new InputStreamReader(is, "UTF-8")` / `Files.readString(path, StandardCharsets.UTF_8)`</td><td>明確指定編碼，避免平台預設值</td></tr>
<tr><td>系統層面 (不推薦)</td><td>-Dfile.encoding=UTF-8 (JVM 啟動參數)</td><td>影響全域預設，可能導致第三方庫行為異常，慎用</td></tr>
</ul>
<h2>CGI (Perl) 配置</h2>
<pre><code># CGI.pm 內部預設輸出編碼
$CGI::DEFAULT_CHARSET = 'UTF-8'; # 修改 CGI.pm 或在腳本開頭 local $CGI::DEFAULT_CHARSET = 'UTF-8';
# 輸出 HTTP 標頭
print $q->header(-type => 'text/html', -charset => 'UTF-8');
# 參數解碼 (CGI.pm 3.15+ 自動處理 UTF-8 參數)
# 手動處理: use Encode; $val = decode('UTF-8', $q->param('key'));</code></pre>
<h2>資料庫層面 (MySQL 範例)</h2>
<pre><code>[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
init_connect = 'SET NAMES utf8mb4'
[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4</code></pre>
<p>建表：`CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci`。utf8mb4 支援完整 Unicode (含 Emoji/生僻字)，utf8 僅支援 BMP 平面。</p>
<h2>瀏覽器端驗證清單</h2>
<ol>
<li>開發者工具 → Network → Response Headers → `Content-Type: text/html; charset=UTF-8`</li>
<li>Elements → `<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">` 位於 `<head>` 首位</li>
3. 檢視原始碼 → 中文顯示正常、無 /亂碼</li>
4. 表單提交中文 → 伺服端接收正常、資料庫儲存正常、再次讀取顯示正常</li>
5. `curl -I -H "Accept-Charset: UTF-8" https://site/` 確認標頭</li>
</ol>
<h2>避坑總結</h2>
<ul>
<li>❌ Apache `AddDefaultCharset GB2312` + 頁面 Meta `UTF-8` → 衝突</li>
<li>❌ Meta 放在 `<title>` 之後 → IE 亂碼</li>
<li>❌ PHP `default_charset` 與 `mbstring.internal_encoding` 不一致</li>
<li>❌ Tomcat `URIEncoding` 未設 → GET 中文參數亂碼</li>
<li>❌ JDBC URL 缺 `characterEncoding` → 資料庫存入亂碼</li>
<li>❌ MySQL 仍用 `utf8` 而非 `utf8mb4` → Emoji 存入報錯/截斷</li>
<li>✅ 全鏈路 UTF-8，Meta 首位，連線明確指定編碼，資料庫 utf8mb4，瀏覽器驗證雙標頭</li>
</ul>
<p>亂碼不是玄學，是**每一層編碼宣告與實際位元組的契約**。建立「編碼一致性鏈路」檢查清單，納入 CI/CD 自動化驗證 (如 `charset-normalizer` 掃描檔案編碼、API 測試驗證回應標頭)，從源頭消滅亂碼基因。</p>
<div class="qcieb_es_1"></div>
<div class="ppieb_jdb3"> <script language='javascript' src='/ad/win.js'></script> </div>
<div class="ppieb_jdb4"></div>
<div class="qcieb_es_1"></div>
</div>
<ul class="ovnpxrx_win whsnabgsx">
<li>上一篇文章： <a class='LinkPrevArticle' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61759.html' >IIS「Service Unavailable」徹底解決方案：應用程式池調優與資源限制破解</a> <li>下一篇文章： <a class='LinkNextArticle' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61761.html' >vsftpd 500 OOPS: cannot change directory 錯誤一鍵修復：SELinux 布爾值調整</a>
</ul>
</div>
<div class="rinwbbvxg m2">
<div class="rinwbbvxg_rxx">
<div class="bgevxvhs_1"><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/' target="_blank">關於伺服器</a></div>
<div class="qcieb_es_1"></div>
</div>
<div class="rinwbbvxg_ibnx">
<div class="uyevxh">
<a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61771.html' target="_blank"><img src='https://win.yunyiwangluo.com/windows/UploadFiles_8258/201702/2017020810310582_S.jpg' width='100' height='70' alt='圖解 Windows Vista 安裝 IIS 7 並配置 ASP 環境' border='0'></a>
<a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61771.html' target="_blank"><strong>圖解 Windows Vista 安裝 IIS 7 並配置 ASP 環境</strong></a>
</div>
<div class="uyevxh">
<a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/62011.html' target="_blank"><img src='https://win.yunyiwangluo.com/windows/UploadFiles_8258/201702/2017020810354288_S.jpg' width='100' height='70' alt='Windows Server 2003 遠程 Web 管理介面部署與實戰' border='0'></a>
<a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/62011.html' target="_blank"><strong>Windows Server 2003 遠程 Web 管理介面部署與實戰</strong></a>
</div>
<div class="uyevxh">
<a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61415.html' target="_blank"><img src='https://win.yunyiwangluo.com/windows/UploadFiles_8258/201702/2017020810244207_S.jpg' width='100' height='70' alt='磁碟陣列速度突然變慢？區塊大小設定可能是關鍵' border='0'></a>
<a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61415.html' target="_blank"><strong>磁碟陣列速度突然變慢？區塊大小設定可能是關鍵</strong></a>
</div>
</div>
</div>
</div>
<div class="oienbbxc">
<div class="m2">
<div class="ovnpxrx_win xiahbrbbf">
<li><a class='childclass' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/dns/' target="_self">DNS 伺服器</a></li>
<li><a class='childclass' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/ftp/' target="_self">FTP 伺服器</a></li>
<li><a class='childclass' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/web/' target="_self">Web 伺服器</a></li>
<li><a class='childclass' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/daili/' target="_self">代理伺服器</a></li>
<li><a class='childclass' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/email/' target="_self">郵件伺服器</a></li>
<li><a class='childclass' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/fwqzh/' target="_self">伺服器綜合</a></li>
<li><a class='childclass' href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/' target="_self">關於伺服器</a></li>
<div class="qcieb_es_1"></div>
</div>
</div>
<div class="ppieb_jdb5"></div>
<div class="ensbbfx">
<div class="m2">
<div class="ekmbngbx ekmbngbx_c">
<label>推薦</label>
</div>
<div class="uierbxbsh lihen l120 ovnpxrx_win pdt">
<p><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61139.html' target="_blank">.NET Framework 3.5 安裝失敗錯誤 1603 完整解決方案：Windows Installer 清理工具與 .NET 修復工具雙軌修復</a></p>
<p><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61330.html' target="_blank">IDC 機房虛擬化伺服器選型全攻略：從應用分層到廠商機型實戰推薦</a></p>
<p><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/62071.html' target="_blank">打造高安全性 IIS Web 伺服器：Windows 2000 系統與 IIS 雙重防護實戰指南</a></p>
<p><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61691.html' target="_blank">SQL Server 記憶體配置選項深度優化：min/max server memory、max worker threads、索引建立與查詢記憶體</a></p>
<p><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61547.html' target="_blank">VPS 效能基準測試：UnixBench 一鍵腳本完整使用指南</a></p>
<p><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61849.html' target="_blank">伺服器專業術語大全：從入門到企業級架構完整指南</a></p>
<p><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61615.html' target="_blank">IIS 6.0 應用程式集區完整配置指南：回收機制、記憶體保護、Web Garden 與效能微調</a></p>
<p><a href='https://win.yunyiwangluo.com/windows/ruanjian/fwq/gyfwq/61660.html' target="_blank">Windows Server 2003 SP2 SNP 功能導致 NAT 失效的根因與解決方案</a></p>
</div>
</div>
</div>
</div>
<div class="qcieb_es_1"></div>
</div>
</div>
<div class="diianbgdag">Copyright © <a href="https://win.yunyiwangluo.com/" target="_blank" title="Windows教程網">Windows教程網</a> All Rights Reserved </div>
</body>
</html>
