Files
usdt/docs/rental-webhook-405.md
T
2026-11-02 21:17:15 -05:00

3.5 KiB

租赁回调405定位与HTTP入口配置

已复现证据

2026-11-02从开发环境发送POST到http://192.168.3.103/api/api/webhook/debug,实际返回HTTP405、Server nginx/1.24.0 (Ubuntu)、Content-Type text/html以及Nginx默认405页面。直连192.168.3.103:2020超时。证据指向HTTP入口代理/静态路由,尚未取得运行服务器的Nginx配置,不能仅凭Server头断定具体location;代理也可能替换上游错误页。开发环境无法直连2020不等于服务器本地也无法连接。

新日志如何定位

发送端“租赁回调请求开始”包含随机callbackId、实际POST、协议、主机、端口和签名路径;“响应来源”记录Server、Allow、X-Rent-Debug-Backend、响应关联ID与上游traceId,不记录凭据、正文或Cookie。

接收端WebhookDebugTraceFilter在MVC路由匹配前记录“租赁调试回调入口”,出口记录HTTP状态和匹配Controller。即使认证尚未配置或MVC返回405也能记录。响应头X-Rent-Debug-Backend: ruoyi-webhook-debug-v1表示经过当前版本调试回调过滤器,不能替代验签,也不证明已进入Controller。缺标记时还需考虑代理剥离响应头或错误页替换,用接收端callbackId日志进一步判断。

  • 无入口日志:检查Nginx实际HTTP server/location、是否落入前端静态页、是否指向旧实例。
  • 入口方法不是POST:检查proxy_method、rewrite/error_page内部跳转及其他代理。
  • 入口POST且405:查看出口handler、后端运行版本、路由与过滤器。
  • 返回401或503:已经进入验签接收端,应继续配置凭证/签名路径,不再是HTTP方法问题。

服务器本地验证及修正

先在运行后端的服务器执行,使用无签名测试正文不会更新订单:

curl -i --connect-timeout 3 --max-time 10 \
  -X POST http://127.0.0.1:2020/api/webhook/debug \
  -H 'Content-Type: application/json' -d '{}'
sudo nginx -T

新版后端在缺凭证时应返回503,配置凭证但无签名返回401,并带后端标记;不应返回405。不要为测试返回ok而关闭验签。

如果Nginx和后端同机、后端端口为2020,在实际监听80、匹配192.168.3.103的server块添加以下精确location(不是放在只监听443的server块):

location = /api/api/webhook/debug {
    proxy_pass http://127.0.0.1:2020/api/webhook/debug;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Rent-Callback-Id $http_x_rent_callback_id;
    proxy_intercept_errors off;
    proxy_connect_timeout 5s;
    proxy_read_timeout 10s;
}

不同机器部署须替换为Nginx能访问的真实后端地址。保持POST方法和正文默认透传,不使用proxy_method GET或关闭proxy_pass_request_body;不要用error_page 405返回200掩盖故障。若server级存在统一return/rewrite,应确保回调请求不会在location处理前被改写到其他地址。

sudo nginx -t && sudo systemctl reload nginx
curl -i --connect-timeout 3 --max-time 10 \
  -X POST http://192.168.3.103/api/api/webhook/debug \
  -H 'Content-Type: application/json' -d '{}'

外部notify_url不变,验签配置仍使用RENT_WEBHOOK_DEBUG_SIGNATURE_PATH=/api/api/webhook/debug,而后端实际接收路径为/api/webhook/debug。确认无签名测试返回401/503后再通过正式回调验签验证ok;DEAD事件使用管理员已有重投入口,不能重新扣款或重置业务订单。