[Bug] 企业微信客服openapi回调地址请求不通过

[Makarov3821]

What happened / 发生了什么

Reproduce / 如何复现？

参考https://docs.astrbot.app/platform/wecom.html ，填好各种信息后生成webhook链接，将其填入回调URL后便会出现这个错误：

但在平台日志里面，这个验证显示为有效：

我的astr为nginx反代docker暴露的端口，nginx的access日志也可以看到成功：
127.0.0.1 - - [29/Jun/2026:22:38:48 +0800] "GET /api/platform/webhook/b?msg_signature=14dc&timestamp=1&nonce=8&echostr=kAE2TEXjjH%3D HTTP/1.1" 200 59 "-" "Mozilla/4.0"

如果直接请求，返回的似乎是一个json：
·$ curl -i 'https://:32315/api/v1/webhooks/platforms/b?msg_signature=6&timestamp=1&nonce=1&echostr=gP3%2FINM'
HTTP/2 200
server: nginx/1.24.0 (Ubuntu)
date: Mon, 29 Jun 2026 14:46:09 GMT
content-type: application/json
content-length: 58
strict-transport-security: max-age=31536000
x-frame-options: SAMEORIGIN
x-content-type-options: nosniff

{"status":"ok","message":null,"data":"2321"}·

我不是非常熟悉企业微信的回调，不过我看到有文档说这里应该返回的是一个明文而不是一个json？

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

4.26.2，Docker部署

OS

Linux

Logs / 报错日志

见上

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

这个问题的根因已经定位到了：统一 webhook 端点将所有响应都包裹在 JSON 信封中，而企微客服的 URL 验证要求返回纯文本的 echostr。

具体流程：

1. WeCom adapter 的 handle_verify() 正确解密并返回了 echostr 字符串 [1]
2. 但统一 webhook 端点的 _run() 函数将结果无条件地包裹为 {"status":"ok","data":"echostr"} [2]
3. 企微收到 JSON 而非纯文本，验证失败

这就是为什么你在日志里看到"验证请求有效性成功"，但企微那边报错的原因。

修复方案：

在 astrbot/dashboard/api/platform.py 的 _run() 中添加 Response 类型检查，避免对已经是 Response 对象的结果进行 JSON 包装：

from fastapi.responses import Response

async def _run(operation):
    result = await run_maybe_async(operation)
    if isinstance(result, Response):
        return result  # 直接返回，不包装
    return ok(result)

同时修改 WeCom adapter 的 handle_verify() 返回 Response 对象：

from fastapi.responses import Response

async def handle_verify(self, request) -> Response:
    echo_str = self.crypto.check_signature(...)
    return Response(content=echo_str, media_type="text/plain")

既然你愿意提交 PR，以上就是需要修改的两个关键位置。这个问题也会影响其他需要返回非 JSON 响应的平台适配器（如 LINE、Lark 等）[3]。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.