Discord.js嵌入消息异步问题：无法读取undefined的属性'0'

你遇到的Error executing stats TypeError: Cannot read properties of undefined (reading '0')，核心原因是异步查询的结果还未返回，你就尝试在其作用域外访问变量，导致构建Embed时目标变量仍为undefined，进而触发数组索引访问错误。

常见错误代码示例（模拟你的写法） #

通常这类问题出现在把Embed构建逻辑放在异步then链之外：

// 错误写法：Embed在then链外，无法获取异步查询结果
let userStats;
UserModel.findOne({ userId: interaction.user.id }).then(doc => {
  userStats = doc.someArray;
});

// 此时userStats仍为undefined，访问[0]必然报错
const embed = new EmbedBuilder()
  .setTitle("用户统计")
  .addFields({ name: "第一项", value: userStats[0].toString() });

方案1：用async/await替代then链（推荐，可读性更强） #

将命令处理函数标记为async，用await等待Mongoose查询完成，确保变量赋值后再构建Embed：

async function handleStatsCommand(interaction) {
  try {
    // 等待查询完成，拿到完整的文档数据
    const userDoc = await UserModel.findOne({ userId: interaction.user.id });

    // 提前处理边界情况
    if (!userDoc) {
      return interaction.reply("未找到你的统计数据");
    }
    if (!userDoc.someArray || userDoc.someArray.length === 0) {
      return interaction.reply("暂无统计数据");
    }

    // 此时可以安全访问数组元素，构建Embed
    const embed = new EmbedBuilder()
      .setTitle("用户统计")
      .addFields({ name: "第一项", value: userDoc.someArray[0].toString() });

    await interaction.reply({ embeds: [embed] });
  } catch (error) {
    console.error("Error executing stats:", error);
    await interaction.reply("获取统计数据时出错");
  }
}

方案2：保留then链的正确写法 #

如果一定要用then链，必须把所有依赖异步结果的逻辑（包括Embed构建、交互回复）放在then的回调内部：

UserModel.findOne({ userId: interaction.user.id })
  .then(userDoc => {
    if (!userDoc || !userDoc.someArray || userDoc.someArray.length === 0) {
      return interaction.reply("暂无统计数据");
    }

    const embed = new EmbedBuilder()
      .setTitle("用户统计")
      .addFields({ name: "第一项", value: userDoc.someArray[0].toString() });

    return interaction.reply({ embeds: [embed] });
  })
  .catch(error => {
    console.error("Error executing stats:", error);
    interaction.reply("获取统计数据时出错");
  });

关键注意点 #

1. 所有需要使用异步查询结果的代码，必须等待异步操作完成后再执行；
2. 提前处理null/undefined和空数组的情况，避免后续索引访问报错；
3. 用try/catch（或catch链）捕获异步操作中的异常，防止程序崩溃并给用户友好提示。

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