升级Capacitor后iOS端Snowplow追踪器停止工作求助

• 检查iOS网络权限与ATS配置

  • 确认Info.plist中已添加NSInternetUsageDescription权限声明，Cap4对隐私权限要求更严格，缺少声明可能导致网络请求被拦截。
  • 检查NSAppTransportSecurity设置，确保Snowplow Collector的域名在NSExceptionDomains允许列表内，避免ATS限制网络请求。

• 调试Snowplow日志

  • 在追踪器初始化时开启调试模式：

    createTracker('sp', {
      endpoint: 'YOUR_COLLECTOR_URL',
      logger: { level: 'debug' }
    });
    

  • 打开Xcode控制台，查看iOS端是否有初始化失败、事件发送报错等日志信息，重点关注网络请求失败、存储访问异常类的提示。

• 验证Capacitor WebView配置

  • 检查capacitor.config.ts中的iOS WebView设置：
    • 确认allowNavigation包含Snowplow Collector的域名，避免WebView拦截跨域请求。
    • 检查webPreferences中的allowFileAccess、domStorageEnabled是否设为true，确保追踪器能正常使用本地存储。

• 抓包验证网络请求

  • 用Charles或Wireshark抓取iOS端的网络流量，确认Snowplow的事件请求是否发出：
    • 如果请求未发出，说明追踪器初始化或事件触发逻辑有问题；
    • 如果请求发出但无响应，检查Collector的CORS配置是否允许iOS WebView的源地址，或是否存在防火墙/代理拦截。

• 检查存储可用性

  • 在iOS WebView中测试本地存储（localStorage/IndexedDB）是否正常：

    // 测试localStorage
    localStorage.setItem('snowplow_test', 'test_value');
    console.log(localStorage.getItem('snowplow_test'));
    

  • 若存储失败，可能是Cap4 WebView默认禁用了存储，或设备存储配额不足。

• 验证版本兼容性

  • 确认@capacitor/core版本为Cap4.x的稳定版，避免版本不匹配导致的底层API差异。
  • 检查Snowplow JavaScript追踪器3.15的官方文档，确认是否存在与Cap4 iOS WebView相关的已知问题，或是否需要特定初始化参数。

• 最小化项目测试

  • 创建一个仅包含Snowplow追踪器的极简Ionic+Cap4项目，仅保留初始化和测试事件发送代码，排除业务代码、第三方插件的干扰，验证问题是否复现。

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