discord.js嵌入MySQL数据时报EMBED_FIELD_VALUE错误如何解决？

RangeError [EMBED_FIELD_VALUE]报错的根本原因是Discord.js要求MessageEmbed的所有字段value必须为非空字符串，你传入的MySQL查询结果中存在null/undefined/非字符串类型值，触发了校验规则。

1. 先正确处理MySQL查询返回结果 #

MySQL查询返回的results是RowDataPacket类型的数组，即使只查询一条数据也需要先取下标为0的对象，避免直接传入数组触发错误：

// 你的查询逻辑示例
connection.query('SELECT * FROM player_count LIMIT 1', (error, results) => {
  if (error) throw error;
  // 取第一条查询结果，空结果兜底为空对象
  const countData = results[0] ?? {};
  // 后续构造Embed的逻辑写在这里
})

2. 构造Embed时所有字段值做类型转换+空值兜底 #

每个字段的value都用String()强制转为字符串，同时用空值合并运算符??给空值设置兜底内容：

const { MessageEmbed } = require('discord.js');

const countEmbed = new MessageEmbed()
  .setTitle('服务器玩家统计')
  .setColor('#2ecc71')
  .addFields(
    {
      name: '当前在线',
      // 示例字段online，空值默认显示0
      value: String(countData.online ?? 0)
    },
    {
      name: '今日峰值',
      // 示例字段peak，空值默认显示暂无统计
      value: String(countData.peak ?? '暂无统计')
    },
    {
      name: '累计注册',
      // 示例字段total，空值默认显示暂无数据
      value: String(countData.total ?? '暂无数据')
    }
  )

// 发送嵌入消息
message.channel.send({ embeds: [countEmbed] });

如果修改后仍报错，可以在构造Embed前打印所有要传入的字段值和类型，快速定位非法值：

console.log('在线字段：', typeof countData.online, countData.online)
console.log('峰值字段：', typeof countData.peak, countData.peak)
console.log('累计字段：', typeof countData.total, countData.total)

内容的提问来源于stack exchange，提问作者I need Help