Zepp OS模拟器使用zeus dev启动应用无Start按钮报Connection closed

故障对应表现 #

• 执行zeus dev指令启动开发服务后，模拟器应用板块可正常识别目标应用
• 应用卡片仅展示「delete」按钮，无「start」启动按钮
• 终端控制台输出Connection closed报错
  
  

排查&修复方案 #

按优先级从高到低依次排查：

• 校验app.json配置合法性
  重点核对两个字段：一是platform字段值必须和当前运行的模拟器目标平台版本完全匹配；二是appType字段不能误填为系统后台服务类取值，服务类应用无前台启动入口，不会展示start按钮。配置修正后先执行zeus clean清除编译缓存，再重新执行zeus dev触发全量重编译。
• 排查开发服务端口占用
  zeus dev默认通过本地23037端口和模拟器建立通信链路，端口被其他进程占用时会直接触发连接断开报错。根据自身操作系统执行指令排查占用：
  • Windows环境执行：netstat -ano | findstr "23037"
  • macOS/Linux环境执行：lsof -i :23037
    查到占用端口的进程PID后强制结束对应进程，再重启开发服务即可。
• 校验CLI与模拟器版本兼容性
  本地安装的@zeppos/zeus-cli必须和模拟器版本属于同一大版本序列，跨大版本不兼容会导致应用安装校验不通过，仅能识别安装包、无法加载启动入口。版本对齐后建议完全退出模拟器再重新打开，清除模拟器侧的安装缓存。
• 校验入口文件与编译状态
  先执行zeus build检查编译流程是否抛错，确认项目根目录下app.js入口文件存在、无语法错误。入口文件缺失、编译阶段报错会导致应用无法被模拟器识别为可启动程序，仅保留删除操作入口，修复所有编译报错后再启动开发服务即可。

以上步骤排查完成仍未解决的，先删除模拟器内已安装的异常应用，重启设备后重新安装项目依赖、启动服务，可解决绝大多数偶现的通信链路异常问题。

内容的提问来源于stack exchange，提问作者Lucas silva