萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

Perl DBI 寫入 MySQL 中文亂碼徹底解決:SET NAMES 與字符集配置全攻略

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。

二、MySQL 伺服器端配置 (my.cnf)


[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 避免繼承資料庫預設值導致不一致。

四、Perl DBI 連線代碼範例


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 旗標」四步驟,即可徹底告別中文亂碼。

copyright © 萬盛學電腦網 all rights reserved