node-slack-sdk教程运行报错：TypeError: Cannot set property 'text' of undefined

云原生阿岚

2026-5-20

解决Node Slack SDK中IncomingWebhook的Cannot set property 'text' of undefined错误

这个错误我之前也碰到过，核心问题是新版@slack/webhook包的API和你参考的旧教程写法不兼容。

问题根源

你提到的IncomingWebhook构造函数参数问题，是因为新版包（6.x+）已经把参数结构改成了单一配置对象，而旧教程可能还在沿用老版本（5.x及以下）的「URL + 可选defaults参数」的写法。如果强行按旧教程的方式传参，会导致内部的payload变量初始化失败，自然就会抛出Cannot set property 'text' of undefined的异常。

针对性解决方案

根据你安装的包版本，选择对应的写法：

情况1：使用新版`@slack/webhook`（6.x+）

初始化IncomingWebhook时，必须传入一个包含url和可选defaults的配置对象：

const { IncomingWebhook } = require('@slack/webhook');

// 正确的初始化方式
const webhook = new IncomingWebhook({
  url: '你的Slack Webhook URL',
  defaults: {
    text: '这是默认消息文本（可选）'
  }
});

// 发送消息的示例
(async () => {
  try {
    await webhook.send({
      text: '你要发送的具体消息内容'
    });
    console.log('消息发送成功');
  } catch (error) {
    console.error('发送失败:', error);
  }
})();

情况2：坚持使用旧版本（5.x及以下）

如果你特意安装了旧版本包，就可以沿用教程里的双参数写法：

const { IncomingWebhook } = require('@slack/webhook');

// 旧版本专属写法
const webhook = new IncomingWebhook('你的Slack Webhook URL', {
  defaults: {
    text: '默认消息文本'
  }
});

// 发送消息逻辑和新版一致
(async () => {
  await webhook.send({ text: '测试消息' });
})();