Perl 透過 DBI/DBD::mysql 向 MySQL 寫入中文出現亂碼,本質是客戶端、連線、結果集三層字符集不一致。本文從原理、配置、程式碼三個層面徹底解決,並說明為何必須在每次連線後執行 SET NAMES utf8mb4。
應用程式 (Perl 內部 UTF-8)
↓ client encoding
MySQL Client Library (libmysqlclient)
↓ connection encoding
MySQL Server (character_set_connection)
↓ 存儲引擎
Table/Column (CHARSET=utf8mb4)
關鍵三個系統變量:
character_set_client:客戶端發送資料的編碼character_set_connection:Server 解譯客戶端資料的編碼character_set_results:Server 回傳結果集的編碼SET NAMES utf8mb4 等價於同時設定以上三者為 utf8mb4。
[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
init_connect = 'SET NAMES utf8mb4' # 非超級用戶自動生效
注意: init_connect 對擁有 SUPER 權限的用戶 (如 root) 不生效,應用賬號請勿授予 SUPER。
CREATE TABLE `article` (
`id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`title` VARCHAR(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL,
`content` TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
明確指定 CHARACTER SET utf8mb4 避免繼承資料庫預設值導致不一致。
use DBI;
use Encode qw(encode_utf8);
my $dsn = "dbi:mysql:database=test;host=localhost;port=3306;mysql_enable_utf8=1";
my $dbh = DBI->connect($dsn, 'user', 'pass', {
RaiseError => 1,
PrintError => 0,
AutoCommit => 1,
mysql_enable_utf8 => 1, # 關鍵:DBD::mysql 4.004+ 自動處理 UTF-8
mysql_auto_reconnect => 1,
});
# 雙重保險:連線建立後立即執行
$dbh->do("SET NAMES utf8mb4");
$dbh->do("SET CHARACTER SET utf8mb4");
# 插入中文測試
my $sth = $dbh->prepare("INSERT INTO article (title, content) VALUES (?, ?)");
$sth->execute("測試標題", "這是中文內容測試");
$sth->finish();
# 讀取驗證
my $row = $dbh->selectrow_hashref("SELECT * FROM article WHERE id = LAST_INSERT_ID()");
print "Title: ", $row->{title}, "\n"; # 應正常顯示中文
$dbh->disconnect();
| 誤區 | 正確做法 |
|---|---|
| 只設定資料庫/表 charset,不設連線 | 必須執行 SET NAMES 或啟用 mysql_enable_utf8 |
| 使用 utf8 (3 字節) 而非 utf8mb4 (4 字節) | 全鏈路統一 utf8mb4,支援 Emoji 及罕見字 |
| 以為 my.cnf 設定永久生效 | init_connect 對 SUPER 用戶無效,應用層仍需顯式 SET NAMES |
| Perl 字串未標記 UTF-8 旗標 | 使用 use utf8; 並在字串常量前加 Encode::encode_utf8 (如需要) |
-- 連線後執行
SHOW VARIABLES LIKE 'character_set_%';
-- 期望輸出 client/connection/results/database/server 皆為 utf8mb4
遵循「伺服器預設 utf8mb4 + 連線即 SET NAMES utf8mb4 + 表欄位顯式 utf8mb4 + DBD::mysql 啟用 utf8 旗標」四步驟,即可徹底告別中文亂碼。