SDK排障指南

如何快速排障

如果您在使用SDK的过程中遇到问题，您可以参考如下流程快速排查

问题分类

SDK 初始化失败 → 检查配置文件

API 调用报错 → 检查参数或权限

事件监听异常 → 检查WebSocket连接

超时/无响应 → 检查网络和日志

依赖冲突 → 检查 Maven/Gradle 配置

排查步骤

Step 1: 检查配置文件

检查配置文件中的配置项如address、devices等是否正确

常见配置错误：

Step 2: 运行官方示例项目验证环境

参考官方Demo使用流程，运行官方Demo是否正常

目的：确认问题是否由环境、配置或 SDK 本身引起

如何判断问题来源：

✅ 示例项目运行正常 → 问题可能在你的代码或配置中，继续 Step 2

❌ 示例项目启动失败 → 可能是：

配置错误：检查配置文件中的配置项是否正确

网络问题：无法访问后端 API，检查网络是否通畅

依赖问题：Maven/Gradle 下载依赖失败

JDK 版本：检查JSDK版本

Step 3: 启用SDK详细日志

如果demo运行正常，配置信息也检查无误，还是没发现问题，建议您启用SDK的debug详细日志，并在SDK初始化时指定SDK日志的存储路径。

建议您在SDK初始化时指定日志的存储路径，详情请参考初始化 SDK

您可以通过调用设置日志级别为debug启用详细日志。

FlightHubSdkErrorCode result = FlightHubSDK.setLogLevel("debug");
if (result == FlightHubSdkErrorCode.SUCCESS) {
    System.out.println("日志级别设置成功");
}

SDK 详细日志启动后，您可以根据SDK的日志排查错误信息。

排障信息收集清单

如果您通过以上步骤SDK的问题还没得到解决，您可以收集排障信息后，在官方支持的企业微信群随时联系我们。

提交问题前，请准备以下信息：

基础环境信息

SDK 版本号（如 v1.0.0）

JDK 版本和厂商（如 OpenJDK 11.0.30）

操作系统（Windows/Linux/macOS + 版本）

运行环境（本地运行/Docker/K8s）

配置文件内容（脱敏后）

您（去除敏感信息后）的配置文件信息

SDK日志

建议您开启 sdk debug日志后，将问题发生时的SDK日志文件反馈给我们。

调用代码片段

您集成SDK后出现问题的代码片段，可以以文件或者截图的方式反馈给我们的技术专家。

设备相关信息（如问题涉及设备操作）

设备序列号（SN）

设备类型（机场型号/无人机型号）

设备在线状态

固件版本号

点击查看更多常见问题FAQ

如何快速排障#

问题分类#

排查步骤#

Step 1: 检查配置文件#

Step 2: 运行官方示例项目验证环境#

Step 3: 启用SDK详细日志#

SDK 详细日志启动后，您可以根据SDK的日志排查错误信息。#

排障信息收集清单#

基础环境信息#

配置文件内容（脱敏后）#

SDK日志#

调用代码片段#

设备相关信息（如问题涉及设备操作）#