Discord Webhook 测试工具

几秒钟测试你的 Discord Webhook。粘贴 URL、验证它，再发送一条测试消息，确认一切正常。

什么是 Discord Webhook？

Discord Webhook 是一个唯一的 URL，让你不用机器人也能向特定的 Discord 频道发送消息。Webhook 常用于 GitHub 通知、服务器监控告警、CI/CD 流水线更新以及自定义集成。每个 Webhook 都有自己的名称和头像，并绑定到一个特定频道。

如何创建 Discord Webhook

1. 打开你的 Discord 服务器，进入服务器设置
2. 依次进入整合 > Webhook
3. 点击新建 Webhook
4. 设置名称并选择目标频道
5. 点击复制 Webhook URL
6. 把 URL 粘贴到上面的测试工具里，确认它能用

这个测试工具如何工作

粘贴你的 Webhook URL，然后点击「检查」。工具会向 Discord API 验证该 URL，并显示 Webhook 的名称、头像和绑定的频道。如果有效，你可以输入自定义消息并通过 Webhook 发送出去，确认它能正常工作。出于安全考虑，你的 Webhook URL 会经过我们的服务器转发（浏览器因为 CORS 无法直接调用 Discord API），但绝不会被保存或记录。

常见的 Discord Webhook 错误码

当 Webhook 请求失败时，Discord 会返回一个 HTTP 状态码，响应体是包含数字 code 和 message 的 JSON。你真正会遇到的是这几种：

• 400 Bad Request - JSON 请求体格式错误、嵌入内容总长超过 6,000 字符，或某个字段超出长度上限。发送前先在本地校验你的负载。
• 401 Unauthorized - Webhook 令牌不对或已被重新生成。在服务器设置里重新生成 Webhook 会立即让旧 URL 失效。
• 404 Not Found - Webhook 被删除、频道被删除，或者 URL 里有拼写错误。请从「服务器设置 > 整合」重新复制一次 URL。
• 429 Too Many Requests - 你触发了速率限制。Discord 会返回一个 retry_after 字段（单位为秒），告诉你何时重试。请遵守它。
• Code 50027 (Invalid Webhook Token) - 与 401 根因相同，当 URL 中的令牌部分损坏或被截断时返回。
• Code 50006 (Cannot send empty message) - 你的负载里既没有 content，也没有 embeds 和 files。至少需要其中一个。
• Code 50035 (Invalid Form Body) - 最常见的原因是把 embed.color 当作十六进制字符串发送，而不是十进制整数。发送前把 #9B59B6 转换成 10181046。

Discord Webhook 的速率限制

Discord 会按 Webhook 和按频道施加速率限制，而具体的桶大小由服务端决定并通过响应头给出，并不是一个固定数值。每个成功的响应都会包含 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset-After - 读取这些值来安排下一次请求，不要把固定速率写死在代码里。429 响应体里还会带上 retry_after 值（单位为秒）。对于高并发的集成（构建流水线、日志聚合），把多个事件合并到一条消息里：一次 Webhook 调用最多可以携带 10 个嵌入内容，每个嵌入内容合计最多 6,000 字符，通常足以把一波事件收敛成一次请求。

Webhook 安全最佳实践

Webhook URL 是一种持有即可用的凭证。任何拿到完整 URL 的人，都能以 Webhook 机器人的身份向你的频道发消息，不需要任何额外认证。请把它当作密码来对待：

• 绝不要把 Webhook URL 提交到公开的 Git 仓库。GitHub 的密钥扫描会自动检测并吊销泄露的 Discord Webhook，但那也是在它已经暴露之后。
• 把 Webhook URL 存放在环境变量或密钥管理器里，不要放进源代码或纳入版本控制的配置文件。
• 如果 Webhook 泄露了，请立刻在服务器设置 > 整合 > Webhook 中删除它。重新创建会生成新的令牌，旧 URL 随即失效。
• 如果要在客户端使用（浏览器应用向 Discord 发消息），请通过你自己的后端来转发调用，让 URL 永远不会到达用户的浏览器。从浏览器应用泄露出去的 URL 是破坏行为的磁石。
• 除非 allowed_mentions 明确允许，否则 Discord Webhook 会忽略 @everyone 和 @here 提及。如果你不需要提及提醒，把 "parse": [] 设上即可全部关闭。

用 curl 手动测试 Webhook

如果你更习惯从终端测试，最小的负载就是一个 content 字段。POST 成功会返回 HTTP 204 和空响应体；如果在 URL 后面加上 ?wait=true，则返回 HTTP 200 和新建消息的 JSON。当你需要拿回消息 ID 时就用 ?wait=true（例如之后要通过 /webhooks/<id>/<token>/messages/<message_id> 接口编辑或删除这条消息）。

更多免费 Discord 工具

• Snowflake Checker - 查看任意 Discord 账号的注册时间
• Colored Text Generator - 用 ANSI 代码制作彩色消息
• Message Length Counter - 检查消息是否符合 Discord 的长度限制
• Color Role Previewer - 在所有 Discord 主题下预览身份组颜色

由 Pigona 提供支持 - 为 Discord 打造的免费翻译