Files
usdt/docs/rental-webhook-405.md
T
2026-11-02 22:34:18 -05:00

56 lines
3.6 KiB
Markdown

# 租赁回调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方法问题。
## 服务器本地验证及修正
先在运行后端的服务器执行,使用无签名测试正文不会更新订单:
```bash
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
```
新版后端默认APP模式,无认证请求头应返回401;CONFIGURED模式缺凭证时返回503,有凭证但无签名返回401,并带后端标记;不应返回405。不要为测试返回ok而关闭验签。
如果Nginx和后端同机、后端端口为2020,在实际监听80、匹配192.168.3.103的server块添加以下精确location(不是放在只监听443的server块):
```nginx
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处理前被改写到其他地址。
```bash
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事件使用管理员已有重投入口,不能重新扣款或重置业务订单。