微信小程序接入AI，这些坑和捷径你必须知道

小程序里塞AI，听起来挺酷，做起来全是坑。我最近帮三个团队搞过这事，从踩坑到填坑，攒了一肚子话。今天不聊虚的，全是真金白银换来的经验，你听完能少走俩月弯路。

第一个坑，也是最常见的，很多人一上来就想着把大模型API直接嵌进小程序。结果呢？审核被拒、请求超时、流量费爆表。为啥？微信小程序的request域名必须备案且HTTPS，你直接调OpenAI或者某些国内大模型的接口，域名白名单过不去。更别说那些模型响应动辄两三秒，用户早划走了。捷径是啥？搭一层自己的后端，用云函数或者轻量服务器转发请求，既能控制域名，还能在中间层做缓存、限流、鉴权。别嫌麻烦，这层皮必须得扒。

第二个坑藏在数据格式里。你以为AI返回的是纯文本？错。现在主流模型都爱返回Markdown或者JSON，小程序里的rich-text组件对Markdown支持稀烂，你直接渲染出来就是一堆井号和星号。我见过有个团队做AI写文案，用户端看到的全是“## 标题”这种鬼东西，用户当场骂娘。解法：后端统一把模型输出转成HTML或者小程序原生的nodes数组，用towxml这类库也行，但别在客户端做转换，性能扛不住。记住，AI只管生成，格式化是你的事。

第三个坑，也是最阴的——上下文管理。小程序这破环境，全局变量说没就没，用户切个后台再回来，你的对话上下文全丢了。你辛辛苦苦让AI记住用户偏好，结果一次冷启动全白搭。捷径：用wx.setStorageSync做本地持久化，但注意别存太大，单个key别超过1MB。更稳的做法是把对话历史同步到你自己的服务器，用户回来时从服务端拉取。别指望微信帮你存东西，它连你的登录态都可能给你清掉。

还有个坑特别容易忽略——支付和AI的结合。你想做个AI付费咨询，用户在小程序里付完钱，结果回调里拿不到用户买了啥，因为微信支付回调里只有prepay_id和out_trade_no，你得自己维护订单和AI服务的关系。我见过最惨的，用户付了钱，AI服务没开通，客服被骂到自闭。解法：支付成功后不要急着发AI服务，先更新订单状态，再触发服务开通，用云开发数据库的事务功能，或者用消息队列保证最终一致性。千万别在回调里直接调AI接口，超时你就知道什么叫绝望。

然后说性能优化，这坑能磨死你。小程序包体积限制2MB，你塞个AI相关的SDK可能就占掉几百KB。更关键的是，AI请求的加载状态必须处理好，否则用户以为卡死了。捷径：用分包加载，把AI相关功能单独放一个分包，用户用到时才下载。同时，请求时给个假进度条，或者先返回一部分结果再流式补充，用户感知会好很多。我还试过用WebSocket做流式输出，效果比普通request好太多，但注意小程序后台运行时WebSocket会被掐断，得配合onShow重新建立连接。

再说个大多数人不知道的——AI能力别全用大模型。很多场景，比如关键词提取、情感判断、文本分类，用微信自带的基础库或者一些轻量规则就能搞定，根本不用调API，省时省力还省钱。我之前帮一个做心理咨询的团队，他们想用AI判断用户情绪，我直接用关键词词典加简单分类器，准确率80%以上，响应速度毫秒级，成本几乎为零。大模型不是万能的，什么时候该用，什么时候不该用，你自己心里得有杆秤。

也是我最想强调的——别忽略微信的审核政策。AI生成内容在小程序里是重点审核对象，你稍微有点敏感词，或者生成的内容涉及医疗、金融、法律这些领域，审核直接给你打回。捷径：在AI生成环节前加一层内容安全检测，用微信官方的内容安全API，或者自己接个敏感词过滤。别抱侥幸心理，我见过有个团队做AI算命，上线三天就被封了，原因就是用了“改运”“消灾”这类词，直接被判定为封建迷信。这红线，碰一次就够你喝一壶的。

说回标题那句话，这些坑和捷径，你听完是不是觉得心里有底了？其实说白了，小程序接AI，难点不在AI，而在小程序这个环境的各种限制。你把它当成一个受限的客户端，所有事情都在后端处理好，前端只负责展示和交互，就成功了一大半。别追求什么纯端侧AI，在小程序里不现实，至少目前是这样。你把这些经验消化了，再去动手，能省下的不仅是时间，还有你的头发。