XAMPP 是许多开发者在本地搭建 PHP 环境时的首选集成工具，但它的 MySQL 配置并不总是最适合现代应用。默认情况下，XAMPP 中 MySQL 的 character_set_server 可能是 latin1，或者虽然是 utf8，但这个 utf8 并不是真正的完整 UTF-8。MySQL 里的 utf8 指的是 utf8mb3，每个字符最多使用 3 个字节，只能覆盖基本多文种平面，而像 emoji 表情这样的符号需要 4 字节编码，属于 utf8mb4 范畴。如果字符集没改对，用户提交一个笑脸表情到数据库，MySQL 会直接报出类似 Incorrect string value 的错误，本地开发环境就很难复现真实的线上数据。
要彻底解决这个问题，不能只在建表时临时指定 utf8mb4，而应该从 MySQL 服务器、连接层、已有表结构三个层面统一处理。下面会按照排查路径逐步展开，先弄清楚当前字符集到底哪里不对，再修改配置文件，最后转换历史数据，并给出完整的验证方法。
一、先理解 utf8 与 utf8mb4 的差异
MySQL 早期为了优化存储，把 UTF-8 限制为最多 3 字节，命名为 utf8，但它其实并不是标准 UTF-8。真正的标准 UTF-8 支持 1 到 4 字节的变长编码，MySQL 后来用 utf8mb4 表示。emoji 表情的 Unicode 码点大多在 U+1F300 到 U+1F600 之间，例如最常见的 😀 对应 U+1F600，UTF-8 编码为 F0 9F 98 80，正好需要 4 个字节。如果列字符集是 utf8，插入这串字节时就会失败，因为 utf8 只能识别到 3 字节序列。
很多人会误以为只要把表的排序规则改成 utf8mb4_general_ci 或者 utf8mb4_unicode_ci 就行，但如果服务器变量 character_set_server 仍然是 utf8，新建库表时默认字符集还是 utf8。同样，如果客户端连接没有声明 utf8mb4，就算表是 utf8mb4，PHP 通过连接发送的字节也可能被当成 utf8 处理，最终还是无法存储表情。这三个环节必须同时检查。
可以通过下面三条 SQL 快速查看当前 MySQL 的字符集状态：
SHOW VARIABLES LIKE 'character_set%'; SHOW VARIABLES LIKE 'collation%'; SHOW VARIABLES LIKE 'init_connect';
如果看到 character_set_server 的值是 latin1 或 utf8，character_set_client 和 character_set_connection 也不是 utf8mb4，就说明需要调整了。
二、修改 XAMPP 的 my.ini 配置文件
XAMPP 的 MySQL 配置文件通常位于安装目录下的 mysql\bin\my.ini，完整路径可能是 C:\xampp\mysql\bin\my.ini。在修改前先关闭 MySQL 服务，可以通过 XAMPP 控制面板停止 MySQL，或者在服务管理器里停止。用记事本或其他文本编辑器打开 my.ini，找到 [mysqld] 段，在里面添加或修改以下两行：
[mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci
如果文件中已经存在 character-set-server 和 collation-server 的配置项，直接修改等号右边的值即可；如果没有这两行，就手动加到 [mysqld] 下方。除了服务器端，客户端和命令行工具也需要声明 utf8mb4，否则通过 mysql 命令行连接时可能仍然使用默认值。可以继续在 [client] 和 [mysql] 段添加：
[client] default-character-set=utf8mb4 [mysql] default-character-set=utf8mb4
保存后重新启动 MySQL 服务。然后再次执行前面提到的 SHOW VARIABLES 查询，确认 character_set_server、character_set_database、character_set_client、character_set_connection、character_set_results 这些与连接相关的变量都已经变成 utf8mb4。需要留意的是，collation_server 选择 utf8mb4_unicode_ci 比 utf8mb4_general_ci 排序更精确，适合大多数场景。如果想减少存储空间，也可以使用 utf8mb4_0900_ai_ci，但这个排序规则需要 MySQL 8.0 及以上版本，XAMPP 部分旧版本可能不支持。
还有一个和旧版本相关的注意事项：在 MySQL 5.6 及更早版本中，启用 utf8mb4 后，如果表使用 Compact 行格式，VARCHAR 索引长度超过 767 字节会报错。解决办法是在 my.ini 里增加 innodb_large_prefix=1 和 innodb_file_format=Barracuda，或者直接把表改为 DYNAMIC 行格式。XAMPP 自带的 MySQL 版本通常较新，但如果遇到类似错误，可以检查这两项设置。
三、转换已有数据库和表为 utf8mb4
修改 my.ini 只会影响新建的数据库和表，之前已经创建的库表不会自动发生变化。如果项目里已经存在大量数据表，并且还想让它们支持表情符号，就需要对每个数据库、每张表甚至每个字段进行转换。最直接的方法是使用 ALTER 语句。
先把数据库的默认字符集改掉：
ALTER DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
然后把需要转换的表整体转为 utf8mb4，此操作会重建表并转换现有数据，如果表很大，执行时间会比较长，最好在低峰期操作，并且提前备份。语法如下：
ALTER TABLE mytable CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
如果只想修改某一列，可以使用 MODIFY 子句，例如：
ALTER TABLE mytable MODIFY content VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CONVERT TO 会同时更新数据和字符集，而单独修改列的 CHARACTER SET 只会改变元数据，不会转换已存在的字符串，容易产生乱码，所以对已有列最好使用 CONVERT。如果表之间存在外键约束，转换过程可能因为外键检查失败，可以先暂时关闭外键检查，转换完成后再打开：
SET FOREIGN_KEY_CHECKS = 0; ALTER TABLE mytable CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; SET FOREIGN_KEY_CHECKS = 1;
当一个数据库里的表很多时，逐个手写 ALTER 语句很麻烦，可以从 information_schema 中批量生成转换命令。下面这条 SQL 会输出针对某数据库中所有表的 ALTER 语句：
SELECT CONCAT('ALTER TABLE ', TABLE_SCHEMA, '.', TABLE_NAME, ' CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;')
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'mydb';
把查询结果复制出来执行即可。注意 CONCAT 函数中使用了单引号，不会和代码块要求产生冲突。批量转换前务必备份，并且做好锁表时间预估。
四、让应用层连接也使用 utf8mb4
即使服务器端和表结构都改成了 utf8mb4，如果应用代码连接数据库时仍然指定 utf8，插入 emoji 依然会失败。这是因为 MySQL 连接层会按照客户端声明的字符集来解析发送的字节。PHP 里使用 PDO 时，应该在 DSN 中加上 charset=utf8mb4，例如：
$dsn = 'mysql:host=localhost;dbname=mydb;charset=utf8mb4'; $pdo = new PDO($dsn, 'root', '');
如果使用 mysqli，可以在连接成功后调用 set_charset 方法：
$mysqli = new mysqli('localhost', 'root', '', 'mydb');
$mysqli->set_charset('utf8mb4');
代码块中的 -> 在页面显示时会变成箭头操作符，实际 PHP 源码里就是 ->。设置完连接字符集后，新建的会话会使用 utf8mb4 与服务器通信，而不会发生 4 字节字符被截断的情况。
为了验证整个链路，可以创建一个简单测试表，插入一条包含 emoji 的数据：
CREATE TABLE emoji_test (
id INT PRIMARY KEY AUTO_INCREMENT,
content VARCHAR(100)
) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
INSERT INTO emoji_test (content) VALUES ('你好 😀');
SELECT content, HEX(content) FROM emoji_test;
查询结果中 HEX 值应该以 F09F9880 结尾，这就是 😀 的 UTF-8 编码。如果插入时报错，或者查询结果出现问号或乱码，说明还有某一层字符集没有配置正确。继续用 SHOW VARIABLES LIKE 'character_set%' 检查连接相关变量，或者确认 PHP 驱动是否明确传入了 utf8mb4。很多现代 PHP 扩展已经不推荐使用 SET NAMES，而是用 set_charset 或 DSN 参数来设置。
通过以上步骤，XAMPP 中的 MySQL 就能完整支持表情符号存储。修改配置、转换历史表、调整应用连接，三部分缺一不可。以后新建的项目只要数据库默认字符集已经是 utf8mb4，建表时就不用刻意指定，也能直接写入包含 emoji 的文本。对于本地开发和线上环境一致性来说，这样的配置也减少了迁移时出现字符集问题的概率。