Поиск
Справочник

Кодировка utf8mb4 в MySQL и MariaDB: как проверить и сменить

utf8mb4 — кодировка, в которой база хранит любые символы: кириллицу, иероглифы и эмодзи. В MySQL 8.0 и в MariaDB из Ubuntu 24.04 она стоит сразу после установки. Базы, перенесённые со старых серверов, бывают в utf8 или latin1 — тогда эмодзи в них не сохраняются, а сайт показывает ошибку.

≈ 10 мин чтения3 шага
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться) и откройте консоль базы: sudo mysql для MySQL или sudo mariadb для MariaDB.
  2. Посмотрите кодировку сервера: SELECT @@character_set_server, @@collation_server;
  3. Посмотрите кодировку базы сайта. Вместо shop — имя своей базы:
SELECT DEFAULT_CHARACTER_SET_NAME, DEFAULT_COLLATION_NAME
FROM information_schema.SCHEMATA
WHERE SCHEMA_NAME = 'shop';
  1. Найдите таблицы, которые ещё не в utf8mb4:
SELECT TABLE_NAME, TABLE_COLLATION
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'shop' AND TABLE_TYPE = 'BASE TABLE'
  AND TABLE_COLLATION NOT LIKE 'utf8mb4%';
  1. Ответ «Empty set» значит, что все таблицы уже в utf8mb4 — менять ничего не нужно. Если таблицы нашлись, сделайте копию базы и переведите их по шагам из раздела «Как перевести таблицы на utf8mb4».

utf8mb4, utf8mb3, utf8 и latin1: в чём разница

КодировкаБайт на символКириллицаЭмодзиЧто это
utf8mb4до 4дадаполная UTF-8: любые символы Юникода
utf8mb3до 3данетурезанная UTF-8: только основная часть Юникода, без эмодзи и редких иероглифов
utf8до 3данетв MySQL 8.0 и в MariaDB 10.6 и новее — другое имя utf8mb3; MySQL 8.0 считает это имя устаревшим
latin11нетнетзападноевропейская кодировка: латиница и знаки вроде é и ß

Имя utf8 сбивает с толку: кажется, что это та же UTF-8, что на сайте, но в MySQL и MariaDB это урезанный вариант. Для новых баз и таблиц пишите utf8mb4.

Кириллица в utf8mb3 хранится без потерь. Разница видна, когда посетитель пишет в комментарии или в заказе эмодзи: utf8mb3 не может их сохранить.

Правило сравнения: что такое COLLATE

У кодировки есть правило сравнения — collation. Оно решает, как база сравнивает и сортирует строки: равны ли «Ёж» и «еж», что идёт раньше в списке.

БазаКодировка после установкиПравило сравнения после установки
MySQL 8.0utf8mb4utf8mb4_0900_ai_ci
MariaDB 10.11 из Ubuntu 24.04utf8mb4utf8mb4_general_ci — задано в файле 50-server.cnf
MariaDB 11.5 и старее без такого файлаlatin1latin1_swedish_ci

Окончание _ci значит «без учёта регистра»: при поиске «Москва» и «москва» совпадут. _ai в MySQL 8.0 значит «без учёта знаков над буквами».

Правило utf8mb4_0900_ai_ci есть только в MySQL. Если дамп с ним загружают в MariaDB, появляется ошибка 1273 Unknown collation.

Как выглядит ошибка

Когда эмодзи попадает в столбец utf8mb3, utf8 или latin1, база отвечает так:

ERROR 1366 (HY000): Incorrect string value: '\xF0\x9F\x98\x80' for column 'comment' at row 1

По-русски: «Неверное строковое значение для столбца comment в строке 1». \xF0\x9F\x98\x80 — это байты эмодзи 😀, которые столбец не может сохранить. В MySQL 8.0 и MariaDB после установки включён строгий режим STRICT_TRANS_TABLES, поэтому запрос прерывается ошибкой и строка не записывается.

Сайт на WordPress или другом движке в этот момент показывает свою ошибку или не сохраняет комментарий. Чтобы найти точную причину, откройте журнал ошибок базы и журнал ошибок сайта.

Как узнать кодировку таблицы и столбцов

Кодировка одной таблицы — последняя строка ответа на SHOW CREATE TABLE. Сначала выберите базу командой USE shop;, затем:

SHOW CREATE TABLE comments\G

В конце ответа MySQL 8.0 будет строка вида:

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci

Кодировку можно задать и отдельному столбцу, поэтому таблица в utf8mb4 может хранить столбец в latin1. Все такие столбцы базы покажет запрос:

SELECT TABLE_NAME, COLUMN_NAME, CHARACTER_SET_NAME
FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = 'shop'
  AND CHARACTER_SET_NAME IS NOT NULL
  AND CHARACTER_SET_NAME <> 'utf8mb4';
Где задана кодировкаНа что влияетКак посмотреть
сервер: character_set_serverна новые базы, если в CREATE DATABASE кодировка не указанаSELECT @@character_set_server;
базана новые таблицы, если в CREATE TABLE кодировка не указаназапрос к information_schema.SCHEMATA выше
таблицана новые столбцы этой таблицыSHOW CREATE TABLE имя\G
столбецна то, что в нём хранитсязапрос к information_schema.COLUMNS выше
подключениев какой кодировке сайт отправляет и получает строкиSHOW VARIABLES LIKE 'character_set_c%';

Главное в этой таблице — столбец: данные лежат именно в нём. Кодировка сервера и базы задаёт только то, что получат новые таблицы.

Как перевести таблицы на utf8mb4

Шаг 1. Сделайте копию базы

Перевод переписывает каждую таблицу заново. Перед ним сделайте дамп базы — как сделать копию. Из него можно вернуть базу, если что-то пойдёт не так.

Шаг 2. Смените кодировку базы

ALTER DATABASE shop CHARACTER SET utf8mb4;

Без COLLATE база получит правило сравнения, которое стоит для utf8mb4 по умолчанию: utf8mb4_0900_ai_ci в MySQL 8.0, utf8mb4_general_ci в MariaDB 10.11. Эта команда не трогает таблицы, которые уже есть: она меняет кодировку только для новых.

Шаг 3. Переведите каждую таблицу

ALTER TABLE comments CONVERT TO CHARACTER SET utf8mb4;

Команда меняет кодировку таблицы и всех её текстовых столбцов: CHAR, VARCHAR и TEXT. Пока она идёт, записать в таблицу ничего нельзя, поэтому большие таблицы переводите ночью, когда на сайте мало посетителей.

Если таблиц много, база сама составит команды для всех. Выполните USE shop;, затем:

SELECT CONCAT('ALTER TABLE `', TABLE_NAME, '` CONVERT TO CHARACTER SET utf8mb4;')
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'shop' AND TABLE_TYPE = 'BASE TABLE'
  AND TABLE_COLLATION NOT LIKE 'utf8mb4%';

Скопируйте строки из ответа, вставьте их в консоль и нажмите Enter. Затем повторите запрос из пункта 4 раздела «Что сделать прямо сейчас»: ответ «Empty set» значит, что всё переведено.

Что может измениться

  • Столбец TEXT из latin1 может стать MEDIUMTEXT. В utf8mb4 символ занимает до 4 байт, и база сама берёт тип, в который поместится столько же символов. Данные при этом не теряются.
  • Старая таблица может ответить ошибкой ERROR 1071 (42000): Specified key was too long; max key length is 767 bytes — «Ключ слишком длинный, предел 767 байт». Так бывает у таблиц с форматом строк COMPACT или REDUNDANT: индекс в них вмещает 191 символ utf8mb4. Переведите такую таблицу на формат DYNAMIC командой ALTER TABLE comments ROW_FORMAT=DYNAMIC; и повторите перевод. В формате DYNAMIC индекс вмещает до 3072 байт, и в MySQL 8.0 он стоит у новых таблиц по умолчанию.

Формат строк всех таблиц базы покажет запрос:

SELECT TABLE_NAME, ROW_FORMAT FROM information_schema.TABLES WHERE TABLE_SCHEMA = 'shop';

Если вместо русских букв видны знаки вида привет

Так выглядит слово «привет», когда байты UTF-8 лежат в столбце latin1. CONVERT TO здесь не подходит: он перекодирует эти байты второй раз, и текст испортится сильнее. Для такого столбца документация MySQL советует две команды подряд — сначала в BLOB, затем обратно в текст. Пример для столбца body типа TEXT:

ALTER TABLE comments CHANGE body body BLOB;
ALTER TABLE comments CHANGE body body TEXT CHARACTER SET utf8mb4;

Имя столбца в каждой команде написано дважды: старое и новое, они совпадают. При переводе в BLOB и обратно база не перекодирует байты, а просто считает их utf8mb4. CHANGE описывает столбец заново: если у него были NOT NULL или DEFAULT, допишите их во вторую команду — их покажет SHOW CREATE TABLE. Делайте это только после копии базы и сначала на одном столбце.

Кодировка подключения сайта

База хранит эмодзи, только если и сайт отправляет их в utf8mb4. В консоли кодировку подключения задаёт команда SET NAMES utf8mb4;. Сайт задаёт её сам при подключении к базе:

  • в WordPress — строка define( 'DB_CHARSET', 'utf8mb4' ); в файле wp-config.php. Если в ней стоит 'utf8', WordPress сам подключается в utf8mb4;
  • в своём коде на PHP через PDO — charset=utf8mb4 в строке подключения, например mysql:host=localhost;dbname=shop;charset=utf8mb4.

Кодировка в файле настроек

В MariaDB из Ubuntu 24.04 кодировку сервера задают две строки в файле /etc/mysql/mariadb.conf.d/50-server.cnf:

character-set-server  = utf8mb4
collation-server      = utf8mb4_general_ci

В файле MySQL /etc/mysql/mysql.conf.d/mysqld.cnf таких строк нет: MySQL 8.0 и без них берёт utf8mb4. Менять эти строки для работающего сайта не нужно — на базы и таблицы, которые уже есть, они не влияют. Как открыть файл и применить настройку, написано в разделе Настройки MySQL и MariaDB.

Источники

Сверено 23 октября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше