Duaer

报错排查

在 Duaer 里排查 Webhook 404「is not registered」

调用 Duaer 的 Webhook 返回 404 和 is not registered,多半是测试地址没在监听,或正式地址对应的数字组织还没发布。

Duaer 返回的报错

  • The requested webhook "POST 你的路径" is not registered.
  • This webhook is not registered for GET requests. Did you mean to make a POST request?

第一种是这个地址现在没有登记;第二种是地址对,HTTP 方法不对。

先分清测试地址和正式地址

Duaer 的 Webhook 有两个地址。Test URL 路径里是 /webhook-test/,Production URL 是 /webhook/。两者行为不同:

  • Test URL:只在你点了「执行工作流程」或 Listen for test event 之后可用,而且只接一次调用。调用过一次,再调就是 404。重新点一次再试。
  • Production URL:数字组织发布后才登记。没发布、或发布后又停用,都是 404。点右上角「发布」,见 在 Duaer 里保存和发布数字组织。
  • 外部系统长期调用的,一律填 Production URL。Test URL 只用来在画布上看一次数据。

其他常见原因

  • 方法不对:报错第二种。把 Webhook 节点的 HTTP Method 改成调用方实际用的方法,或让调用方改。
  • 路径改过:改了 Webhook 节点的 Path 后要重新发布,旧地址立即失效。
  • 正式调用不在画布上显示:去 执行记录 里看,不是没触发。

常见问题

Duaer 的 Webhook 测试地址为什么第二次就 404?

Duaer 的 Test URL 每点一次「执行工作流程」只接一次调用。再测就再点一次,长期调用改用 Production URL。

Duaer 的 Webhook 已发布,正式地址还是 404?

看调用方的地址是不是 /webhook/ 而不是 /webhook-test/,HTTP 方法和 Path 是否和 Duaer 的 Webhook 节点一致。改过 Path 要重新发布。

同组