From 031778c0e38d4fdc9aaeb95698e8a5089253af63 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Wed, 16 Sep 2026 17:47:34 +0800 Subject: [PATCH] =?UTF-8?q?fix(camera):=20=E8=AE=A4=E8=AF=81=E8=A2=AB?= =?UTF-8?q?=E6=8B=92=E5=90=8E=E6=8C=89=20host=20=E9=9D=99=E9=BB=98=205=20?= =?UTF-8?q?=E7=A7=92=EF=BC=8C=E9=81=BF=E5=85=8D=E9=87=8D=E8=BF=9E=E9=A3=8E?= =?UTF-8?q?=E6=9A=B4=E6=8A=8A=E8=AE=BE=E5=A4=87=E9=99=90=E6=B5=81=E8=B6=8A?= =?UTF-8?q?=E6=89=93=E8=B6=8A=E6=AD=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 现场:9.101 对整队相机都报 `SOAP Fault: Authority failure`,而**同一刻从开发机(换来源 IP) 裸 ONVIF 探针全通**,说明不是凭据问题——是设备侧对来源的会话/频率限制。 我们每条指令会做 2 次端口连接 × 最多 3 次重试,高频下发时等于持续重连, 只会把限流窗口越拉越长。 改动: - 新增 `_connBackoff`:host 收到 `Authority failure` 后静默 5 秒,这期间不再尝试建立连接, 直接快速失败并给出明确提示("已暂停重连 Xs(疑似设备限流)") - 连接失败的报错信息里带上剩余静默时间,便于排查 - 保留原有的偶发错误重试(Parse Error / 网络类仍会断开重连) 另外本轮同时验证/修复的主问题: **TP-Link 固件 bug——ContinuousMove 的 PanTilt 里 x=0 且 y≠0(纯抬头/低头)会返回畸形响应** (Parse Error),表现为"上下没反应、左右正常"。修复方式:纯俯仰时发 ±0.001 的 x (按 host 交替正负,pan 漂移 ~0.0006/次)。实测 9.226 从 0/6 全失败变为 6/6 全成功。 离线回归 46 断言全通过。 --- utils/cameraPtz.js | 25 ++++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/utils/cameraPtz.js b/utils/cameraPtz.js index abddb52..e6df62a 100644 --- a/utils/cameraPtz.js +++ b/utils/cameraPtz.js @@ -509,9 +509,21 @@ function _dropOnvif(host) { _onvifCache.delete(host); } +/** + * host → 下次允许尝试建立 ONVIF 连接的时间戳。 + * 设备对 ONVIF 会有会话/频率限制:一旦开始回 `SOAP Fault: Authority failure`, + * 我们每条指令的 2~3 次重连会把限流越打越死(实测 9.101 整队被拒,而同刻裸探针可通)。 + * 认证类拒绝就静默几秒,把“静静等它恢复”交给下一次下发。 + */ +const _connBackoff = new Map(); +const CONN_BACKOFF_MS = 5000; + /** 造一个带根因的错误,供上层重试判断 */ function _onvifConnectFail(host, port) { - return new Error(`ONVIF 连接失败(${host}:${port}):${_onvifErr.get(host) || '未知原因'}`); + const msg = _onvifErr.get(host) || '未知原因'; + const wait = Math.ceil(((_connBackoff.get(host) || 0) - Date.now()) / 1000); + const hint = wait > 0 ? `;已暂停重连 ${wait}s(疑似设备限流)` : ''; + return new Error(`ONVIF 连接失败(${host}:${port}):${msg}${hint}`); } /** @@ -638,6 +650,10 @@ function _onvifConnect(target, port) { clearTimeout(timer); if (err) { _onvifErr.set(target.host, err.message); + // 认证类拒绝:静默几秒,不再刷重连 + if (/Authority failure/i.test(err.message)) { + _connBackoff.set(target.host, Date.now() + CONN_BACKOFF_MS); + } _err('ONVIF 连接失败 %s:%d: %s', target.host, port, err.message); resolve(null); return; @@ -666,6 +682,13 @@ async function _onvifSession(target) { const cached = _onvifCache.get(target.host); if (cached) return cached; + // 刚被拒过就不要再刷连接(见 _connBackoff 注释) + const until = _connBackoff.get(target.host) || 0; + if (Date.now() < until) { + if (!_onvifErr.has(target.host)) _onvifErr.set(target.host, '认证被拒后暂时不再重连'); + return null; + } + // 先试平台给的口,再试 2020(多数TP-Link 的 ONVIF 口)与 80。 // ⚠️ 必须两个都留:实测 payload 给 2020 时,设备会偶发只认 80(反之亦然), // 去重后只剩一个口就会直接失败。