React Native：OnePlus设备上GraphQL Mutation请求失败问题

问题专属成因 #

该问题属于OnePlus氢OS/ColorOS系统定制导致的差异化异常，常见成因分为三类：

1. 系统级后台网络限制：OnePlus对非白名单应用的后台网络请求限制远严于其他安卓厂商，后台状态下发起的mutation请求会被系统防火墙直接拦截，不会到达服务端。
2. 系统强制HTTP缓存重写：部分OnePlus系统版本会默认给所有POST请求追加缓存头，而GraphQL mutation属于写入操作不允许缓存，Apollo Client收到不符合预期的缓存响应后会触发执行异常。
3. 原生fetch API篡改：OnePlus定制系统会修改React Native依赖的原生fetch实现，导致mutation请求的请求体序列化异常，比如variables字段被截断、特殊字符转义错误。

修复方案 #

• 排查系统权限限制：在OnePlus设备的「设置 - 电池 - 应用耗电管理」中找到对应应用，将「后台网络权限」修改为「始终允许」，同时关闭「省电优化」，复测确认是否恢复。如果问题解决，后续可通过引导用户手动配置或申请OnePlus应用白名单解决批量用户问题。
• 强制禁用HTTP缓存：给Apollo Client的HTTP链路添加缓存控制头，覆盖系统追加的缓存规则，配置示例如下：

import { ApolloClient, InMemoryCache, createHttpLink } from '@apollo/client';

const httpLink = createHttpLink({
  uri: '你的GraphQL服务端点',
  // 强制覆盖请求头，避开系统缓存逻辑
  headers: {
    'Cache-Control': 'no-cache, no-store, must-revalidate',
    'Pragma': 'no-cache',
    'Expires': '0'
  },
  fetchOptions: {
    cache: 'no-store'
  }
});

const client = new ApolloClient({
  link: httpLink,
  cache: new InMemoryCache(),
});

• 替换底层请求实现：如果是fetch兼容问题，可将Apollo Client的底层请求替换为axios等未被系统篡改的请求库，避开原生fetch的兼容问题。
• 本地调试定位：在OnePlus设备上开启抓包工具，对比正常机型和OnePlus设备的mutation请求/响应差异，确认是否存在请求被拦截、内容被篡改的情况。

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