Windows11下Bot Framework Emulator启动ngrok失败及状态查看器无响应

错误信息 #

Failed to spawn ngrok. Please go to the Ngrok Status Viewer and download the log file for a more detailed view of the error.{"error_code":102,"status_code":400,"msg":"invalid tunnel configuration","details":{"err":"yaml: unmarshal errors:\n line 1: field region not found in type config.HTTPv2Tunnel\n line 1: field path not found in type config.HTTPv2Tunnel"}}

问题原因 #

Bot Framework Emulator 4.14.1仅适配ngrok v2版本，若系统中安装的是ngrok v3版本，会因配置字段不兼容触发该错误——v3的HTTPv2Tunnel配置结构已移除region和path字段，和Emulator生成的旧配置不匹配。

解决方法 #

• 降级ngrok到v2版本：将当前ngrok可执行文件替换为ngrok v2.x版本（如2.3.40），确认路径正确后重启Emulator。
• 清理Emulator的ngrok配置：打开Emulator设置，删除配置里的region、path等参数，确保ngrok路径指向正确的v2版本文件。
• 重置Emulator配置：删除%APPDATA%\BotFrameworkEmulator目录下的ngrok相关配置文件，重启Emulator后重新配置ngrok路径。

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