Windows终端下MariaDB UTF-8字符输入异常问题求助

问题分析 #

• Windows终端默认采用cp850编码，插入ñ时会被转译为\xA2（cp850编码对应的字符），而非UTF-8标准的C3B1
• 开启系统「Beta: UTF8...」选项后，终端与MariaDB客户端的字符集解析逻辑冲突，输入带特殊字符的SQL语句时，MariaDB会误判输入不完整（出现>等待提示符），执行后返回空行

解决方案 #

1. 单独调整Windows终端编码为UTF-8（无需开启系统Beta选项） #

临时生效

在Command Prompt中执行命令：

chcp 65001

永久生效

• 打开Windows Terminal，进入Command Prompt的设置界面
• 在「高级」选项中，将「代码页」设置为65001（UTF-8）

2. 强制MariaDB客户端使用UTF-8连接 #

临时连接时指定字符集

启动MariaDB客户端时添加参数：

mysql --default-character-set=utf8mb4 -u root -p

永久配置客户端字符集

找到XAMPP中MariaDB的配置文件my.ini（通常位于xampp/mysql/bin目录下），修改以下段落：

[client]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci

修改完成后重启XAMPP的MariaDB服务。

3. 验证配置有效性 #

连接MariaDB后执行以下查询：

SELECT HEX('ñ');

若返回C3B1，说明客户端与服务器端字符集已正确匹配；执行SELECT 'ñ';应正常显示ñ字符。

不推荐开启系统Beta UTF-8选项的原因 #

该选项会全局强制Windows使用UTF-8，但部分程序（包括部分版本的MariaDB客户端）对这种全局UTF-8的兼容性不佳，容易出现输入解析错误（如不完整SQL提示符、空输出等），单独调整终端和MariaDB的字符集配置更稳定可靠。

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