Flutter TextFormField存emoji到MySQL乱码为????的解决方法

MySQL 内置的utf8字符集最多仅支持3字节长度的Unicode字符，绝大多数新版emoji属于4字节长度的辅助平面Unicode字符，仅少量老旧表情（如你案例中可正常存储的☺️）属于3字节BMP平面字符，因此会出现部分表情存储后变为????的问题。要实现全量emoji正常存储，必须保证从前端请求、后端连接到数据库存储的整条链路都支持4字节UTF-8编码（即utf8mb4）。

1. 数据库层配置调整 #

• 先将对应库、表、存储用户输入内容的字段字符集全部修改为utf8mb4，排序规则选择兼容性更好的utf8mb4_unicode_ci，执行对应SQL即可：

-- 修改数据库默认字符集
ALTER DATABASE 你的业务数据库名 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
-- 修改存储帖子内容的表字符集
ALTER TABLE 存储publicacion的业务表名 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 若需单独指定存用户输入的字段，可执行以下语句（以texto、asunto字段为例）
ALTER TABLE 存储publicacion的业务表名 CHANGE texto texto TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE 存储publicacion的业务表名 CHANGE asunto asunto TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

• 修改MySQL服务配置文件：Linux环境为my.cnf，Windows环境为my.ini，添加以下配置后重启MySQL服务生效：

[client]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4

[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

2. PHP后端配置调整 #

这是最高发的漏配项：即使数据库字符集配置正确，若PHP连接MySQL时未指定连接字符集为utf8mb4，传输过程中4字节字符依然会被转成问号。

• 若使用PDO连接数据库，连接DSN中必须明确指定charset参数：

$pdo = new PDO("mysql:host=数据库地址;dbname=业务库名;charset=utf8mb4", "数据库用户名", "数据库密码");

• 若使用mysqli连接数据库，连接建立后立刻执行字符集设置：

$conn = mysqli_connect("数据库地址", "数据库用户名", "数据库密码", "业务库名");
mysqli_set_charset($conn, 'utf8mb4');

注意：禁止在连接配置中使用SET NAMES utf8，必须指定为utf8mb4。

3. Flutter前端请求优化 #

你当前的请求逻辑基本可用，补充两点细节即可：

• 发送请求时添加明确的Content-Type请求头，指定编码为utf-8，避免后端默认用其他编码解析请求体；
• 解析响应时使用utf8解码器处理响应字节，避免返回内容乱码。
  修改后的请求代码示例：

var response = await http.post(
  url,
  headers: {
    "Content-Type": "application/json; charset=utf-8"
  },
  body: json.encode(data)
);
// 用utf8解码响应内容，替代直接取response.body
String respuesta = utf8.decode(response.bodyBytes);

不需要在Flutter侧对emoji做额外转义、编码处理，只要链路字符集统一，原生emoji可直接传输存储。

配置完成后，发送包含多版本emoji的测试内容（如😀🥹🎉ggg☺️🐶），查询数据库时若能正常展示原始表情、无问号占位，即说明配置生效。

内容的提问来源于stack exchange，提问作者mvasco