后端集成及常见环境问题

1. 接口调用报错,提示”不合法的许可服务证书“,”授权失败xxx”

错误原因
该错误表示轻量化引擎服务中授权出现异常,需查看授权情况。
解决方法
浏览器中打开授权管理地址(服务器ip:8274),查看授权是否激活,并在有效期内。
  1. 地址访问失败,找到服务器上BitAnswerService服务,启动或者重启下该服务。
  2. 授权管理地址中显示授权未激活,联系技术支持进行授权激活。
  3. 授权管理地址中授权状态显示异常,联系技术支持进行授权更新处理。

2. 接口调用报错,提示“文件格式不支持”

错误原因
该错误表示该账号没有提供对应的文件格式转换。
解决方法
查看轻量化引擎支持的模型类型及版本 中是否存在该模型格式,如果存在,联系技术支持,做相关的格式开放。

3. 模型插入成功,返回转换失败,提示“文件下载失败”

错误原因
该错误表示插入的上传文件(通常是使用inputUrl上传的http路径)地址异常,无法在服务端下载。
解决方法
  1. 确定输入转换模型文件路径是否正确,文件是否存在。(inputUrl方式,确定url是可以直接访问、下载,且不要带有权限解析的参数处理的http\https路径)。
  2. 上传的文件路径或者文件名不要包含特殊的字符,如果文件必须包含特殊字符,请将该文件压缩为不带特殊字符的zip文件,并使用该文件上传,指定mainfile为该文件名,进行上传转换。
  3. 上传的文件路径由于网络问题无法访问,需要开通对应的文件访问权限。

4. 接口调用成功,返回转换失败,提示“提示文件不存在”

错误原因
该错误表示插入任务的输入文件存在,或者输入的压缩包中不存在可以转换的文件。
解决方法
确定输入转换模型文件是否存在,如果是压缩包,确定对应的参数mainFile 指定的文件名在压缩包中存在,且如果压缩包有多层级文件夹,mainFile中有对应的相对路径。

5. 接口调用失败,提示“请求已过期”

错误原因
该错误表示调用接口的请求头信息中的签名校验信息已过期。
解决方法
重新生成请求头信息,再调用。

6. 接口调用失败,提示“授权参数缺失”

错误原因
该错误表示调用接口的请求头信息中缺少对于的字段。
解决方法
请求头信息补充完整,需要timeStampData、partnerID、shaKeyData(或apiKeyData)信息。

7. 接口调用失败,提示“签名验证失败”

错误原因
该错误表示调用接口的请求头信息中签名信息校验失败。
解决方法
请求头信息签名信息timeStampData、partnerID、shaKeyData(或apiKeyData)生成方式检查是否正常,及检查生成shaKeyData(或apiKeyData)的企业id和密钥是否正确。

8. 接口调用失败,提示“购买次数已用完”

错误原因
该错误表示该公有云账号购买的次数已用完或者订单已失效。
解决方法
联系相关技术支持,处理下订单。

9. 部分模型转换失败、装配体文件转换失败

错误原因
  • 模型问题,模型版本不对,或者模型被加密,无法解析。
  • 装配体文件只上传了主装文件,没有上传对应的零件。
解决方法
检查模型再CAD中是否可以正常打开。检查装配体文件是否完整。

10. 部分子件转换失败或带中文字符的文件转换失败

错误原因
  • Convert.json 文件编码格式不正确,不是utf-8编码。
  • Convert.json 缺少"Light"、"Assembly"字段,或者"Models"字段内容和模型没有对应上。
  • 模型本身异常,导致转换失败。
解决方法
检查Convert.json是否配置正常,及模型是否正常。