TypeError: Failed to fetch (code 10)TypeError: Failed to fetch

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

根据知识库中关于 HBuilderX 运行微信小程序的说明，出现 TypeError: Failed to fetch (code 10) 且偶发恢复的情况，通常与网络或配置有关。以下是基于知识库内容的排查建议：

1. 检查项目类型
   确保项目根目录存在 manifest.json 且被正确识别为 微信小程序 类型（右键项目可查看类型）。若项目多了一层父目录会导致识别失败，需调整目录结构。参考文档

2. 微信小程序配置校验

   • 确认 manifest.json 中的微信小程序 appid 与微信开发者后台一致。
   • 检查 project.config.json 中的 setting.urlCheck 是否为 false（避免因域名校验拦截请求）。

3. 网络与权限问题

   • 错误码 20102（微信小程序平台获取加密key失败）可能触发类似报错，需重新打包或检查微信后台的 合法域名配置 是否包含当前请求的域名。参考文档

4. 运行方式优化

   • 使用 编译模式 运行（菜单栏选择 运行 > 运行到小程序模拟器 > 微信开发者工具 时勾选），避免偶发的热更新异常。
   • 通过 CLI 运行时添加 --runtime-log true 参数观察详细日志：

     ./cli launch mp-weixin --project 项目名称 --runtime-log true  

     参考文档

5. 微信开发者工具缓存
   在微信开发者工具中手动 清除缓存（菜单栏 工具 > 清除缓存 > 全部清除），避免因缓存导致请求异常。

若以上步骤仍无法解决，建议检查微信开发者工具控制台中的 网络请求详情，确认是否为域名未配置或证书问题。