Flutter集成Soundstripe到img.ly遇ATS异常及JSON解析错误

1. 修复App Transport Security（ATS）异常问题 #

ATS报错是因为配置的IP地址格式不符合CIDR规范，且HTTP请求默认被ATS阻止。需要修改iOS项目的Info.plist文件：

打开ios/Runner/Info.plist，添加以下配置：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSExceptionDomains</key>
    <dict>
        <key>54.234.189.148</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSExceptionAllowsInsecureHTTPLoads</key>
            <true/>
            <key>NSExceptionRequiresForwardSecrecy</key>
            <false/>
        </dict>
    </dict>
</dict>

该配置允许对指定IP地址发起HTTP请求，绕过ATS的安全限制。

2. 解决JSON解析错误问题 #

错误提示“Unexpected character 'G' around line 1, column 1”说明接口返回的不是合法JSON，大概率是服务端返回了HTML错误页面（比如网关错误Gateway Error），按以下步骤排查：

• 手动验证接口响应：用curl或Postman访问http://54.234.189.148:4000/v1/songs，查看返回内容。如果是HTML文本或非JSON格式，说明服务端接口存在问题（比如未启动、路径错误、认证失败）。
• 检查Soundstripe配置：确认SoundstripeAudioProvider是否需要额外的认证参数（如API密钥）。如果SDK要求验证，需补充配置：

  let soundstripeProvider = SoundstripeAudioProvider(baseURL: "http://54.234.189.148:4000", apiKey: "你的API密钥")
  

• 确认服务端状态：确保后端服务正常运行，/v1/songs接口能返回符合格式要求的JSON数据。

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