微信小程序调用chatgpt接口失败需分层定位：先提取原始错误码，再核对https合法域名，排查代理是否被风控，验证流式响应utf-8解码逻辑，最后确认openid透传与权限声明合规。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
微信小程序调用ChatGPT接口失败时，不能只盯着“请求发没发出”，必须分层定位：是网络层被拦截、认证层卡死、响应解析崩了，还是微信侧主动限流封禁。真实报错里藏着关键线索，比如“network error”和“request:fail net::ERR_CONNECTION_RESET”根本不是一回事。
第一步：确认失败类型并提取原始错误码
打开微信开发者工具 → 点击右上角「调试器」→ 切换到「Console」标签页 → 复现一次失败请求 → 找到红色报错行。重点抄下完整错误字符串，例如：request:fail errCode:-1;errMsg:request:fail timeout 或 request:fail net::ERR_CERT_COMMON_NAME_INVALID。
不要跳过这步。很多开发者直接改代码，却没发现错误码是-100（域名未配置）还是-102（HTTPS证书不匹配），改错方向只会越调越偏。
第二步：检查合法域名与HTTPS强制要求
登录小程序管理后台 → 开发管理 → 开发设置 → 服务器域名 → 核对「request 合法域名」是否包含你调用的ChatGPT代理接口地址（如 https://api.yourproxy.com）。
【必须使用 HTTPS，且证书需由受信 CA 签发】。自签名证书、Let’s Encrypt 的泛域名证书若未正确覆盖子路径，或用了已过期证书，wx.request() 会静默失败，只报 -1 错误。
如果用的是本地开发代理（如 Charles/Fiddler），必须关闭「校验合法域名」开关（仅限真机调试时勾选），但上线前必须关掉——否则线上必挂。
第三步：排查后端代理是否被微信风控拦截
方法一：用 curl 模拟请求，绕过小程序环境
在终端执行：curl -X POST https://api.yourproxy.com/chat -H "Content-Type: application/json" -d '{"prompt":"hello"}'。如果返回正常，说明问题出在小程序侧；如果也失败，说明代理服务本身异常、被封或未正确处理微信 UA 头。
方法二：检查代理服务日志中的请求来源 IP 和 User-Agent
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
微信小程序发起的请求，UA 固定为 MicroMessengerClient/8.0.56(0x28003824) NetType/WIFI Language/zh_CN 类似格式。若日志中完全没这条记录，说明请求根本没到达代理层——大概率卡在域名校验或 HTTPS 握手阶段。
注意：2026年起，微信对高频调用未备案域名的代理服务启动自动识别机制，连续5分钟内同一IP触发10次以上非白名单域名请求，会临时屏蔽该IP出口流量，持续15分钟。
第四步：验证 wx.request() 流式响应解码逻辑
步骤一：启用 enableChunked 并监听 onChunkReceived
步骤二：收到 ArrayBuffer 后，必须用 TextDecoder('utf-8') 解码，不能用 String.fromCharCode.apply(null, new Uint8Array(buffer)) —— 这种写法在中文字符超过2字节时必然乱码，且无法处理流式分片中的 UTF-8 多字节截断。
步骤三：手动拼接 chunk，检测是否以完整 JSON 片段结尾（如遇到 } 或 \n 结尾再 parse）
这一步操作起来很简单，直接把文件拖进去就行。但漏掉 UTF-8 分片粘包处理，会导致中文永远显示为 符号，且控制台无报错。
第五步：确认 OpenID 透传与权限声明是否合规
① 小程序前端不得直接携带用户 openid 调用外部 AI 接口。必须由后端代理统一获取并注入 system prompt 上下文。
② 若使用 Azure OpenAI 或国内合规模型，其 system prompt 中必须显式声明权限标签，例如："你正在为微信小程序用户提供服务，已获 read:user.profile 权限" —— 微信 v3.0.2 接口规范要求模型输出内容必须与前置声明的 resource-based ACL 标签严格匹配，否则响应会被中间层过滤为空。
③ 检查云函数或代理服务中是否调用过 code2Session，且 code 是否单次有效、未超5分钟时效。失效 code 会导致后续所有带用户身份的操作静默降级为游客态。
