
在 discord.js 中,直接传递字符串给 AttachmentBuilder 会报错;正确做法是先将 JSON 对象序列化为字符串,再用 Buffer.from() 转为缓冲区,方可成功作为 .json 文件发送。
在 discord.js 中,直接传递字符串给 `attachmentbuilder` 会报错;正确做法是先将 json 对象序列化为字符串,再用 `buffer.from()` 转为缓冲区,方可成功作为 `.json` 文件发送。
AttachmentBuilder 并不接受原始字符串作为文件内容——它要求传入的是可读的二进制数据源(如 Buffer、ReadableStream 或本地文件路径)。当你传入 JSON.stringify(data) 返回的字符串时,内部 DataResolver 尝试调用其异步迭代器(Symbol.asyncIterator),而普通字符串不具备该属性,从而触发 TypeError: Cannot read properties of undefined (reading 'Symbol(Symbol.asyncIterator)')。
✅ 正确做法是:将序列化后的 JSON 字符串显式转换为 Buffer:
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
const { AttachmentBuilder } = require('discord.js');
// 假设 data 是你要发送的 JS 对象
const data = { timestamp: Date.now(), userCount: 128, status: "online" };
const embedName = "server-stats";
const jsonFile = new AttachmentBuilder(
Buffer.from(JSON.stringify(data, null, 2)), // 格式化输出,提升可读性
{ name: `${embedName}.json` }
);
await message.reply({
content: "? 数据已导出:",
files: [jsonFile]
});⚠️ 注意事项:
-
务必使用
Buffer.from():这是 Node.js 提供的标准方式,确保数据以二进制形式被正确识别; -
推荐
JSON.stringify(data, null, 2):添加缩进便于人工查看,不影响解析; -
文件名必须带
.json后缀:否则 Discord 可能无法正确识别 MIME 类型或预览内容; - 若
data包含不可序列化字段(如undefined、函数、循环引用),需提前清洗或使用自定义 replacer 函数,避免JSON.stringify()报错; - 在生产环境中,建议对数据大小做限制(例如
),避免超出 Discord 文件上传限制。
总结:发送 JSON 文件 ≠ 发送字符串,而是发送「序列化后字节流」。Buffer.from(JSON.stringify(obj)) 是连接 JavaScript 对象与 Discord 文件附件的关键桥梁。

















