错误码

概述

错误码是软硬件系统在安装、运行过程中发生错误时，给操作者返回的错误代码信息。

在DTS数字孪生平台的使用和运维过程中，会涉及到如下的错误码：

• 业务错误码：用户在进行业务操作时，控制台界面上报的错误码。

错误码格式

错误码信息一般由错误编号和错误描述组成。

分类

| 错误码列表 | 软件许可业务 | 数据处理业务 | 三维渲染业务 | 云服务业务 | 二次开发业务 |

提示： 可通过“CTRL+F”唤出在页面中查找功能，快速定位错误码。

错误码列表

软件许可错误码列表

数据处理错误码列表

三维渲染错误码列表

云服务错误码列表

云服务客户端错误码列表

实例管理接口错误码列表

二次开发错误码

软件许可业务错误码

200：本机没有许可。

错误码描述

本机没有使用DTS软件的许可。

可能原因

本机没有申请授权或未配置共享其他电脑的授权。

处理建议

参照申请许可的视频说明：

https://www.bilibili.com/video/BV1vu41147W4/?spm\_id\_from=333.999.0.0

211：没有发现许可，已经达到最大的用户数。

错误码描述

DTS软件使用数超过许可数。

可能原因

• Explore程序未完全退出，又起了一个Explore；

• Cloud使用的并发数超过了能使用的许可认证数；

• 本机开启了授权共享，授权被其他机器占用。

处理建议

增加许可数或者减少软件使用数量。

100001 本机许可将要过期

错误码描述

DTS软件许可即将到期。

可能原因

授权时间即将到达时限。

处理建议

步骤1 点击“继续使用”。

步骤2 获取新的授权。

35：本机许可已过期

错误码描述

许可已经过期。

可能原因

授权时间已到达时限。

处理建议

获取新的授权。

38：本机许可被锁定

错误码描述

许可被锁定。

可能原因

机器上有反编译程序或者破解补丁触发加密系统保护机制，造成许可被锁定。

处理建议

获取新的授权。

机器信息不匹配

错误码描述

许可和机器信息不一致。

可能原因

试用许可是和机器绑定的，导出的机器信息和最终使用许可的机器不一致。

处理建议

导出本机的机器信息重新授权，在授权面板重新导入。

数据处理业务错误码

200：输出路径为空

错误码描述

程序没检索到输出路径。 发布数据失败。

可能原因

没有配置输出路径。

处理建议

配置输出路径再发布。

206：提供的dem被shp切没了

错误码描述

dem和shp位置不在一起，裁切时把地形都切掉了。发布数据失败。

可能原因

dem和shp的坐标系不统一 。

处理建议

通过GIS软件将dem和shp坐标系统一。

209：dem数据包围盒过小，请检查是否为投影坐标系

错误码描述

通过GIS软件查看dem是否是投影坐标系。

可能原因

DTS只支持PCS投影坐标系，dem可能是经纬度。

处理建议

通过GIS软件将dem转换成投影坐标系。

210：未找到dom数据，请检查dom路径

错误码描述

程序未检测到影像数据。

可能原因

未添加影像数据。

处理建议

影像配置栏添加影像数据。

211：未找到dem数据，请检查dem路径

错误码描述

程序未检测到dem数据。

可能原因

未添加dem数据。

处理建议

地形配置栏添加地dem数据。

213：dom数据包围盒过小，请检查是否为投影坐标系

错误码描述

通过GIS软件查看dom是否为投影坐标系。

可能原因

DTS只支持PCS投影坐标系，dom是经纬度。

处理建议

通过GIS软件将dom转换成投影坐标系。

216：dom和dem没有重叠区域，请检查两者坐标系

错误码描述

dom和dem位置不在一起。

可能原因

dom和dem不是同一个投影坐标系。

处理建议

通过GIS软件将dom和dem转换成同一个投影坐标系。

218：没有新增数据，无需重新发布

错误码描述

原数据没变化，不需要重新发布。

可能原因

数据没有更新，反复发布会有这个提示。

处理建议

数据没有更新不需要重复操作。

230：shp文件数据类型不支持

错误码描述

通过GIS软件查看shp是否是投影坐标系。

可能原因

DTS只支持PCS投影坐标系，shp可能是经纬度。

处理建议

通过GIS软件将shp转换成投影坐标系。

241：shp文件的颜色字段设置错误，请检查-shpColorFieldName=是否正确

错误码描述

shp文件的颜色字段命名错误。

可能原因

shp文件的颜色字段未按照规定的COLOR命名，所以才会有此提示。

处理建议

步骤1 shp文件的颜色字段按照规定的COLOR命名；

步骤2 通过参数“-shpColorFieldName=字段名”设置。

300：资源的dem的路径为空

错误码描述

发布资源，程序未检测到dem数据。

可能原因

未添加dem数据。

处理建议

地形配置栏添加地dem数据。

302：发布资源时，读取资源信息失败

错误码描述

发布资源，程序读取点shp失败。

可能原因

点shp不是投影坐标系或字段命名不符合规范。

处理建议

检查点shp坐标系、字段命名需符合规范，可参照用户手册。

405：无法将模型数据从源坐标系转换到目标坐标系

错误码描述

发布倾斜数据，源坐标系转换到目标坐标系失败。

可能原因

源坐标系和目标坐标系的prj文件不规范。

处理建议

可以到EPSG官网下载对应坐标系的prj文件。

502：vtpk未生成有效数据，发布失败

错误码描述

发布VTPK数据失败。

可能原因

输出VTPK的arcgis pro版本高于2..5或配置的图层全是point。

处理建议

输出VTPK的arcgis pro版本建议用2..5，纯点的VTPK加一个polyline或者polygon。

三维渲染业务错误码

1：Invalid_Param

错误码描述

Invalid_Param 非法参数

可能原因

非法参数，例如送入的3dt路径为非法字符组成的无意义路径。

处理建议

检查参数的正确性。

2：Layer_Already_Exist

错误码描述

Layer_Already_Exist 图层已存在。

可能原因

图层已存在，试图多次添加同一3dt文件。

处理建议

检查3DT是否已经添加成功。

3：LocalFile_NotExist

错误码描述

LocalFile_NotExist 文件不存在

可能原因

文件不存在

处理建议

需要验证3dt文件是否存在。

4：FileKey_NotSupport

错误码描述

FileKey_NotSupport 密钥不匹配

可能原因

密钥不匹配

处理建议

3dt文件发布的授权与当前运行环境授权不一致，调整授权环境状态后数据重发。

5：FileFormat_NotSupport

错误码描述

FileFormat_NotSupport 文件格式不支持。

可能原因

不是合法3dt文件格式。

处理建议

请检查数据格式。

6：AvailableScene_NotExist

错误码描述

AvailableScene_NotExist 文件中无可用场景

可能原因

3dt文件中无可用场景。

处理建议

3dt文件中无可用场景，常出现在美工3dt中，需注意按照相应规范，进行数据重发。

7：FileCorrupted

错误码描述

FileCorrupted 文件已损毁

可能原因

文件已损毁

处理建议

通常情况出现在频繁数据拷贝的情形下，可追溯文件来源，找到未损坏版本或进行数据重新处理

8：NeedPrefessinalLicense

错误码描述

NeedPrefessinalLicense 需要专业版授权

可能原因

需要专业版授权，标准版不支持。

处理建议

建议升级授权等级。

9：ExceedStandardQuota

错误码描述

ExceedStandardQuota 超出标准版配额

可能原因

超出标准版配额。

处理建议

建议升级授权等级。

10：NetworkTimeOut

错误码描述

NetworkTimeOut 连接网络3DT服务超时

可能原因

服务相关网络环境及配置错误。

处理建议

建议检测服务相关网络环境及配置。

云服务业务错误码

Cloud在连接视频流的时候，由于某种原因，可能会连接失败，如果在初始化DigitalTwinPlayer的时候，指定了{ui: startupInfo: true} ，则会在页面上显示错误代码及简单的错误原因，例如：

下面详细介绍Cloud云服务可能收到的错误代码及原因。

客户端业务错误码

Cloud在连接视频流的时候，由于某种原因，可能会连接失败，如果在初始化DigitalTwinPlayer的时候，指定了{ui: startupInfo: true} ，则会在页面上显示错误代码及简单的错误原因，例如：

下面详细介绍Cloud可能收到的错误代码及原因。

1006: abnormal

错误码描述

异常关闭

可能原因

用于期望收到状态码时连接非正常关闭，也就是说没有发送关闭帧。一般非正常的情况比较复杂，例如websocket 连接在nginx 配置的 proxy_read_timeout 内没有收到数据，nginx主动发起的连接断开（不是客户端主动断开，也不是服务端主动断开的）

处理建议

尝试重新链接。

1008 : invalid_message

错误码描述

无效的消息

可能原因

在调用实例管理接口时，发送了错误的数据格式，导致服务端对数据的解析失败时，便会收到此类型的错误。

处理建议

检查发送的消息格式是否正确。

4000 : out_of_control

错误码描述

不受控制

可能原因

Cloud的每个实例都是由NodeService进程维护的（包括启动、停止、设置参数等），如果NodeService进程异常退出，此时再调用实例管理接口对实例进行启动、停止等操作时，便会收到4000的错误。

处理建议

检查NodeService进程是否异常退出，如果退出，尝试重新启动。

4001 : instance_disconnected

错误码描述

实例断开

可能原因

客户端已正常连接上视频流，在浏览的过程中，实例异常退出，此时客户端便会收到此错误。

处理建议

稍候尝试重新连接。

4002 : instance_not_found

错误码描述

实例未找到

可能原因

客户端在向服务器请求连接指定实例的视频流时，服务器未找到指定的实例，客户端便会收到此错误。例如：

处理建议

检查指定的实例ID是否有效。

4003 : instance_start_failed

错误码描述

实例启动失败

可能原因

客户端连接视频流时，分配的实例尚未启动，在实例启动过程中，由于某些原因启动失败，客户端便会收到此错误。关于实例启动的错误代码，请参考下面的内容。

处理建议

根据具体错误码进行处理。

4004 : webrtc_connection_error

错误码描述

WebRTC连接失败

可能原因

客户端连接视频流时，WebRTC协商失败（可能的原因：浏览器版本太低、浏览器不支持H264视频解码等），服务器便会向客户端发送此错误码。

处理建议

升级浏览器版本。

4005 : one_client_allowed

错误码描述

只允许一个客户端连接

可能原因

如果实例设置了只允许一个客户端访问，当第2个客户端连接的时候就会收到此错误码。

处理建议

步骤1 关闭之前打开的浏览器连接然后重连；

步骤2 修改CloudMaster里的实例配置 。

4006 : timeout

错误码描述

超时

可能原因

当客户端连接视频流时，如果分配的实例尚未启动，便会临时启动，客户端会等待实例启动后继续连接，如果30秒内实例尚未启动成功，客户端便会收到超时的错误码而断开连接。

实例之所以30秒内尚未启动的原因可能有：

• 由于加载的工程巨大，导致30秒内尚未加载完成；

• 实例启动过程中由于BUG导致进程卡死；

• 实例启动过程中由于某种原因弹出来模态对话框（例如：授权到期的提示框、进程崩溃的提示框等）

处理建议

步骤1 重新刷新浏览器。

步骤2 调试运行，看看渲染进程是否打开工程的时候卡在某个阶段了。

4007 : iid_required

错误码描述

必须指定iid参数

可能原因

Cloud的连接分两种：带视频流的WebRTC连接和不带视频流的WebRTC连接。

带视频流的连接，可以不用指定iid参数，服务器会自动分配可用的实例给客户端。

对于不带视频流的连接，必须指定iid参数，也就是说必须明确指定要连接哪个实例。如果没有指定iid参数，便会收到此错误码。

处理建议

传送链接附带IID参数。

4008 : locked

错误码描述

实例已锁定

可能原因

在调用实例管理接口对实例进行切换工程文件（acp）操作时（实例管理接口：SetInstanceParams），如果实例已设置为锁定工程， 便会收到此错误码。 因为客户端无法对已锁定的实例进行切换工程的操作。

要规避此错误，要么选择一个未锁定的实例，要么先对实例进行解锁操作。

处理建议

取消实例锁定，或者换一个未锁定工程的实例。

4009 : invalid_project

错误码描述

工程无效

可能原因

当客户端指定了一个CloudMaster工程列表里不存在的pid参数时，便会收到此错误码。

也就是说初始化DigitalTwinPlayer时指定的pid参数，必须是工程列表里已存在的工程ID。

!

处理建议

检查指定的工程是否有效。

4010 : no_free_instance

错误码描述

无可用实例

可能原因

客户端连接视频流时 ，如果没有指定iid参数，服务器会自动分配当前可用的实例， 当没有可用的实例分配时，便会断卡客户端连接.

服务器的自动分配策略如下：

• 已启动、没有连接、非正忙的实例

• 未启动（优先查找未启动的，因为一个页面同时初始化2个视频流时，如果先查找正在启动的，会导致2个连接同一个实例）

• 正在启动的实例

• 查找不限制连接数的实例

• 未锁定的实例（可以切换工程的）

• 如果上面的条件都不满足，就返回正忙的实力，让用户选择是否手动重启

处理建议

步骤1 增加实例数（比如升级显卡、增加显卡等）

步骤2 取消实例锁定

步骤3 尝试刷新浏览器

4100 : kicked

错误码描述

实例被踢出

可能原因

通过CloudMaster的“实例管理”或者“连接信息”右键菜单断开用户连接， 或者通过实例管理接口二次开发断开用户连接时， 客户端便会收到此错误码。

处理建议

刷新浏览器

4101 : syncing_data

错误码描述

正在同步数据

可能原因

服务器正在进行数据同步操作，此时客户端去连接，便会收到此错误码。

数据同步的过程中是不接受客户端连接的。

处理建议

等待数据同步结束。

4102 : instance_killed_by_user

错误码描述

实例被用户终止

可能原因：

实例的断开有正常断开和异常退出2种情况。 4102属于正常退出，是用户主动停止实例的运行， 主要发生在以下几种情况：

• 通过CloudMaster或者调用实例管理接口 停止实例运行

• 通过CloudMaster修改正在运行的实例的IID，也会发送此错误码

  处理建议

刷新浏览器。

4103 : invalid_password

错误码描述

无效的密码

可能原因

每个实例都可以在高级参数里设置一个访问密码，如果设置了访问密码，客户端在初始化DigitalTwinPlayer的时候需要指定password属性，如果未指定或者密码错误，便会收到此错误码。

处理建议

检查指定的密码是否正确。

4105 : nodeservice_stopped

错误码描述

NodeService已停止

可能原因

客户端在连接上视频流正常浏览的过程中，通过CloudMaster停止服务， 客户端便会收到此错误码。

处理建议

重新启动服务即可。

4107 : instance_is_busy

错误码描述：

实例正忙

可能原因：

客户端连接上视频流后，如果后台渲染进程正在执行一个比较耗时（主线程执行超过3秒）的接口调用，客户端便会收到此错误码。

处理建议

等待响应或重启实例。

4108 : ip_no_access

错误码描述：

IP没有权限

可能原因：

在使用白名单功能时，Token过期时间到了以后，刷新页面重连的时候，如果不通过验证服务器而直接连CIM服务器，会出现“4108 没有授权”的错误提示。

./media/image14.png

C:\8F9C6225\F718C03D-C7B9-472D-812F-F2D1508F8770.files\image008.png

在Token有效期内，刷新页面直连CIM服务器没有问题。

处理建议

重新通过验证服务器授权。

4109 : unknown_client

错误码描述：

无效的客户端

可能原因：

Cloud服务器有3种类型的客户端连接: Manager、Streamer、Player

• Manager：管理者，又分3种：CloudMaster、NodeService，普通的实例管理功能二次开发

• Streamer：渲染进程

• Player：客户端（浏览器）

实例管理接口的二次开发在连接websocket的时候，必须使用如下的URL: ws://ip:port/manager，也就是说必须指定/manager，如果未指定或者指定了一个别的类型，便会连接失败，收到此错误码。

处理建议

链接WebSocket时，指定如下格式的URL：ws://ip:port/manager

4110 : num_of_instances_exceeded

错误码描述：

超出可访问的实例数

可能原因：

CloudMaster可设置一个客户端能同时访问多少个实例，当访问的实例个数超过设置的值时，便会收到此类型的错误。

处理建议

关闭其他链接，减少访问的客户端数量。或修改实例同时访问的链接数限制。

4111 : instance_not_auth

错误码描述：

实例未授权

可能原因：

客户端在连接linux平台的渲染服务器时，如果所分配的实例未授权，此客户端无法连接，同时收到此错误码。

处理建议

检查当前实例的授权。并且检查软授权连接数是否超过设置。

4112 : permission_denied

错误码描述：

没有权限

可能原因：

CloudMaster的新版本增加了客户端的授权机制

如果开启了此功能，当客户端初始化DigitalTwinPlayer连接CloudServer的时候就会进行授权检查，如果检查通过，可继续连接， 如果检查不通过（未授权），则连接会断开。

当勾选“启动客户端访问授权”后，访问视频流页面出现上图所示的4112错误时，可能的原因：

• 初始化DigitalTwinPlayer的时候，没有在urlExtralInfo里设置uid属性；

• 用户的后台系统没有调用实例管理接口添加客户端通行许可。

处理建议

步骤1 检查初始化参数

步骤2 用户后台重新给客户端授权

4113 : instance_was_preempted

错误码描述

实例被抢占

可能原因

当一个浏览器客户端连接上一个未锁定的实例正在浏览云渲染的时候，另一个客户端把此实例切换到另外一个工程， 先前的客户端便会收到4113（实例被抢占）的错误码提示。

处理建议

增加可以供多个用户浏览的实例。

或锁定之前浏览的工程，避免其他人切换。

实例管理接口业务错误码

1 : PermissionDenied

错误码描述

没有权限

可能原因

实例管理接口需要权限才能调用，如果没有权限，就会收到此错误。

处理建议

检查是否拥有权限。

2 : NoFreeInstance

错误码描述

没有空闲实例

可能原因

发生于实例管理接口的调用。

当调用实例管理接口获取一个空闲的实例时，如果此时没有空闲实例，便会返回此错误码。

处理建议

稍后重试。

3 : InstanceNotFound

错误码描述

实例未找到

可能原因

当调用实例管理接口对指定实例进行操作时（启动、停止、设置参数等），如果服务器未找到指定的实例，就会返回此错误码。

处理建议

检查参数是否正确

4 : InstanceNotRunning

错误码描述

实例未运行

可能原因

尚未使用

处理建议

重启软件。

5 : InvalidParameters

错误码描述

无效参数

可能原因

当通过CloudMaster修改实例ID时，如果传递的参数无效，就会收到此错误码。

处理建议

检查参数是否正确。

6 : ManagerNotFound

错误码描述

没有找到实例的宿主

可能原因

Cloud的每个实例都是由NodeService进程维护的（包括启动、停止、设置参数等），如果NodeService进程异常退出，此时再调用实例管理接口对实例进行启动、停止等操作时，便会收到此错误码。

处理建议

重新启动NodeService进程。

7 : PlayerNotFound

错误码描述

未找到Player

可能原因

在调用实例管理接口提出客户端时，如果指定的客户端不存在，就会收到此错误码。

处理建议

检查参数是否正确。

8 : Failed

错误码描述

失败

可能原因

实例管理接口调用失败

处理建议

步骤1 检查参数是否正确；

步骤2 检查工程是否同步成功。

9 : InstanceNotAuthorized

错误码描述

实例未授权

可能原因

当调用实例管理接口启动linux平台上的实例时，如果实例未授权，就会收到此错误。

处理建议

步骤1 检查CloudServer是否配置了授权参数；

步骤2 检查授权连接数是否用尽。

800 : StartInstance_ExeNotExist

错误码描述

实例启动失败-未找到可执行文件

可能原因

未找到RenderAgent.exe，可能被杀毒软件误杀，或者被误删

处理建议

检查安装文件是否完整，或尝试重新安装。

801 : StartInstance_ProjectPathNotExist

错误码描述

实例启动失败-工程不存在

可能原因

调用实例管理接口启动实例时，指定了一个不存在的工程文件

处理建议

步骤1 重新同步工程列表。

步骤2 检查指定的工程文件是否有效。

803 : StartInstance_ProcessStartFailed

错误码描述

实例启动失败-进程启动失败

可能原因

RenderAgent.exe进程启动失败，可能是系统原因，比如系统虚拟内存不足，中了病毒等。

处理建议

检查系统配置。

804 : StartInstance_Locked

错误码描述

实例启动失败-实例已锁定

可能原因

对已锁定的实例执行切换工程的操作，就会收到此错误。

处理建议

取消实例锁定；

或者换一个未锁定工程的实例。

805 : StartInstance_StartPendding

错误码描述

实例启动失败-启动中

可能原因：

实例正在启动，需要等待。

处理建议

等待响应。

806 : StartInstance_Timeout

错误码描述

实例启动失败-超时

可能原因

实例启动超时（30秒）

处理建议

步骤1 重新刷新浏览器；

步骤2 检查参数是否正确；

步骤3 调试运行，查看。

二次开发业务错误码

1：InvalidParameters 参数错误

错误码描述

InvalidParameters 参数错误

可能原因

输入的参数错误。

处理建议

检查参数的正确性。

2：InternalError 内部错误

错误码描述

InternalError 内部错误

可能原因

内部错误

处理建议

收集问题进行反馈，由开发工程师排查原因。

3：ResourceNotFound 数据不存在

错误码描述

ResourceNotFound 数据不存在

可能原因

数据不存在。

处理建议

检查数据是否存在。

4：AcpProjWKTNotSet 工程未设置坐标系

错误码描述

AcpProjWKTNotSet 工程未设置坐标系

可能原因

工程未设置坐标系。

处理建议

步骤1 新建ACP工程。

步骤2 设置合适坐标系。

5：CoordinateConversionFailed 坐标转换失败

错误码描述

CoordinateConversionFailed 坐标转换失败

可能原因

坐标越界或不符合规范。

处理建议

检查坐标的有效性。

6：IDExists 指定ID的对象已经存在了

错误码描述

IDExists 指定ID的对象已经存在了

可能原因

指定ID的对象已经存在了。

处理建议

检查指定ID的对象是否已经存在。

7：InvalidRequestType 无效的请求类型

错误码描述

InvalidRequestType 无效的请求类型

可能原因

无效的请求命令。

处理建议

检查请求命令的正确性。

8：InvalidRequestString 无效的请求（包含了InvalidRequestType）

错误码描述

InvalidRequestString 无效的请求（包含了InvalidRequestType）

可能原因

无效的请求参数。

处理建议

检查请求参数的正确性。

9：NoCommand CommandFactory没有创建对应的Command

错误码描述

NoCommand CommandFactory没有创建对应的Command

可能原因

没有创建对应的Command

处理建议

检查请求命令的正确性。

10：DataTypeNotSupport 不支持这种类型的数据

错误码描述

DataTypeNotSupport 不支持这种类型的数据

可能原因

操作不支持此类型的数据，比如压平操作只能是OSGB和Terrain。

处理建议

更换操作的对象类型。

11：InvalidOperation 无效的操作

错误码描述

InvalidOperation 无效的操作

可能原因

无效的操作。

处理建议

检查操作的有效性。

12：ProjectNotOpened 工程尚未打开，此时不能进行API调用！

错误码描述

ProjectNotOpened 工程尚未打开，此时不能进行API调用！

可能原因

工程尚未打开。

处理建议

稍后等工程完全开启后执行API调用。

13：Unauthorized 未授权

错误码描述

Unauthorized 未授权

可能原因

未获得授权

处理建议

检查授权是否正确。

14：IDAlreadyExists ID已经存在

错误码描述

IDAlreadyExists ID已经存在。

可能原因

ID已经存在。

处理建议

更换ID。