From 22013959a4c6fa50513d86d927c8a5b79abc26f4 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Tue, 15 Sep 2026 22:15:29 +0800 Subject: [PATCH] =?UTF-8?q?fix(camera):=20ONVIF=20=E5=81=B6=E5=8F=91?= =?UTF-8?q?=E4=BC=A0=E8=BE=93=E9=94=99=E8=AF=AF=E9=87=8D=E8=BF=9E=E9=87=8D?= =?UTF-8?q?=E8=AF=95=E4=B8=80=E6=AC=A1=EF=BC=88=E9=81=BF=E5=85=8D=E4=B8=A2?= =?UTF-8?q?=E6=8E=89=20stop=20=E5=AF=BC=E8=87=B4=E4=BA=91=E5=8F=B0?= =?UTF-8?q?=E4=B8=80=E7=9B=B4=E8=BD=AC=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 线上复验(修复凭据后)统计:ONVIF 连接失败 0、Authority failure 0,运动成功 4 + 停止成功 5。 但出现过 1 次 "Parse Error: Expected HTTP/, RTSP/ or ICE/"——设备在 control/stop 连得很快时 偶发返回非 HTTP 响应(TP-Link 侧问题),原实现直接判失败。 风险不对称:丢一次"动作"无所谓,丢一次 stop 就是云台一直转(虽然有 30s 兜底超时)。 新增 _withOnvifRetry:识别 Parse Error / ECONNRESET / socket hang up / EPIPE / timeout / ECONNREFUSED 这类偶发传输错误 → 断开该设备的 ONVIF 会话 → 重建后重试一次。 control / stop / presetGoto / presetSet 全部走这个包装;这些操作本身幂等(stop 幂等、 同速度运动幂等、预置点幂等),重试安全。非传输类错误(如设备明确拒绝)不重试,直接上报。 离线回归 42 断言仍全通过;真机回归(8.165)仍正确返回"没有云台机构"。 --- utils/cameraPtz.js | 28 +++++++++++++++++++++++++--- 1 file changed, 25 insertions(+), 3 deletions(-) diff --git a/utils/cameraPtz.js b/utils/cameraPtz.js index fe008b7..32cea22 100644 --- a/utils/cameraPtz.js +++ b/utils/cameraPtz.js @@ -384,6 +384,28 @@ function _dropOnvif(host) { _onvifCache.delete(host); } +/** + * 偶发传输层错误(设备偶尔返回非 HTTP 响应、连接被重置…):实测 TP-Link 在 + * control/stop 连得很快时会偶发 "Parse Error: Expected HTTP/, RTSP/ or ICE/"。 + * 这类错误断开重连一次基本就好;而【丢掉 stop】= 云台一直转,代价远大于重试。 + */ +function _isOnvifTransient(e) { + return /Parse Error|ECONNRESET|socket hang up|EPIPE|ETIMEDOUT|timeout|ECONNREFUSED|not connected/i + .test(String(e && e.message ? e.message : e)); +} + +/** 偶发错误就断开重连重试一次;重试仍是幂等的(stop / 同一速度的运动 / 预置点) */ +async function _withOnvifRetry(target, label, fn) { + try { + return await fn(); + } catch (e) { + if (!_isOnvifTransient(e)) throw e; + _log('ONVIF %s 偶发传输错误(%s)→ 断开重连后重试一次', label, e.message); + _dropOnvif(target.host); + return await fn(); + } +} + /** 速度档位 1~7 → ONVIF 速度 0.15~1(默认 4 档 → 0.57) */ function _speedNormalized(speed) { const s = Number(speed); @@ -597,7 +619,7 @@ export async function ptzAction(rtspUrl, action, speed = 4, stop = false, opts = const proto = await _protocol(target); if (proto === 'onvif') { try { - return await _onvifAction(target, key, speed, stop); + return await _withOnvifRetry(target, key, () => _onvifAction(target, key, speed, stop)); } catch (e) { _dropOnvif(target.host); _err('ONVIF %s 异常: %s', key, e.message); @@ -649,7 +671,7 @@ export async function ptzPresetGoto(rtspUrl, presetId, opts = {}) { const proto = await _protocol(target); if (proto === 'onvif') { try { - return await _onvifPresetGoto(target, id); + return await _withOnvifRetry(target, `presetGoto(${id})`, () => _onvifPresetGoto(target, id)); } catch (e) { _dropOnvif(target.host); _err('ONVIF 预置点调用异常: %s', e.message); @@ -689,7 +711,7 @@ export async function ptzPresetSet(rtspUrl, presetId, presetName, opts = {}) { const proto = await _protocol(target); if (proto === 'onvif') { try { - return await _onvifPresetSet(target, id, presetName); + return await _withOnvifRetry(target, `presetSet(${id})`, () => _onvifPresetSet(target, id, presetName)); } catch (e) { _dropOnvif(target.host); _err('ONVIF 预置点设置异常: %s', e.message);