> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/troubleshooting/webhook-not-registered.md).

# 在 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](/zh/build/webhook.md) 有两个地址。Test URL 路径里是 /webhook-test/，Production URL 是 /webhook/。两者行为不同：

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

## 其他常见原因

- 方法不对：报错第二种。把 Webhook 节点的 HTTP Method 改成调用方实际用的方法，或让调用方改。
- 路径改过：改了 Webhook 节点的 Path 后要重新发布，旧地址立即失效。
- 正式调用不在画布上显示：去 [执行记录](/zh/build/executions.md) 里看，不是没触发。
## Questions

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

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

### Duaer 的 Webhook 已发布，正式地址还是 404？

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

## 相关

- [在 Duaer 里用 Webhook 接收请求](https://doc.duaer.com/zh/build/webhook.md)
- [在 Duaer 里保存并发布数字组织](https://doc.duaer.com/zh/build/save-and-publish.md)
- [在 Duaer 里查看执行记录](https://doc.duaer.com/zh/build/executions.md)
- [在 Duaer 里用 Respond to Webhook 回复调用方](https://doc.duaer.com/zh/build/respond-to-webhook.md)