Discord Node.js对接MySQL插入4字节字符UTF8编码报错问题求解

核心原因 #

你遇到的报错和Discord.js本身无关，问题出在两个配置层面：

• Node.js与MySQL的连接未显式指定utf8mb4编码，即使库、表、字段都配置了utf8mb4，连接层默认使用的utf8（仅支持3字节UTF8字符）会导致4字节字符被识别为非法字符，触发截断报错
• 手动拼接SQL字符串的方式既存在SQL注入风险，也可能在字符转义过程中破坏4字节UTF8字符的编码

你之前可以在MySQL Workbench中正常执行SQL，就是因为Workbench的数据库连接默认已经启用了utf8mb4编码，没有连接层的编码问题。你注释的Buffer相关转换操作不需要使用，Discord.js返回的message.channel.name本身就是标准UTF8编码的字符串，不需要额外处理。

具体修复步骤 #

1. 修正MySQL连接配置 #

创建数据库连接时，显式指定charset为utf8mb4，参考配置：

const mysql = require('mysql');
const connection = mysql.createConnection({
  host: '你的数据库Host',
  user: '你的数据库用户名',
  password: '你的数据库密码',
  database: '你的库名',
  charset: 'utf8mb4' // 必须添加该配置，注意取值为全小写
});

2. 替换手动拼接SQL为参数化查询 #

使用mysql驱动原生支持的占位符能力处理参数，驱动会自动完成字符转义、编码适配，修改后的业务代码如下：

const tempBuf = message.channel.name;
// 使用?作为参数占位符
const sql = `INSERT INTO serverdata (channel_name, isChannelActive) VALUES (?, ?) ON DUPLICATE KEY UPDATE channel_name=?, isChannelActive = ?`;
// 按占位符顺序传入参数数组
connection.query(sql, [tempBuf, onOrOff, tempBuf, onOrOff], function (err) { 
  if (err) throw err 
});

完成上述两处修改后，带4字节字符的频道名称就可以正常插入数据库。

内容的提问来源于stack exchange，提问作者G-Force