Flutter集成Places API后启动崩溃：WebSocketChannelException问题求助

首先明确：你看到的WebSocket connection failed是应用崩溃后导致的调试连接中断，不是崩溃的根本原因，别被这个报错误导，重点要找应用本身的崩溃触发点。

以下是具体排查步骤：

• 先抓真实崩溃日志
  别盯着WebSocket报错，去看调试工具的核心日志：

  • Android：打开Logcat，过滤Error或Fatal级别日志，找崩溃的调用栈（比如NullPointerException、IOException这类）
  • iOS：用Xcode运行，看控制台输出的崩溃信息
  • 也可以看Flutter Run控制台里的红底错误信息，这才是触发崩溃的关键

• 检查Places API基础配置

  • 确认Google Cloud控制台里Places API（具体是Place Autocomplete或Place Search）已经启用，API密钥拥有该API的调用权限
  • 检查API密钥的限制：有没有绑定正确的包名（Android）或Bundle ID（iOS），如果限制了IP，调试时可能会被拦截，临时取消限制测试下

• 排查新增的Places请求代码

  • 核对HTTP请求的URL和参数：比如Google Places Autocomplete的正确端点是https://maps.googleapis.com/maps/api/place/autocomplete/json，必须带input（用户输入文本）、key（你的API密钥）这两个参数，参数格式错会返回错误JSON，后续解析时崩溃
  • 加错误处理逻辑：比如判断HTTP响应状态码，if (response.statusCode != 200)就打印错误信息，不要直接解析响应体；解析JSON时用try-catch包裹，避免字段缺失导致的异常
  • 空值检查：比如从响应JSON里取数据前，先判断是否为null，比如var predictions = json['predictions'] as List?;，如果是null就直接返回，不要强行遍历

• 权限配置检查

  • Android：AndroidManifest.xml里必须添加网络权限：

    <uses-permission android:name="android.permission.INTERNET"/>
    

  • iOS：Info.plist里确保添加了网络访问权限，以及如果用到位置服务，还要加位置权限描述：

    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <false/>
    </dict>
    <key>NSLocationWhenInUseUsageDescription</key>
    <string>需要获取位置以提供搜索建议</string>
    

• 逐步定位问题代码
  临时注释掉所有新增的Places搜索相关代码，运行应用看是否还崩溃。如果正常，再逐段恢复代码，每恢复一段就运行一次，直到重现崩溃，就能定位到具体哪一行代码出问题。

• 关于WebSocket的补充说明
  这个WebSocket是Flutter调试工具（比如DevTools）和应用之间的通信通道，用来传递调试信息、日志等。当应用崩溃时，这个连接会自动断开，所以它是崩溃的结果，不是原因，不用专门去解决WebSocket的问题。

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