
本文详解如何使用 Discord.js 的 AttachmentBuilder 正确发送 JavaScript 对象序列化后的 JSON 文件,重点解决因传入字符串而非 Buffer 导致的 TypeError 错误。
本文详解如何使用 discord.js 的 `attachmentbuilder` 正确发送 javascript 对象序列化后的 json 文件,重点解决因传入字符串而非 buffer 导致的 `typeerror` 错误。
在 Discord.js(v14+)中,AttachmentBuilder 并不直接接受原始字符串(如 JSON.stringify(data) 的返回值)作为文件内容——它要求传入的是可读的二进制数据载体,即 Buffer、ReadableStream 或 Uint8Array。若直接传入字符串,内部 DataResolver 尝试调用 Symbol.asyncIterator 时会失败,从而抛出你遇到的错误:
TypeError: Cannot read properties of undefined (reading 'Symbol(Symbol.asyncIterator)')
✅ 正确做法是:先将 JSON 数据序列化为字符串,再用 Buffer.from() 将其转换为 Node.js 缓冲区,最后交由 AttachmentBuilder 构建附件。
以下是完整、可直接使用的示例代码:
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
const { AttachmentBuilder } = require('discord.js');
// 假设这是你要发送的数据对象
const data = {
timestamp: Date.now(),
guildId: message.guild?.id,
memberCount: message.guild?.memberCount || 0,
settings: { theme: 'dark', notifications: true }
};
const embedName = 'server-export';
// ✅ 关键:必须用 Buffer.from() 包装 JSON 字符串
const jsonFile = new AttachmentBuilder(
Buffer.from(JSON.stringify(data, null, 2)), // 使用缩进提升可读性
{
name: `${embedName}.json`
}
);
// 发送带附件的回复
await message.reply({
content: '? 数据已导出为 JSON 文件:',
files: [jsonFile]
});
⚠️ 注意事项:
-
不要省略
Buffer.from():AttachmentBuilder不支持直接传入字符串或普通对象; -
推荐使用
JSON.stringify(data, null, 2):添加缩进和换行,便于人工查看 JSON 内容; -
文件名需含
.json后缀:确保 Discord 正确识别并高亮语法(部分客户端支持预览); - 注意数据大小限制:Discord 单文件上限通常为 25 MB(免费用户),超大对象请考虑分片或压缩;
- 若在交互响应(如
StringSelectMenuInteraction)中使用,请确保调用deferReply()后再editReply(),或直接使用reply()(首次响应)。
总结:发送 JSON 文件的本质,是将结构化数据安全地序列化 → 二进制化 → 封装为附件。只要牢记 Buffer.from() 是必经桥梁,即可避免绝大多数文件构建类错误。










