fix(camera): 认证被拒后按 host 静默 5 秒,避免重连风暴把设备限流越打越死

现场: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 断言全通过。
This commit is contained in:
liufumingren 2026-09-16 17:47:34 +08:00
parent 1a27402749
commit 031778c0e3

View File

@ -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(反之亦然),
// 去重后只剩一个口就会直接失败。