MariaDB查询通过PHP执行失败但HeidiSQL正常，utf8mb4配置下的en dash编码问题

问题原因分析 #

1. 为什么HeidiSQL执行正常，PHP执行报错

HeidiSQL连接MariaDB时默认会自动配置utf8mb4连接字符集，你手动输入的SQL语句中的字符本身就是正确的UTF-8编码，因此可以正常执行。
PHP侧报错的核心原因有两个：

• 字符串编码转换逻辑错误，导致最终传入SQL的en dash字符没有被转为正确的UTF-8编码，仍然是Windows-1252编码的\x96字节，不符合数据库字段的UTF-8编码要求
• 你大概率没有在PHP的数据库连接中明确指定utf8mb4字符集，即使字符串本身编码正确，数据库也会默认按latin1编码解析PHP传入的内容，触发字符集不兼容报错

2. 你的解码操作存在两处明显错误

• 直接拆分邮件头后做编码转换的逻辑不符合邮件协议规范：邮件头遵循MIME编码规则，存在类似=?编码?传输编码?内容?=的封装格式，不能直接拆分后转码，必须先做MIME头解码
• mb_detect_encoding默认的自动检测准确率极低，对Windows-1252、ISO-8859-1这类单字节编码的识别误判率极高，会直接导致mb_convert_encoding输出错误的编码结果

修复方案 #

1. 优先使用PHP内置函数处理MIME邮件头解码，替换你现有的转码逻辑：

$p = explode(': ', $header, 2);
// 先解码MIME格式的邮件头，自动识别内置编码
$decoded = mb_decode_mimeheader(trim($p[1]));

2. 如果你确实需要手动做编码转换，给mb_detect_encoding增加严格检测参数和编码候选列表，提升识别准确率：

$encoding = mb_detect_encoding($p[1], ['UTF-8', 'Windows-1252', 'ISO-8859-1'], true);
$s = mb_convert_encoding(trim($p[1]), 'UTF-8', $encoding);

3. 务必明确配置PHP数据库连接的字符集为utf8mb4：
   • 用PDO的话，DSN拼接charset=utf8mb4参数：mysql:host=xxx;dbname=xxx;charset=utf8mb4
   • 用mysqli的话，连接成功后执行$mysqli->set_charset('utf8mb4')

你之前尝试的iconv('utf-8', 'windows-1252', $s)逻辑完全写反了，你需要的是将Windows-1252编码的内容转为UTF-8，而非反向转换，因此无效。

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