Кодировка utf8mb4 в MySQL и MariaDB: как проверить и сменить
utf8mb4 — кодировка, в которой база хранит любые символы: кириллицу, иероглифы и эмодзи. В MySQL 8.0 и в MariaDB из Ubuntu 24.04 она стоит сразу после установки. Базы, перенесённые со старых серверов, бывают в utf8 или latin1 — тогда эмодзи в них не сохраняются, а сайт показывает ошибку.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться) и откройте консоль базы:
sudo mysqlдля MySQL илиsudo mariadbдля MariaDB. - Посмотрите кодировку сервера:
SELECT @@character_set_server, @@collation_server; - Посмотрите кодировку базы сайта. Вместо shop — имя своей базы:
SELECT DEFAULT_CHARACTER_SET_NAME, DEFAULT_COLLATION_NAME
FROM information_schema.SCHEMATA
WHERE SCHEMA_NAME = 'shop';- Найдите таблицы, которые ещё не в 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%';- Ответ «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 считает это имя устаревшим |
| latin1 | 1 | нет | нет | западноевропейская кодировка: латиница и знаки вроде é и ß |
Имя utf8 сбивает с толку: кажется, что это та же UTF-8, что на сайте, но в MySQL и MariaDB это урезанный вариант. Для новых баз и таблиц пишите utf8mb4.
Кириллица в utf8mb3 хранится без потерь. Разница видна, когда посетитель пишет в комментарии или в заказе эмодзи: utf8mb3 не может их сохранить.
Правило сравнения: что такое COLLATE
У кодировки есть правило сравнения — collation. Оно решает, как база сравнивает и сортирует строки: равны ли «Ёж» и «еж», что идёт раньше в списке.
| База | Кодировка после установки | Правило сравнения после установки |
|---|---|---|
| MySQL 8.0 | utf8mb4 | utf8mb4_0900_ai_ci |
| MariaDB 10.11 из Ubuntu 24.04 | utf8mb4 | utf8mb4_general_ci — задано в файле 50-server.cnf |
| MariaDB 11.5 и старее без такого файла | latin1 | latin1_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.
Источники
- Документация MySQL 8.0: Server Character Set and Collation — на английском: utf8mb4 и utf8mb4_0900_ai_ci по умолчанию.
- Документация MySQL 8.0: Database Character Set and Collation — на английском: ALTER DATABASE, таблица SCHEMATA, кодировка базы как значение по умолчанию для CREATE TABLE.
- Документация MySQL 8.0: The utf8mb4 Character Set — на английском: до четырёх байт на символ, utf8 — устаревшее имя utf8mb3.
- Документация MySQL 8.0: Converting Between 3-Byte and 4-Byte Unicode Character Sets — на английском: предел 767 байт, 191 символ в индексе, форматы COMPACT, REDUNDANT и DYNAMIC.
- Документация MySQL 8.0: ALTER TABLE Statement — на английском: CONVERT TO CHARACTER SET, переход TEXT в MEDIUMTEXT, перевод столбца через BLOB.
- Документация MySQL 8.0: Online DDL Operations — на английском: смена кодировки перестраивает таблицу и не пускает запись.
- Документация MySQL 8.0: Connection Character Sets and Collations — на английском: SET NAMES и кодировка подключения.
- Документация MariaDB: Server System Variables — на английском: character_set_server latin1 до MariaDB 11.5, utf8 как имя utf8mb3 с MariaDB 10.6, строгий режим в sql_mode.
- Файл 50-server.cnf из пакета mariadb в Ubuntu 24.04 — строки character-set-server и collation-server.
- Исходный код MySQL 8.0.46: messages_to_clients.txt — тексты ошибок 1366 и 1071.
- Документация PHP: PDO_MYSQL DSN — на английском: параметр charset в строке подключения.
- Исходный код WordPress: class-wpdb.php — функция determine_charset: кодировка utf8 заменяется на utf8mb4.
- Исходный код WordPress: wp-config-sample.php — строка DB_CHARSET со значением utf8mb4.
Сверено 23 октября 2026 года.
Что почитать дальше
- Создать и удалить базукак сразу создать базу в utf8mb4.
- Ошибка 1273 Unknown collationчто делать, если дамп из MySQL 8 не загружается в MariaDB.
- mysqldump: копия базыкак сделать дамп перед сменой кодировки.
- Настройки MySQL и MariaDBгде лежат файлы и как применить настройку.