微信小程序接入ChatGPT全流程指南：从注册到实战避坑

2次阅读

没有评论

共计 3484 个字符，预计需要花费 9 分钟才能阅读完成。

微信小程序作为一个封闭的生态，与外部 API 集成时存在一些特殊限制。以下是几个主要挑战：

HTTPS 强制要求 ：微信小程序要求所有网络请求必须使用 HTTPS 协议
域名白名单 ：所有请求的域名必须预先在小程序后台配置
5 秒响应限制 ：微信服务器会强制断开超过 5 秒未响应的请求
流式响应兼容性 ：小程序原生不支持 Server-Sent Events(SSE)

直接前端调用 ChatGPT API 存在几个明显问题：

API 密钥暴露风险
无法绕过 5 秒响应限制
难以实现敏感内容过滤

因此推荐使用服务端中转方案，具体优势如下：

保护 API 密钥安全
可以缓冲流式响应
便于添加业务逻辑（如审核、日志等）
不受微信域名限制

// 微信登录校验示例
const auth = async (code) => {
  const appId = '你的小程序 AppID';
  const appSecret = '你的小程序 AppSecret';

  const response = await axios.get(`https://api.weixin.qq.com/sns/jscode2session?appid=${appId}&secret=${appSecret}&js_code=${code}&grant_type=authorization_code`
  );

  if(response.data.openid) {
    // 生成 JWT token
    const token = jwt.sign({
      openid: response.data.openid,
      exp: Math.floor(Date.now() / 1000) + (60 * 60 * 24) // 24 小时有效期
    }, '你的 JWT 密钥');

    return token;
  }
};

// OpenAI API 调用封装
const callChatGPT = async (prompt, openid) => {
  try {
    const response = await axios.post(
      'https://api.openai.com/v1/chat/completions',
      {
        model: 'gpt-3.5-turbo',
        messages: [{role: 'user', content: prompt}],
        stream: true // 启用流式响应
      },
      {
        headers: {'Authorization': `Bearer ${process.env.OPENAI_KEY}`,
          'Content-Type': 'application/json'
        },
        responseType: 'stream'
      }
    );

    return response.data;
  } catch (error) {
    // 错误重试逻辑
    if(error.response?.status === 429) {await new Promise(resolve => setTimeout(resolve, 1000));
      return callChatGPT(prompt, openid);
    }
    throw error;
  }
};

// 微信小程序端消息管理
const chatContext = {messages: [],

  addMessage(role, content) {this.messages.push({role, content});
    wx.setStorageSync('chatHistory', this.messages);
  },

  getContext() {return wx.getStorageSync('chatHistory') || [];},

  clear() {this.messages = [];
    wx.removeStorageSync('chatHistory');
  }
};

解决方案是分阶段响应：

先立即返回一个接收确认
后台继续处理请求
通过 WebSocket 或定时轮询返回结果

// 模拟流式响应
const simulateStream = (res, openid) => {
  let fullResponse = '';

  return new Promise((resolve) => {res.on('data', (chunk) => {const lines = chunk.toString().split('\n').filter(line => line.trim() !== '');

      for (const line of lines) {const message = line.replace(/^data: /, '');
        if (message === '[DONE]') {resolve(fullResponse);
          return;
        }

        try {const parsed = JSON.parse(message);
          if(parsed.choices[0].delta.content) {fullResponse += parsed.choices[0].delta.content;
            // 通过 WebSocket 发送到小程序端
            wsServer.sendToUser(openid, {
              type: 'stream',
              content: parsed.choices[0].delta.content
            });
          }
        } catch (err) {console.error('解析错误:', err);
        }
      }
    });
  });
};

// 敏感词过滤 +OpenAI Moderation
const checkContentSafety = async (text) => {
  // 本地敏感词过滤
  const localBlacklist = ['敏感词 1', '敏感词 2'];
  if(localBlacklist.some(word => text.includes(word))) {return false;}

  // 调用 OpenAI Moderation API
  try {
    const response = await axios.post(
      'https://api.openai.com/v1/moderations',
      {input: text},
      {headers: { 'Authorization': `Bearer ${process.env.OPENAI_KEY}` } }
    );

    return !response.data.results[0].flagged;
  } catch (error) {console.error('审核 API 错误:', error);
    return false; // 审核失败时默认拦截
  }
};

// 基于 OpenID 的数据隔离
const getUserSpecificData = (openid) => {
  // 使用 openid 作为数据库查询条件
  return db.collection('chatHistory')
    .where({openid})
    .orderBy('timestamp', 'desc')
    .limit(20)
    .get();};

额度耗尽问题 ：
实现 API 调用限流
监控 Token 使用情况
设置备用 API 密钥
长文本截断 ：
自动拆分长文本为多段
提示用户输入更简洁
使用 gpt-3.5-turbo-16k 等支持更长上下文的模型
冷启动延迟 ：
保持服务常驻内存
实现预热机制
使用云函数时选择常驻实例

可以利用微信用户画像增强回复相关性：

分析用户历史聊天记录
结合用户基本信息（如地区、性别）
使用 embedding 技术建立用户兴趣模型
在 prompt 中加入个性化上下文

// 个性化 prompt 构造
const buildPersonalizedPrompt = (userInfo, message) => {
  return ` 用户特征:
- 地区: ${userInfo.region || '未知'}
- 性别: ${userInfo.gender || '未知'}
- 历史兴趣: ${userInfo.interests?.join(',') || '无'}

请根据以上信息，用 ${userInfo.gender === '男' ? '简洁' : '详细'} 的风格回答:
${message}`;
};

通过本文的完整实现方案，开发者可以快速在微信小程序中集成 ChatGPT 功能，同时规避常见的性能和安全性问题。关键在于：