海外节点部署后调识别接口一直 403 Forbidden,同样的 key 在国内机器上正常,报错体里只有一行 region not allowed。第一次遇到会往复杂处想,其实漏掉的多是个小前提。

curl -s https://ipinfo.io/json | jq .country
curl -s -X POST https://ocr-ap-southeast.example.com/v1/recognize -H "Authorization: Bearer $TOKEN"

识别服务按地域做了访问控制,境外 IP 调用需要单独的 endpoint 并开通白名单。SDK 默认 endpoint 写死在国内域名,配置没跟着环境改。这一点先确认清楚,后面就不用反复试。

「识别服务地域限制」这个问题文档写得含糊,实际行为以当前版本为准,别照旧版本的结论套。新版本先放一台机器上跑一天再全量,问题一般在这段时间暴露。

备份不是备了就行,恢复一次才算数,很多备份文件打开才发现是空的。接口问题先分清是没发出去、发出去了没收到,还是收到了处理失败。

具体做法是,确认调用方出口 IP 的归属地;换成对应地域的 endpoint;在控制台把出口 IP 加进白名单;回调地址也要公网可达 否则结果推不回来。

改完照着核一遍,境外节点返回 200 回调也能正常收到结果。

作者 9823189