DebianMariaDB字符集设置建议

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 中通常占用更多空间；必要时使用前缀索引或调整列定义。