HarmonyOS 调试的时候卡到启动界面

这种情况有可能是以下条件触发：

1. 调试侧拿到的还是旧的进程 pid
2. 调试过程中突然设备重启了
3. 镜像存在问题 socket 连不上
4. 应用没拉起来
5. hvigor 版本不配套

1 .调试侧拿到的还是旧的进程pid排查

hdc shell
ps -ef|grep bundleName

先hdc shell 进入设备，然后执行ps 命令查找你的包名(bundleName)进程有几个，如果有两个，那么就是此种场景解决方案：卸载应用，然后重新启动调试，如果还存在此问题则请重启设备然后启动调试

2 调试过程中突然设备重启了

这种场景非常难遇到，遇到了则按 1 上面的操作进行修复

3 镜像存在问题

socket 连不上先确保应用是否能正常运行起来：如果运行正常，调试不行，那说明 -D 拉起调试存在问题，需要排查下，启动调试，然后按以下思路排查

3.1. 执行 hdc track-jpid 查看应用是否在列表中，在列表中则 Ctrl + C 退出，不在列表中则说明应用没拉起来，备好idea.log和hilog日志用于定位问题

3.2. 如果hdc track-jpid 中应用存在，但应用还是白屏，中心只有个图标，那考虑是 socket 连接问题，首先看看 idea.log 中对应调试时间点附近是否存在 WebSocket client opened. 关键字如果不存在，说明 socket 连接失败了，未连接成功，这种情况也需收集好idea.log和hilog日志定位分析，多半是镜像的问题，也可以手动通过 wireshark 抓包分析，大概率是卡在HTTP协议切换成 WebSocket协议阶段：如果备份好hilog日志也可以先确定好idea.log中端口转发时间点，然后观察hilog日志中的 HDC_LOG 日志，

具体定位方法如下

3.2.1. 先根据hdc fport ls 拿到当前应用的pid

3.2.2. 在hilog日志中过滤此 pid 的信息，当然也可以查下对应的包名分析看看有无明显报错，user镜像常见错误有如下：Read cmsg is nullptr，这种情况一般是权限问题，没有特定权限，这种情况需要拉上HDC工具链的同事一起分析

4.应用没拉起来

首先通过执行 hdc track-jpid 命令查看应用是否起来了：如果列表中没有对应的应用进程，则 hdc shell 进设备中，通过 ps -ef|grep bundleName 查看应用是否存在如果应用不在，说明应用没拉起来，如果应用存在，但 hdc track-jpid 列表中不在，说明应用没注册上，

4.1. 可能应用为 release 应用，hdc shell bm dump -n bundleName > aa.txt 查看 debug 值是否为true，如果为false则设备上的应用是 release 应用，建议clean工程然后重新debug打包，如果还是不行，说明应用未覆盖安装成功，优先判断当前需调试应用是否为预置应用，如果是预置应用推荐进行 OTA 升级build mode：None/debug 打出的包均为debug包

4.2. hdc track-jpid 读取字节出问题了，这种情况需要提供idea.log和hilog日志分析

5.hvigor 版本不配套

在以上问题都不符合的情况下，其它同事同样的工程却又没问题，考虑当前工程使用的 hvigor 版本是否和 DevEco Studio的版本不配套不配套请使用配套版本，或者新建一个模板工程，查看下hvigor目录下的 hvigor-config.json5 中的版本是多少也可以，保持和这个版本配套