网罗开发小红书、快手、视频号同名大家好我是展菲目前在上市企业从事人工智能项目研发管理工作平时热衷于分享各种编程领域的软硬技能知识以及前沿技术包括iOS、前端、Harmony OS、Java、Python等方向。在移动端开发、鸿蒙开发、物联网、嵌入式、云原生、开源等领域有深厚造诣。图书作者《ESP32-C3 物联网工程开发实战》图书作者《SwiftUI 入门进阶与实战》超级个体COC上海社区主理人特约讲师大学讲师谷歌亚马逊分享嘉宾科技博主华为HDE/HDG我的博客内容涵盖广泛主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验。我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告同时也会提供产品优缺点分析、横向对比并分享技术沙龙与行业大会的参会体验。我的目标是为读者提供有深度、有实用价值的技术洞察与分析。展菲您的前沿技术领航员 大家好我是展菲 全网搜索“展菲”即可纵览我在各大平台的知识足迹。每周定时推送干货满满的技术长文从新兴框架的剖析到运维实战的复盘助您技术进阶之路畅通无阻。文章目录引言一、先说结论二、最常见错误写法到处都是 fetch错误处理各写各的Token / Header 混乱AI 请求完全混乱三、为什么 fetch 在鸿蒙游戏中“不够用”1、没有统一入口2、无法做拦截3、多端行为不一致4、不支持复杂策略5、无法支持 AI 场景四、正确思路网络层封装核心目标基础结构五、第一步封装 HttpClient六、第二步API 层七、第三步拦截器自动加 Token统一错误处理自动重试八、第四步AI 专用网络层单独封装支持流式九、第五步多端适配示例十、完整架构十一、常见错误总结引言很多人做鸿蒙游戏时网络层一开始都是这么写的constresawaitfetch(https://api.example.com/data)constdataawaitres.json()简单、直接、能用。但只要项目稍微复杂一点很快就会出现问题接口到处都是错误处理混乱Token 管理失控多端行为不一致AI 请求难以统一最后你会发现不是接口难而是“网络层没有设计”。在 HarmonyOS 的多端 AI 场景下直接用 fetch本质是在“跳过工程化”。一、先说结论fetch最大的问题不是“不能用”而是不可控 不可复用 不可扩展在小 Demo 没问题但在真实项目中一定会失控二、最常见错误写法到处都是 fetch// HomePageawaitfetch(/api/list)// ProfilePageawaitfetch(/api/user)// BattlePageawaitfetch(/api/startBattle)问题请求分散 逻辑重复 无法统一管理错误处理各写各的try{awaitfetch(...)}catch(e){console.error(e)}每个页面都写一套。结果错误不可控Token / Header 混乱fetch(url,{headers:{Authorization:token}})如果 token 变了全项目修改AI 请求完全混乱fetch(/ai/chat)fetch(/ai/npc)fetch(/ai/story)没有统一入口。三、为什么 fetch 在鸿蒙游戏中“不够用”1、没有统一入口请求 → 分散无法统一日志 统一监控 统一重试2、无法做拦截你没法轻松实现自动加 token 自动刷新 token 统一错误处理3、多端行为不一致在 HarmonyOS 中手机 / TV / 平板网络环境可能不同弱网 断网 延迟高fetch 没有策略。4、不支持复杂策略比如重试 缓存 限流 队列需要自己写一堆逻辑。5、无法支持 AI 场景AI 请求特点长连接 流式返回 上下文管理fetch 很难优雅支持。四、正确思路网络层封装核心目标统一入口 统一策略 统一管理基础结构network ├─ httpClient ├─ api ├─ interceptors └─ aiClient五、第一步封装 HttpClientclassHttpClient{asyncrequest(url:string,options:any{}){try{constresawaitfetch(url,options)constdataawaitres.json()returndata}catch(e){this.handleError(e)}}handleError(e){console.error(Network Error,e)}}exportconsthttpnewHttpClient()所有请求统一走这里。六、第二步API 层exportconstUserAPI{getUser(){returnhttp.request(/api/user)}}exportconstGameAPI{startBattle(){returnhttp.request(/api/battle/start)}}页面不再写 URLPage → API → HttpClient七、第三步拦截器自动加 Tokenrequest(url,options){options.headers{...options.headers,Authorization:getToken()}}统一错误处理if(res.code!0){thrownewError(res.message)}自动重试for(leti0;i3;i){try{returnawaitfetch(...)}catch{}}八、第四步AI 专用网络层AI 请求不要混在普通接口里。单独封装classAIClient{asyncchat(message:string){returnhttp.request(/ai/chat,{method:POST,body:JSON.stringify({message})})}}支持流式asyncstreamChat(message,onData){// 处理流式返回}AI 网络层必须独立。九、第五步多端适配在 HarmonyOS 中示例if(devicetv){timeout5000}else{timeout3000}网络策略可以按设备调整。十、完整架构Page ↓ API ↓ HttpClient ↓ Interceptor ↓ NetworkAI 单独AIService ↓ AIClient十一、常见错误1、直接在页面写 fetch2、没有 API 层3、没有统一错误处理4、AI 请求混在普通请求5、没有重试 / 超时策略总结为什么不能直接用 fetch不可控 不可扩展 无法统一管理正确做法是HttpClient 封装 API 层 拦截器 AI 网络层 多端策略在 HarmonyOS 的生态中这意味着网络请求不是“调接口”而是“系统能力”。最后一句话fetch 是工具网络层是系统。能用 fetch 是起点会设计网络层才是工程能力。