如何通过类型转换消除NodeJS+mysql2的JSON列编码警告？

问题原因 #

你遇到的警告源于mysql2的field.string()方法已废弃直接传入编码参数的用法，旧传参方式会触发警告提示。

解决方案 #

方案1：移除编码参数，配置连接字符集 #

1. 在mysql2连接配置中明确指定字符集为utf8mb4（覆盖更全面的字符场景，推荐使用）：

const connection = mysql.createConnection({
  host: '你的数据库地址',
  user: '用户名',
  password: '密码',
  database: '数据库名',
  charset: 'utf8mb4' // 关键配置，确保字符集一致
});

2. 修改typeCast函数，去掉field.string()的编码参数：

typeCast: function (field, next) {
  if (field.type === 'JSON') {
    let c = field.string(); // 不再传递"utf8"参数
    if (c && c.toLowerCase() !== "[null]") {
      return JSON.parse(c);
    } else {
      return [];
    }
  }
  return next();
}

方案2：使用内置JSON解析方法 #

如果无需复杂自定义逻辑，可直接用mysql2内置的field.toJSON()方法处理，更符合当前版本的规范：

typeCast: function (field, next) {
  if (field.type === 'JSON') {
    const jsonValue = field.toJSON();
    return jsonValue === null ? [] : jsonValue;
  }
  return next();
}

上述两种方法都能彻底消除警告，同时保证JSON列的正确解析。

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