企业微信提示 Webhook 域名主体校验未通过？先核对地址是否完整

配企业微信接入，填完 Webhook 地址提交，企业微信那边弹回来一句：域名主体校验未通过。

先搞清楚一件事：这个校验是企业微信侧做的，不是 WorkBuddy 做的。 官方常见问题页的说明就是这么写的：

企业微信侧会对 Webhook 地址进行域名主体校验。

官方给的做法：

核对 Webhook 地址是否完整、是否与当前配置要求一致；若仍无法通过，保留报错截图提交排查。

这个定位很重要——它决定了你该去哪一侧找问题。

本文依据 WorkBuddy 官方常见问题页 From-Beginner-to-Expert-Guide/FAQ 与官方企业微信接入文档，核对日 2026-08-16。企业微信侧的平台规则以企业微信官方为准，我们不代为解释。我们没有安装客户端，本文不含实测数据。

一、按官方给的两条先核对

核对一：地址是否完整

「完整」这两个字覆盖的问题比想象中多。逐项对照：

检查项	常见错误
协议头	少了 https://，或者是 http:// 而不是 https://
首尾空白	复制粘贴时带进了空格或换行——肉眼看不出来
是否被截断	地址很长，复制时只选中了一部分
路径部分	只复制了域名，后面的路径丢了
参数部分	地址带参数（? 后面那段）时被截掉

首尾空白是最阴的一个——你怎么看都觉得地址是对的，但校验就是过不去。

处理办法：把地址先粘到一个纯文本编辑器里（记事本、TextEdit），看清楚首尾有没有多余字符，确认后再复制过去。别在两个网页输入框之间直接来回复制。

协议头是第二常见的。 同门产品的钉钉接入文档里，官方专门标了「重要」提醒：将地址中的 http 改为 https。可见这个坑普遍存在，配企业微信时同样值得检查。

核对二：是否与当前配置要求一致

意思是你填的地址，得是当前这套配置生成的那一个。

实际中最容易出错的两种情况：

• 配了多次，填的是旧地址——之前试过一遍没成功，重新配了一次生成了新地址，但你粘贴的还是旧的；
• 填错了位置——企业微信后台有多个填地址的地方，接收消息的和别的用途不是一个。

处理办法：回到 WorkBuddy 客户端，重新复制一次当前配置生成的地址，别从聊天记录或者临时记事本里翻。

二、为什么优先选不需要公网地址的方式

这里有个能直接绕开整个问题的做法。

看官方钉钉接入文档里的两种模式说明就明白了：

模式	官方描述的适用人群	要不要填 Webhook 地址
WebSocket 长连接	个人 / 家庭 / 办公室用户（没有公网 IP）。配置更简单，不需要公网地址，开箱即用	不需要
URL 回调	有服务器、有公网 IP 的用户	需要，还要回平台后台配置

企业微信侧，官方接入文档也说明有两种入口、两种接入方式。

如果你没有公网 IP、也不打算维护一台服务器，优先选不需要填公网地址的那种方式——域名主体校验这个问题从根上就不会出现。

很多人是照着某篇教程一路走到了回调这条路上，其实自己的场景压根不需要。配之前先想清楚：你有没有一个稳定的、可对外访问的地址？ 没有的话，别走这条路。

三、还是不通过，怎么办

官方给的是：保留报错截图提交排查。

需要如实说明：官方 FAQ 对这一条没有给出更深入的解法——因为校验规则在企业微信侧，不是 WorkBuddy 能单方面决定的。

所以提交时把两侧的信息都带上：

【接入平台】企业微信
【接入方式】WebSocket 长连接 / URL 回调
【地址来源】从 WorkBuddy 客户端复制的当前配置生成地址
【地址检查】协议头 https ✓ ；无首尾空白 ✓ ；完整未截断 ✓ ；是当前配置生成的最新地址 ✓
【报错截图】企业微信侧的原始报错（截全，包含提示原文）
【企业微信侧】企业类型、管理员权限情况
【已试过】重新生成配置并重新填写一次

「地址检查」那四项逐一打勾很重要——它告诉对方基础的东西你已经排除过了，能直接跳到深层问题。

反馈入口：客户端右上角「帮助」下拉框，或右下角头像 → 设置 - 帮助与反馈 - 意见反馈，描述问题、上传截图并勾选「上传日志」提交。官方支持邮箱 workbuddy@tencent.com。

同时建议：这个校验规则本身属于企业微信侧，如果是企业域名主体资质相关的问题，也需要你们企业微信的管理员去那边确认。两边同时推进比只推一边快。

四、几条相邻的官方条目

配接入时容易连着遇到，一并列出来：

飞书配置 Webhook 提示无法检查链接。 官方说明：重复输入同一 Webhook 地址后可能出现该提示；做法是重新创建或重新填写一次配置，避免重复输入同一地址；仍失败则保留提示信息反馈。

——注意这条跟企业微信这条的方向正好相反：企业微信要你核对地址是否完整一致，飞书要你避免重复输入同一地址。别把两边的做法搞混。

已完成接入但发送消息无响应。 官方做法：先确认当前连接状态是否仍在线；优先切换模型后再次测试；微信场景若长时间无响应建议断开后重新连接；若首次可用后续失效，记录复现时间与平台类型。

钉钉侧的通用排查顺序（官方在钉钉接入文档的常见问题里给的，思路可参考）：检查应用状态（已发布并通过审批）→ 检查 Webhook 配置（地址正确且使用 https）→ 检查电脑上的 WorkBuddy 正在运行且助理服务已开启 → 检查权限是否都已开通。

五、一个最容易被忘的前提

不管哪个平台、哪种接入方式，这条链路的终点都是你自己电脑上正在运行的那个客户端。

电脑关机、休眠、客户端退出了，机器人一定不回复——这跟 Webhook 配置一点关系没有，在后台里怎么查都查不出来。

配完之后如果测试不通，先看一眼电脑那头是不是活着，再回头查配置。这一步只要三秒，但能省掉一小时的白折腾。

小结

• 域名主体校验是企业微信侧做的，不是 WorkBuddy 侧。
• 官方两条做法：核对地址是否完整、是否与当前配置要求一致；仍不通过则保留报错截图提交排查。
• 「完整」要逐项查：协议头是否 https、首尾有无空白（最阴的一个）、是否被截断、路径与参数是否齐全。
• 「一致」的常见错误：填的是旧地址、填错了位置。回客户端重新复制一次最新的。
• 没有公网 IP 就别走回调这条路——选不需要公网地址的连接方式，这个问题从根上不会出现。
• 别把飞书那条搞混：飞书是「避免重复输入同一地址」，方向相反。
• 提交排查时把「地址检查四项已排除」写清楚，并同步找企业微信管理员确认主体资质侧的问题。
• 链路终点是你那台开着机的电脑。

功能与文档表述以官方为准，企业微信侧规则以企业微信官方为准，核对日 2026-08-16。