linux mariadb为何乱码报错

在 Linux 上使用 MariaDB 出现“乱码 + 报错”，通常不是单一原因，而是 字符集配置不一致 导致的。下面按「常见原因 → 排查方法 → 解决方案」给你讲清楚。

一、最常见原因（90% 都是这些）

1️⃣ 客户端与服务器字符集不一致

例如：

客户端用 utf8mb4
服务端用 latin1

结果：

中文变成 ??? 或乱码
插入时报错：Incorrect string value

2️⃣ 数据库 / 表 / 字段字符集不统一

SHOW CREATE DATABASE db_name;
SHOW CREATE TABLE table_name;

常见问题：

库是 utf8mb4
表是 latin1
字段是 utf8

3️⃣ Linux 终端本身不支持中文

即使 MariaDB 没问题，终端也会显示乱码。

4️⃣ 连接时未指定字符集

很多程序（PHP / Python / Shell）连库时没加：

SET NAMES utf8mb4;

二、快速排查（一步一步来）

✅ 1. 查看 MariaDB 字符集

SHOW VARIABLES LIKE 'character%';
SHOW VARIABLES LIKE 'collation%';

正常推荐结果：

character_set_server = utf8mb4
character_set_client = utf8mb4
character_set_connection = utf8mb4
character_set_database = utf8mb4
character_set_results = utf8mb4

✅ 2. 查看具体表

SHOW CREATE TABLE your_table;

如果看到：

DEFAULT CHARSET=latin1

那就是元凶。

✅ 3. 查看连接字符集

STATUS;

看 Conn. 一行字符集。

三、标准解决方案（推荐）

✅ 方案 1：修改 MariaDB 配置（最彻底）

编辑配置文件（常见路径）：

/etc/my.cnf
或
/etc/mysql/my.cnf
或
/etc/mysql/mariadb.conf.d/50-server.cnf

添加：

[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[client]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4

重启：

systemctl restart mariadb

✅ 方案 2：修改已有库和表

ALTER DATABASE db_name
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;

ALTER TABLE table_name
CONVERT TO CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;

✅ 方案 3：连接时强制指定（临时）

SET NAMES utf8mb4;

或在程序中设置（如 Python）：

conn.execute("SET NAMES utf8mb4")

四、典型报错示例与含义

报错	原因
`Incorrect string value`	字段不支持该字符（如 emoji）
`?????`	客户端/服务端字符集不一致
`Illegal mix of collations`	联表字符集/排序规则不同

五、一个“黄金建议”

永远统一使用 utf8mb4
不要用 utf8（MariaDB 的 utf8 是假 utf8）

如果你愿意，可以把：

报错原文
SHOW VARIABLES LIKE 'character%'; 输出
表结构

贴出来，我可以直接帮你定位是哪一层出了问题。