fix(camera): ONVIF 偶发传输错误重连重试一次(避免丢掉 stop 导致云台一直转)

线上复验(修复凭据后)统计: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)仍正确返回"没有云台机构"。
This commit is contained in:
liufumingren 2026-09-15 22:15:29 +08:00
parent 0d0b0b8db2
commit 22013959a4

View File

@ -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);