使用Amplify时安卓端未认证前获取GraphQL数据异常问题

1. Amplify安卓端的固有差异 #

Amplify核心跨平台逻辑是一致的，但安卓平台在网络权限、安全配置、初始化时机上有平台特有的约束，这些细节差异可能导致未认证请求表现不同，并非Amplify本身的功能差异。

2. 跨平台表现差异的可能因素 #

• 网络安全配置限制：安卓默认禁止访问非HTTPS的网络资源，若你的AppSync端点使用自定义证书或HTTP协议，iOS可能自动兼容，但安卓会拦截请求，最终返回空数组而非报错。
• API密钥传递异常：虽然iOS请求正常，但安卓端可能因密钥读取、存储问题，导致实际请求未携带正确的x-api-key头，AppSync拒绝返回数据。
• 权限缺失：安卓需要显式声明INTERNET权限，若Manifest中未配置或被其他配置覆盖，请求会被系统拦截。
• 初始化时机问题：安卓端Amplify初始化若晚于GraphQL请求发起，会导致请求未正确绑定配置，返回空结果。
• 缓存干扰：安卓端Amplify的本地缓存可能留存了之前的空数据，而iOS缓存未触发相同逻辑。
• 日志缺失导致隐藏错误：安卓默认日志级别较低，可能请求实际返回403/401等错误，但未被捕获，仅表现为空数组。

3. 安卓未认证GraphQL访问的特定设置与步骤 #

必做配置

• 添加网络权限：在android/app/src/main/AndroidManifest.xml中确保存在：

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

• 配置网络安全策略：若使用自定义域名或非标准HTTPS证书，创建android/app/src/main/res/xml/network_security_config.xml：

  <?xml version="1.0" encoding="utf-8"?>
  <network-security-config>
      <domain-config cleartextTrafficPermitted="true">
          <domain includeSubdomains="true">your-appsync-endpoint.amazonaws.com</domain>
      </domain-config>
  </network-security-config>
  

  并在Manifest的application标签中引用：

  android:networkSecurityConfig="@xml/network_security_config"
  

• 确保Amplify提前初始化：在MainApplication.java的onCreate方法中优先初始化Amplify，再加载React Native：

  @Override
  public void onCreate() {
      super.onCreate();
      try {
          Amplify.addPlugin(new AWSApiPlugin());
          Amplify.configure(getApplicationContext());
          // 开启详细日志排查问题
          Amplify.Logging.enable(LogLevel.VERBOSE);
      } catch (AmplifyException e) {
          Log.e("AmplifyInit", "Could not initialize Amplify", e);
      }
      // 其他RN初始化代码
  }
  

排查步骤

1. 查看安卓端详细日志：通过Android Studio的Logcat筛选Amplify或AWSApiPlugin相关日志，检查请求的x-api-key是否正确，以及响应的状态码和原始内容。
2. 直接测试API可用性：在安卓设备上用curl或Postman调用AppSync查询，携带相同的API密钥，确认API本身能返回数据，排除设备网络或AppSync权限问题。
3. 清除应用缓存：在安卓设置中清除应用的缓存和数据，重新测试，排除旧缓存干扰。
4. 验证AuthMode配置：确保代码中明确指定authMode: GRAPHQL_AUTH_MODE.API_KEY，避免依赖默认配置（部分场景下安卓默认authMode可能与iOS不一致）。
5. 检查AppSync权限策略：确认AppSync数据源（如DynamoDB）的IAM策略允许未认证用户（通过API_KEY）访问目标资源，虽然iOS可用，但安卓请求的签名细节可能触发不同的权限校验逻辑。

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