本文介绍如何通过 fetch({ force: true }) 强制绕过缓存，可靠判断目标消息是否真实存在于频道中，从而避免因缓存残留导致的误操作和运行时错误。
本文介绍如何通过 fetch({ force: true }) 强制绕过缓存，可靠判断目标消息是否真实存在于频道中，从而避免因缓存残留导致的误操作和运行时错误。
在 Discord.js 开发中，使用 channel.messages.fetch(snowflake) 获取消息时，一个常见且棘手的问题是：已删除的消息可能仍从内存缓存中返回一个看似有效的 Message 实例，导致后续 .edit()、.delete() 或 .react() 等操作失败并抛出 DiscordAPIError: Unknown Message (10008)。这种“假阳性”行为源于默认 fetch 行为会优先读取缓存（即使消息已在 Discord 服务端被删除），尤其在消息被删除而 bot 未重启期间尤为明显。
要真正验证消息是否存在（即是否“未被删除”），必须跳过客户端缓存，强制向 Discord API 发起一次新鲜请求。解决方案非常简洁：
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
try {
const message = await channel.messages.fetch({
message: snowflake,
force: true // ? 关键：禁用缓存，直连 API
});
console.log('✅ 消息存在且可操作');
// 此处安全执行 edit/delete/react 等操作
await message.edit('Updated content');
} catch (error) {
if (error.code === 10008) {
console.log('❌ 消息已被删除或不存在');
// 提前终止流程，避免后续错误
return;
}
throw error; // 其他错误（如权限不足、网络异常）应正常抛出
}⚠️ 重要注意事项：
- force: true 会忽略所有本地缓存，每次调用均触发 HTTP 请求，因此不建议高频轮询；仅在关键操作前做存在性校验即可；
- 不要依赖 .deleted（已废弃）或 .editable（不会随服务端状态实时更新）等属性；
- 即使启用了 cache: false（v14+ 的 MessageManager 选项），fetch() 默认仍可能返回缓存对象；force: true 是唯一可靠的绕过方式；
- 若需批量校验多条消息，可使用 fetch({ limit: n, before/after: snowflake }) 结合分页，但单条校验务必用 force: true + message ID。
总结：channel.messages.fetch({ message: id, force: true }) 是当前 Discord.js（v13/v14）中检测消息是否被删除的最直接、最可靠的方法。它将校验逻辑前置到获取阶段，避免了在每个副作用操作（如编辑、删除）上重复 try/catch，显著提升代码健壮性与可维护性。
