本文介绍如何通过并行请求替代串行循环，将 discord.js 批量获取 30+ 用户信息的耗时从十几秒降至 1–2 秒，同时优雅处理已离服用户的 id 回退逻辑。
本文介绍如何通过并行请求替代串行循环，将 discord.js 批量获取 30+ 用户信息的耗时从十几秒降至 1–2 秒，同时优雅处理已离服用户的 id 回退逻辑。
在使用 discord.js 开发排行榜、用户统计或成员管理功能时，若需根据用户 ID 列表批量获取用户名（如 member.user.username），直接用 for 循环 + await 逐个 fetch() 是性能瓶颈的根源——它强制串行执行，每个请求必须等待前一个完成，而 Discord API 对离服用户的响应延迟更高（常达 500ms–1s），15 个 ID 耗时 7–9 秒、30 个达 16 秒完全符合预期。
✅ 正确做法是：并发发起所有请求，统一等待结果。核心方案是 Promise.all() —— 它接收一个 Promise 数组，同时触发全部请求，并在所有请求（无论成功或失败）结束后返回结果数组（保持原始顺序）。
以下是优化后的完整实现：
const memberGroup = [
"801555002664419350", "801555002664419351", "801555002664419352",
// ... 共 30 个 ID
];
// 1. 构建 Promise 数组（不 await！）
const fetchPromises = memberGroup.map(id =>
message.guild.members.fetch({ user: id }).catch(() => null) // 失败时返回 null，便于后续处理
);
// 2. 并发执行并等待全部完成
const fetchedMembers = await Promise.all(fetchPromises);
// 3. 映射为所需格式：存在则取 username，不存在则回退为 ID
const leaderboardEntries = fetchedMembers.map((member, index) => {
if (member) return member.user.username;
return memberGroup[index]; // 离服/无效用户，直接显示原始 ID
});
// 4. 格式化输出（示例）
const leaderboardText = [
"**Leaderboard:**",
...leaderboardEntries.map((name, i) => `${i + 1}. ${name}`)
].join("\n");
await message.reply(leaderboardText);? 关键优化点说明：
- 并发而非串行：15 个请求理论上仅需最长单次请求时间（通常 < 1.5s），而非累加时间；
- 错误统一处理：.catch(() => null) 避免个别失败中断整个流程，且 null 值可清晰标识离服用户；
- 顺序严格保证：Promise.all() 返回数组索引与输入 Promise 数组一一对应，确保 ID 与结果对齐；
- 零依赖开销：无需额外库或缓存层，纯原生 JS + discord.js 实现。
⚠️ 注意事项：
- Discord API 有速率限制（默认 50 请求/秒），但 Promise.all() 的并发请求仍受 guild.members.fetch() 内部队列控制，实际不会触发限频；若极端场景（如 >100 ID），建议分批（每批 20–30）+ await delay(1000) 避免风险；
- fetch({ user: id }) 仅适用于当前服务器内成员；若需跨服务器或全局用户信息（如头像、全局昵称），应改用 client.users.fetch(id)，但该方法不校验是否在本服，需自行比对 guild.members.cache.has(id)；
- 生产环境建议添加超时保护：可封装 fetchWithTimeout()，避免某请求挂起阻塞整体。
通过此方案，30 个用户 ID 的批量解析稳定控制在 1–2 秒内完成，且代码简洁、健壮、符合现代异步最佳实践。
