常见错误

从错误类别而不是只看单条报错开始排查，可以更快定位问题。

配置错误

出现“额外字段”“字段无效”或启动后立即回退时，先使用当前版本的配置验证器。不要把其他版本的完整参考配置直接覆盖到生产环境。

媒体错误

RTSP 超时、FFmpeg 退出或 go2rtc 无流时，先用源地址单独测试，再检查账号、编码格式、TCP/UDP、摄像头连接数限制和网络。

检测错误

模型载入失败通常与模型格式、输入尺寸、标签文件、运行时或硬件设备映射不匹配有关。

存储错误

录像缺失时同时检查挂载、剩余空间、文件系统只读状态、权限以及录像进程日志。

Common Error Messages

Start troubleshooting from the error category instead of focusing on a single log line.

Configuration errors

For “extra field”, invalid option, or immediate startup rollback errors, validate against the configuration schema used by the installed release. Do not replace a production configuration with a reference file from another version.

Media errors

For RTSP timeouts, FFmpeg exits, or missing go2rtc streams, test the source independently and check credentials, codec, TCP/UDP transport, camera connection limits, and network reachability.

Detection errors

Model-load failures usually indicate a mismatch between model format, input dimensions, label map, runtime, or mapped hardware.

Storage errors

For missing recordings, check mount state, free space, read-only filesystems, permissions, and recorder logs together.

Mensajes de error comunes

Empiece por la categoría del error en lugar de centrarse en una sola línea del registro.

Errores de configuración

Ante campos adicionales, opciones no válidas o retroceso al iniciar, valide con el esquema de la versión instalada. No sustituya una configuración de producción por una referencia de otra versión.

Errores multimedia

Para tiempos de espera RTSP, cierres de FFmpeg o flujos go2rtc ausentes, pruebe la fuente por separado y revise credenciales, códec, transporte TCP/UDP, límite de conexiones y red.

Errores de detección

Los fallos al cargar modelos suelen indicar incompatibilidad entre formato, dimensiones de entrada, mapa de etiquetas, runtime o hardware.

Errores de almacenamiento

Si faltan grabaciones, compruebe montaje, espacio libre, sistema de archivos de solo lectura, permisos y registros del grabador.