Expo 网络请求与缓存
写 Expo/React Native 的接口请求和缓存代码:fetch 封装、React Query 接入、错误重试、离线支持、Token 刷新与环境变量配置。
功能与用途
在 Expo 与 React Native 开发中,处理网络请求经常遇到请求封装不统一、断网异常、Token 无感刷新失效以及环境变量混淆等问题。此技能提供一整套现成的网络层解决方案:涵盖基于 fetch API 的标准化请求封装、React Query 的配置与数据增删查改实战、自定义 ApiError 与指数退避重试机制、利用 expo-secure-store 安全存取 Token 并处理并发刷新的防抖逻辑、NetInfo 与 React Query 联动的离线优先保障,以及 EXPO_PUBLIC_ 环境变
适用场景
- 搭建统一请求与缓存层:配置 React Query Provider 与自定义 fetch 封装,实现请求缓存与数据失效重新获取。
- 离线优先与网络状态感知:借助 NetInfo 与 onlineManager 联动,在断网时暂停请求并在重连后自动恢复。
- 安全鉴权与防并发刷新:通过 SecureStore 管理 Token,并加入并发拦截锁实现过期的无感平滑刷新。
适用人群
- Expo/React Native 移动端开发
- 做跨平台 App 的前端工程师
- 需要接入后端接口的独立开发者
使用步骤
- 说清要解决的场景:是接新的接口、接缓存方案,还是排查网络失败和离线问题。
- 让 AI 按场景给出对应代码:基础 fetch 封装、React Query 的 Provider 与查询写法、错误与重试逻辑。
- 把接口地址和版本放进 .env 用 EXPO_PUBLIC_ 前缀,并补上 env.d.ts 类型声明,注意这些值在打包时内联,不能放密钥。
- Token 场景用 expo-secure-store 封装读写和刷新,离线场景用 NetInfo 配合 onlineManager 让请求断网暂停、恢复后继续。
- 在真机或模拟器上跑一遍,重点验证断网、Token 过期和组件卸载后取消请求这三条路径。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use when implementing or debugging ANY network request, API call, or data fetching. Covers fetch API, React Query, SWR, error handling, caching, offline support, and Expo Router data loaders (`useLoaderData`).
使用前准备
- 需要在 Expo / React Native 项目中使用
- 相关依赖如 @tanstack/react-query、expo-secure-store、@react-native-community/netinfo 需按需安装。
依赖与权限
- TOKEN_KEY
- EXPO_PUBLIC_API_URL
- API_URL
- BASE_URL
- 读取用户主动提供的内容