错误码及排查

最近更新时间:2026-05-27 10:38:00

我的收藏
错误码的定义位于 trro_remote.h 头文件中。函数返回值为错误码的负值,如错误码为16777215,返回值为-16777215。

通用错误码

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_SUCCED
All
0x00000001
1
成功返回值。
TRRO_SUCCEED
All
0x00000001
1
成功。
TRRO_GWID_NOT_FOUND
All
0x00000010
16
不存在的网关 ID。
TRRO_PARAM_INVALID
All
0x00F00000
15728640
参数非法。
TRRO_COMMON_ERROR
All
0x00FFFFFF
16777215
参数输入或初始化状态异常。

配置文件错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_CONFIG_PARSE_FAILED
All
0x01000002
16777218
配置文件的格式解析异常,建议使用在线 json 校验工具进行检查。
解决方法:
1. 配置文件解析失败
请查看是不是比较老的版本,可能某一个字段的缺失。及时更新版本。
2. 配置文件 json 格式错误
请前往 json 格式解析 检查 json 格式是否正确。
3. 其他可能问题
sub_server_ip 不是字符串类型。
配置中 server_ip 字段类型错误。
sub_server_port 不是数字类型。
配置中 server_port 字段类型错误。
server_ip、server_port 请改为字符串类型,请检查其他字段。
TRRO_CONFIG_ILLEGAL
All
0x01000003
16777219
配置文件的参数非法,建议检查最小节点是否覆盖。
TRRO_CONFIG_UNEXIST
All
0x01000004
16777220
配置文件不存在。
解决方法:
和推流16777220 相同。
TRRO_CONFIG_CER_FAILED
All
0x01000005
16777221
公有云模式下证书错误。
TRRO_CONFIG_LIC_FAILED
All
0x01000006
16777222
license 证书错误。
TRRO_CONFIG_STREAMS_SIZE_ERROR
All
0x01000007
16777223
超过最大支持流数目。
TRRO_CONFIG_PORT_RANGE_ILLEGAL
All
0x01000008
16777224
端口范围配置非法。
TRRO_CONFIG_LOG_PERMISSION_DENIED
v2.4
0x01000009
16777225
打开 log 文件权限不足,请确认文件写权限。
TRRO_CONFIG_LOG_PERMISSION_DENIED
v2.5
0x01000009
16777225
打开 log 文件权限不足,请确认文件写权限。
TRRO_CONFIG_DEVICE_ID_INVALID
All
0x0100000A
16777226
设备 ID 格式非法。
TRRO_CONFIG_DEVICE_NAME_INVALID
All
0x0100000B
16777227
设备名称格式非法。
TRRO_CONFIG_SDK_MODE_INVALID
All
0x0100000C
16777228
SDK 模式值非法。
TRRO_CONFIG_CLOUD_MODE_INVALID
All
0x0100000D
16777229
云模式值非法。
TRRO_CONFIG_REQUIRED_FIELD_MISSING
All
0x0100000E
16777230
必填字段缺失。
TRRO_CONFIG_FIELD_TYPE_ERROR
All
0x0100000F
16777231
字段类型错误。
TRRO_CONFIG_ERROR
All
0x01FFFFFF
33554431
通用配置类错误。

初始化错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_INIT_INPUT_ILLEGAL
All
0x02000002
33554434
输入参数非法,需检查入参是否正常。
TRRO_INIT_PARSE_FAILED
All
0x02000003
33554435
初始化参数解析失败,检查配置文件最小节点是否正常。
TRRO_INIT_CREAT_MEDIAMODE_FAILED
All
0x02000004
33554436
媒体模块创建失败。
TRRO_INIT_LICENSE_CHECK_FAILED
v2.5
0x02000005
33554437
LICENSE 校验失败。
TRRO_INIT_INVALID_INPUT
All
0x02000006
33554438
接口调用入参非法。
TRRO_INIT_MQTT_ABNORMAL
v2.4
0x02000007
33554439
初始化 MQTT 异常。
TRRO_INIT_PRM_ERROR
v2.5
0x02000007
33554439
初始化 MQTT 异常。
TRRO_INIT_REPEAT
All
0x02000008
33554440
重复初始化。
TRRO_INIT_CANCEL
All
0x0200000F
33554447
客户主动退出。
TRRO_INIT_LICENSE_FILE_ERROR
v2.5
0x02000011
33554449
LICENSE 文件错误。
TRRO_INIT_LICENSE_CHECK_TIME_FAILED
v2.5
0x02000012
33554450
LICENSE 授权过期。
TRRO_INIT_LICENSE_CHECK_DEVICE_FAILED
v2.5
0x02000013
33554451
LICENSE 硬件验证失败。
TRRO_INIT_LICENSE_CHECK_STREAM_FAILED
v2.5
0x02000014
33554452
LICENSE 授权流小于设备流。
TRRO_INIT_LICENSE_CHECK_ID_FAILED
v2.5
0x02000015
33554453
LICENSE 设备 ID 验证失败。
TRRO_INIT_PUBLIC_LICENSE_CHECK_TIMEOUT
v2.5
0x02000100
33554688
LICENSE 公有云验证超时。
TRRO_INIT_PUBLIC_LICENSE_CHECK_NOT_BIND
v2.5
0x02000101
33554689
公有云设备未绑定 license。
TRRO_INIT_PUBLIC_LICENSE_CHECK_NOT_ENOUGH
v2.5
0x02000102
33554690
公有云 license 数量不足。
TRRO_INIT_PUBLIC_LICENSE_CHECK_OVERTIME
v2.5
0x02000103
33554691
公有云 license 已过期。
TRRO_INIT_PUBLIC_LICENSE_CHECK_NOT_DURATION
v2.5
0x02000104
33554692
公有云 license 剩余时长不足。
TRRO_INIT_ERROR
All
0x02FFFFFF
50331647
通用初始化失败,未知原因。

信令连接错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_SIGNAL_REGISTER_FAILED
All
0x03000002
50331650
信令注册失败。
TRRO_SIGNAL_STATUS_ABNORMAL
All
0x03000003
50331651
信令服务器连接异常。
TRRO_SIGNAL_MESSAGE_FAILED
All
0x03000004
50331652
信令消息处理失败。
TRRO_SIGNAL_CONNECT_OUTTIME
All
0x03000005
50331653
信令服务器连接超时。
TRRO_SIGNAL_DEVICEID_OR_PASSWORD_INCORRECT
All
0x03000006
50331654
信令服务器连接用户名或者密码错误。
TRRO_DEVICE_ALREADY_LOGIN
All
0x03000007
50331655
信令服务器连接用户名已经登录。
TRRO_SIGNAL_ERROR
All
0x03FFFFFF
67108863
信令模块失败。

流采集错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_CAPTURE_OPENDEVICE_FAILED
All
0x04000002
67108866
打开设备失败。
TRRO_CAPTURE_GETSOURCE_FAILED
All
0x04000003
67108867
获取数据源失败。
TRRO_CAPTURE_UNKNOWN_CAPTURETYPE
All
0x04000004
67108868
未知采集类型。
TRRO_CAPTURE_ERROR
All
0x04FFFFFF
83886079
采集模块错误。

流传输错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_CONNECT_TIMEOUT
All
0x05000002
83886082
超时断连。
TRRO_CONNECT_RESET
All
0x05000003
83886083
connect 的时候如果之前有未断开的连接需要重置。
TRRO_CONNECT_MODE
All
0x05000004
83886084
connect 网关的连接 mode 不支持。
TRRO_CONNECT_ERROR
All
0x05FFFFFF
100663295
连接错误。

诊断工具错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_DIAG_STARTED
All
0x06000000
100663296
诊断工具正在启动中。
TRRO_DIAG_TIMEOUT
All
0x06000001
100663297
诊断工具获取推流信息超时。
TRRO_DIAG_FAILED
All
0x06000002
100663298
诊断工具处理失败。

权限错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_UNAUTHORIZED
All
0x07000000
117440512
网关未授权无法发送消息。
解决方法:
由于未收到车端的授权消息,导致无法发送消息。以下是相关解决方法:
1. 可配置为自动授权,或在每次发送消息时请求控制权限。
2. 如需更精细的应用层控制,请参考相关说明文档 控制授权管理

消息通道错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_MESSAGE_PERMISSION
v2.5
0x06000008
100663304
网关未授权无法发送消息
解决方法:
由于未收到车端的授权消息,导致无法发送消息。以下是相关解决方法:
1. 可配置为自动授权,或在每次发送消息时请求控制权限。
2. 如需更精细的应用层控制,请参考相关说明文档 控制授权管理
TRRO_MESSAGE_MEDIA_CLOSED_RATE_EXCEED
v2.5
0x0600000A
100663306
MQTT 通道,媒体未连接发送受限。
TRRO_MESSAGE_ERROR
v2.5
0x06FFFFFF
117440511
消息错误。
TRRO_MESSAGE_BYTE_EXCEED
All
0x08000002
134217730
发送字节数超出限制。
TRRO_MESSAGE_RATE_EXCEED
All
0x08000003
134217731
发送间隔过于密集。
TRRO_MESSAGE_MAX_EXCEED
All
0x08000004
134217732
1秒最多发送 10KB 数据。
TRRO_MESSAGE_CHANNEL
All
0x08000005
134217733
消息通道异常。
TRRO_MESSAGE_BLOCK
All
0x08000006
134217734
发送缓冲区满了。
TRRO_MESSAGE_COMPRESS
All
0x08000007
134217735
消息压缩失败。
TRRO_MESSAGE_DATA_CHANNEL_NOT_READY
v2.5
0x08000008
134217736
数据通道未就绪,无法发送消息。

存储错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_STOR_DISABLED
v2.5
0x07000001
117440513
存储未使能。
TRRO_STOR_ID_EXISTS
v2.5
0x07000002
117440514
重复开启存储。
TRRO_STOR_ID_ILLEGAL
v2.5
0x07000003
117440515
非法 ID。
TRRO_STOR_PARAM_ILLEGAL
v2.5
0x07000004
117440516
参数非法。
TRRO_STOR_UNSET_FILENAME
v2.5
0x07000005
117440517
未设置文件名。
TRRO_START_CAPTURE_ID_EXISTS
v2.5
0x07000006
117440518
重复开启采集。
TRRO_STOR_ERROR
v2.5
0x07FFFFFF
134217727
存储异常。

外部输入错误

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_EXTERNAL_RESIZE
v2.5
0x08000001
134217729
外采输入错误。

异步错误事件

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_ERROR_CALLBACK_CAMERA
v2.5
0x09010000
151060480
相机异步回调错误。
TRRO_ERROR_CALLBACK_MIC
v2.5
0x09020000
151126016
麦克风异步回调错误。
TRRO_ERROR_CALLBACK_BANDWIDTH_LIMIT
v2.5
0x09030000
151191552
评估网络带宽无法满足最低码率需求。
TRRO_ERROR_CALLBACK_RESERVE_DEGRADE
v2.5
0x09040000
151257088
网络带宽不足引发 reserve 带宽降级。
TRRO_ERROR_CALLBACK_JOIN_AUTH_FAILED
v2.5
0x09050000
151322624
RTC 进房鉴权失败(底层 event 10006),通常由后台黑白名单配置、UserSig 非法或过期引起。

其他

错误码名称
适用版本
十六进制值
十进制值
描述
TRRO_UNSUPPORTED
v2.5
0x0F000001
251658241
该调用或者函数功能暂不支持。
TRRO_INPUT_SIZE_ILLEGAL
v2.5
0x0F000002
251658242
输入大小不匹配。
TRRO_SESSION_INACTIVE
v2.5
0x0F000003
251658243
会话未激活。