使用SnowTransfer发送Discord DM时出现TypeError问题求助

问题描述 #

使用SnowTransfer Discord客户端通过机器人发送消息时，大部分场景运行正常，但给某特定用户发送DM时触发以下错误，导致生产环境应用崩溃：

[ERROR] Error when sending Discord DM: TypeError: Cannot read properties of undefined (reading 'id')

无法复现该问题，需要明确错误原因并给出避免方案，相关代码片段如下：

export async function sendDiscordDM(userId: string, message: string) {
  const client = new SnowTransfer(process.env.DISCORD_BOT_TOKEN);
  try {
    const dm = await client.user.createDirectMessageChannel(userId);
    await client.channel.createMessage(dm.id, { content: message });
  } catch (err) {
    console.error(`Error when sending Discord DM: ${err}`);
  }
}

错误原因分析 #

1. 用户侧限制：该用户可能已屏蔽机器人，或隐私设置禁止接收机器人/陌生人DM。部分情况下Discord API不会抛出明确错误，而是返回空值或不完整的通道对象，导致dm为undefined。
2. 用户账号状态异常：用户账号处于离线且隐私限制严格、账号被临时封禁/限制等状态，创建DM通道失败但未触发catch块的错误捕获。
3. SnowTransfer客户端异常：边缘场景下，SnowTransfer对API响应的解析可能出现问题，返回undefined而非抛出错误，绕过try/catch直接执行后续代码。
4. 重复初始化客户端：每次调用函数都新建SnowTransfer实例，可能导致请求并发冲突或客户端初始化不完整，偶尔出现响应异常。

解决方案 #

1. 增加空值校验 #

在访问dm.id前强制校验通道对象的有效性，避免直接访问属性导致崩溃：

export async function sendDiscordDM(userId: string, message: string) {
  const client = new SnowTransfer(process.env.DISCORD_BOT_TOKEN);
  try {
    const dm = await client.user.createDirectMessageChannel(userId);
    // 新增空值校验，主动抛出错误进入catch块
    if (!dm?.id) {
      throw new Error(`Failed to create DM channel for user ${userId}: no valid channel ID returned`);
    }
    await client.channel.createMessage(dm.id, { content: message });
  } catch (err) {
    console.error(`Error sending Discord DM to user ${userId}: ${err.stack || err}`);
    // 可选：添加错误上报、告警等降级处理逻辑
  }
}

2. 复用SnowTransfer客户端实例 #

避免每次调用都初始化新客户端，改为全局单例模式，减少初始化异常风险：

// 全局初始化一次客户端
const discordClient = new SnowTransfer(process.env.DISCORD_BOT_TOKEN);

export async function sendDiscordDM(userId: string, message: string) {
  try {
    const dm = await discordClient.user.createDirectMessageChannel(userId);
    if (!dm?.id) {
      throw new Error(`Failed to create DM channel for user ${userId}: no valid channel ID returned`);
    }
    await discordClient.channel.createMessage(dm.id, { content: message });
  } catch (err) {
    console.error(`Error sending Discord DM to user ${userId}: ${err.stack || err}`);
  }
}

3. 完善错误日志 #

在catch块中记录用户ID、错误栈等关键信息，便于后续排查特定用户的问题：

console.error(`Error sending DM to user ${userId}:`, err);
// 或保留完整错误栈
console.error(`Error sending DM to user ${userId}: ${err.stack || err}`);

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