
在 discord.js 中,直接传递字符串给 AttachmentBuilder 会报错;正确做法是先将 JSON 数据转为 Buffer,再构建附件,才能成功发送 .json 文件。
在 discord.js 中,直接传递字符串给 `attachmentbuilder` 会报错;正确做法是先将 json 数据转为 buffer,再构建附件,才能成功发送 `.json` 文件。
AttachmentBuilder 要求传入的首个参数必须是一个可读的二进制数据源(如 Buffer、ReadableStream 或 ArrayBuffer),而 JSON.stringify(data) 返回的是字符串(string 类型),不满足底层 DataResolver 对可迭代二进制数据的要求——这正是你遇到 TypeError: Cannot read properties of undefined (reading 'Symbol(Symbol.asyncIterator)') 的根本原因。
✅ 正确做法是使用 Buffer.from() 将序列化后的 JSON 字符串显式转换为 Node.js Buffer:
const { AttachmentBuilder } = require('discord.js');
// 假设 data 是你要发送的 JavaScript 对象
const data = { timestamp: Date.now(), users: ['Alice', 'Bob'], version: '1.2.0' };
const embedName = 'user-export';
const jsonFile = new AttachmentBuilder(
Buffer.from(JSON.stringify(data, null, 2)), // 格式化输出,提升可读性
{ name: `${embedName}.json` }
);
await message.reply({
content: '✅ 数据已导出:',
files: [jsonFile]
});
⚠️ 注意事项:
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
-
避免遗漏
Buffer.from():仅传JSON.stringify(data)会导致类型不匹配,引发DataResolver解析失败; -
推荐使用缩进格式:
JSON.stringify(data, null, 2)生成带缩进的 JSON,便于人工查看; -
文件名需含
.json后缀:确保 Discord 客户端正确识别并支持预览(部分客户端对无后缀或错误后缀的文件不显示内容); -
注意数据大小限制:Discord 单文件上限为 25 MB(免费用户),若
data过大,建议压缩或分片,或改用外部存储链接。
总结:AttachmentBuilder 不接受原始字符串,必须通过 Buffer.from() 构建二进制载荷。这一模式同样适用于发送 .txt、.csv、.log 等文本类文件——核心原则始终是「先序列化,再转 Buffer,最后命名封装」。










