Debian MariaDB字符集设置建议 - 问答

Debian 上 MariaDB 字符集设置建议

一推荐方案

将服务器与客户端统一为 utf8mb4，以完整支持 Unicode（含 Emoji 等 4 字节字符）；MariaDB 10.x 默认多为 latin1，而 MySQL 8.0+ 默认已是 utf8mb4，因此建议显式配置为 utf8mb4。排序规则优先使用 utf8mb4_unicode_ci（更准确）或 utf8mb4_general_ci（性能略优）。为简化维护，建议在服务端统一设置，连接层保持自动协商即可。字符集与排序规则存在自上而下的继承关系（服务器 → 数据库 → 表 → 列），未显式指定时会逐级回退到上一级默认值。

二配置文件示例 Debian 路径

编辑 Debian 常用的分片配置，保持系统自带 include 结构，仅追加必要键值：
- /etc/mysql/my.cnf（主配置，通常仅保留 include）
```
[client-server]
!includedir /etc/mysql/conf.d/
!includedir /etc/mysql/mariadb.conf.d/
```
- /etc/mysql/mariadb.conf.d/50-server.cnf（服务端）
```
[mysqld]
character-set-server          = utf8mb4
collation-server              = utf8mb4_unicode_ci
character-set-client-handshake = FALSE   # 建议保持 FALSE，尊重客户端协商
# init_connect 可省略；若使用需确保 SUPER 权限账户不受影响
# init_connect                 = 'SET NAMES utf8mb4'
```
- /etc/mysql/mariadb.conf.d/50-client.cnf（所有客户端工具的默认）
```
[client]
default-character-set         = utf8mb4
```
- /etc/mysql/mariadb.conf.d/50-mysql-clients.cnf（mysql 命令行客户端）
```
[mysql]
default-character-set         = utf8mb4
```
说明：
- 以上分组与路径为 Debian 常见布局；不同发行版或安装方式可能略有差异，但原则是“服务端设置 utf8mb4，客户端默认 utf8mb4，必要时关闭客户端强行握手”。

三使配置生效与验证

重启服务（配置涉及服务器层变量，需重启而非仅 reload）：
```
sudo systemctl restart mariadb
```
登录数据库验证：
```
SHOW VARIABLES WHERE Variable_name LIKE 'character\_set\_%' OR Variable_name LIKE 'collation%';
```
期望看到关键变量为：character_set_server/connection/client/results/database = utf8mb4，collation_server/connection/database = utf8mb4_unicode_ci。另：character_set_system 通常为 utf8，character_set_filesystem 为 binary，属正常表现。

四存量对象迁移与注意事项

建库建表时显式指定字符集与排序规则（避免回退到旧默认）：

CREATE DATABASE dbname CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE t (
  id INT PRIMARY KEY,
  nick VARCHAR(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

已有对象可按需转换（示例）：

ALTER DATABASE dbname CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

连接与协议要点：
- 保持 character-set-client-handshake = FALSE，让服务器与客户端按能力协商；若设为 TRUE，可能强制使用服务器默认而非客户端期望的字符集。
- 不建议在全局使用 init_connect='SET NAMES utf8mb4'，因为 SUPER 账户不会执行该语句，可能导致会话字符集不一致；如确需统一连接字符集，请改为在应用或专用账户级初始化，或确保 SUPER 会话也执行相同设置。
- 排序规则选择：通用场景用 utf8mb4_unicode_ci；若确有性能瓶颈且可接受较弱的排序准确性，可考虑 utf8mb4_general_ci。
- 索引与键长：utf8mb4 下每个字符最多 4 字节，对 VARCHAR(255) 的索引在 InnoDB 中通常占用更多空间；必要时使用前缀索引或调整列定义。

0 赞

0 踩