MySQL 8.0.4(rc4)向LONGBLOB字段插入字节报UTF-8编码错误求助

嘿，我来帮你搞定这个问题——你遇到的Error 1366其实是个很容易踩的小坑，虽然你把Body字段设成了LONGBLOB（专门存二进制数据的类型），但肯定是插入方式或者连接设置出了问题，导致MySQL误把字节数据当成字符串来校验了。下面是具体的排查和解决步骤：

一、先排查插入语句的写法 #

如果你是直接把\x8B\x08\x00\x00...这类转义字符当成字符串写在INSERT语句里，MySQL会默认把它当成utf8mb4字符串去解析，但这些原始字节根本不符合utf8mb4的编码规则，自然就抛出1366错误了。正确的插入方式有两种：

• 用十六进制字面量插入（最可靠）：把二进制数据转换成十六进制，用0x前缀表示。比如：

  INSERT INTO MyTable (Body) VALUES (0x8B080000...); -- 把所有字节的十六进制值直接拼接在这里
  

  这种方式MySQL会直接识别为二进制数据，不会做任何编码解析。

• 用二进制字面量插入：用b'...'包裹转义后的字节，比如：

  INSERT INTO MyTable (Body) VALUES (b'\x8B\x08\x00\x00...');
  

  注意：有些客户端对b''格式的转义字符处理可能有差异，优先推荐上面的十六进制写法。

• 用参数化查询（强烈推荐）：如果你是用编程语言（Python、Java等）插入数据，绝对不要把二进制数据直接拼接到SQL语句里，用参数绑定的方式让驱动自动处理。比如Python的pymysql示例：

  import pymysql
  # 建立连接时指定字符集（这里utf8mb4不影响二进制字段）
  conn = pymysql.connect(host='localhost', user='your_user', password='your_pwd', db='TestDB', charset='utf8mb4')
  cursor = conn.cursor()
  # 原始二进制数据
  binary_data = b'\x8B\x08\x00\x00...'
  # 用%s作为占位符，传递二进制参数
  cursor.execute("INSERT INTO MyTable (Body) VALUES (%s)", (binary_data,))
  conn.commit()
  

  这种方式完全避免了手动拼接数据带来的编码问题，是最安全的做法。

二、检查数据库连接的字符集设置 #

即使字段是LONGBLOB，如果你的连接字符集设置为utf8mb4，有些客户端可能会在传递数据时误把二进制数据转成字符串。你可以先执行这条语句查看当前连接的字符集：

SHOW VARIABLES LIKE 'character_set_connection';

如果结果是utf8mb4，可以临时切换成binary字符集再尝试插入：

SET character_set_connection = 'binary';
INSERT INTO MyTable (Body) VALUES (0x8B080000...);

如果插入成功，说明是连接字符集导致的干扰。你可以在建立连接时直接指定binary字符集（如果你的业务主要处理二进制数据），或者确保驱动在传递LONGBLOB字段时跳过编码转换。

三、确认sql_mode的影响 #

你设置了sql_mode = 'STRICT_TRANS_TABLES'，这个模式会让MySQL对数据错误更严格，但它不是导致1366的直接原因——因为LONGBLOB本来就不应该做字符串校验。不过你可以临时关闭严格模式测试一下，排除干扰：

SET sql_mode = '';
INSERT INTO MyTable (Body) VALUES (...);

如果插入成功，说明严格模式放大了这个错误，但本质还是插入方式的问题，不建议长期关闭严格模式，还是用前面的正确插入方法解决根源问题。

总结一下：核心就是让MySQL把数据当成二进制处理，而不是字符串。只要用对插入方式，这个1366错误就能轻松解决啦！

内容的提问来源于stack exchange，提问作者Dean M.