SDK_APP/快速故障排除指南.md

快速故障排除指南

当前问题：客户端找不到SerialTest服务器

立即检查清单

✅ 手机端检查

• 蓝牙已开启
• 蓝牙可见性设置为"始终可见"
• 已清除蓝牙缓存
• 重启过蓝牙服务

✅ 电脑端检查

• SerialTest正在运行
• 选择了正确的COM端口
• 启用了蓝牙服务器模式
• 电脑蓝牙已开启
• 电脑蓝牙设置为"可发现"

✅ 环境检查

• 设备距离在10米内
• 远离其他蓝牙设备干扰
• 没有金属屏蔽物

快速测试步骤

步骤1：基础扫描测试

1. 启动Android应用
2. 点击"连接蓝牙"按钮（普通点击）
3. 观察扫描结果：
   • 是否显示"🔍 开始扫描蓝牙设备..."
   • 是否显示"📡 使用BLE扫描模式"或"📡 使用传统蓝牙扫描模式"
   • 是否发现任何设备

步骤2：直接连接测试

1. 长按"连接蓝牙"按钮
2. 输入MAC地址：60:E9:AA:30:8B:0A
3. 点击连接
4. 观察连接状态

步骤3：系统蓝牙测试

1. 打开手机蓝牙设置
2. 扫描设备
3. 查看是否发现您的电脑设备
4. 如果发现，尝试配对

常见问题及解决方案

问题1：扫描不到任何设备

可能原因：

• 目标设备蓝牙未开启
• 设备不在可见范围内
• 蓝牙服务异常

解决方案：

1. 重启手机蓝牙
2. 重启电脑蓝牙
3. 检查设备距离
4. 使用系统蓝牙设置测试

问题2：扫描到设备但连接失败

可能原因：

• 设备未配对
• 协议不兼容
• SerialTest配置错误

解决方案：

1. 在系统蓝牙设置中手动配对
2. 检查SerialTest配置
3. 确认波特率设置

问题3：连接成功但无法通信

可能原因：

• 数据格式不匹配
• 波特率设置错误
• 协议不兼容

解决方案：

1. 检查SerialTest数据格式设置
2. 尝试不同的波特率
3. 发送测试数据验证

调试信息查看

Android Studio Logcat

过滤标签：BluetoothManager 查看以下信息：

• 扫描开始和结束
• 设备发现详情
• 连接状态变化
• 错误信息

应用状态显示

应用会显示：

• 🔍 扫描状态
• 📱 发现的设备信息
• ✅ 连接成功提示
• ❌ 错误信息

下一步操作

1. 按照检查清单逐一确认
2. 执行快速测试步骤
3. 记录每个步骤的结果
4. 查看Logcat日志
5. 如果问题持续，提供详细错误信息

需要提供的信息

如果问题仍然存在，请提供：

1. 手机型号和Android版本
2. 电脑操作系统版本
3. SerialTest版本和配置截图
4. 应用扫描过程的截图
5. Logcat中的错误日志
6. 系统蓝牙设置中的设备列表截图