DeepSeek接入微信小程序指南

本文详细介绍了如何通过微信云函数安全、稳定地将DeepSeek大模型能力集成到微信小程序中，重点解决了前端无法直接调用DeepSeek API的跨域与密钥泄露难题；涵盖API密钥配置、Node.js云函数开发与HTTPS请求封装、权限与出网策略设置、小程序端调用及响应解析全流程，并特别强调禁用流式响应、设置15秒超时、完善错误处理等关键实践细节，助开发者零基础快速落地AI对话功能。

如果您希望在微信小程序中集成DeepSeek大模型能力，但无法直接从前端发起跨域请求，则需要借助微信云开发的云函数作为中间层来调用DeepSeek提供的API接口。以下是实现该对接的具体步骤：

一、配置DeepSeek API密钥与请求参数

DeepSeek API要求每次请求携带有效的Authorization头和指定的Content-Type，且需明确模型名称与消息格式。云函数运行环境可安全存储密钥，避免前端暴露敏感信息。

1、登录DeepSeek官方平台，进入API Keys管理页面，创建一个新的Secret Key。

2、在微信云开发控制台中，进入“云函数”页面，点击“新建云函数”，输入函数名如callDeepSeek并完成创建。

3、在云函数根目录下的config.json或环境变量中，设置DEEPSEEK_API_KEY为刚生成的密钥值，确保不提交至代码仓库。

4、确认DeepSeek当前支持的模型ID（如deepseek-chat），并在后续请求体中准确填写。

二、编写云函数调用逻辑

云函数需使用Node.js发起HTTPS请求至DeepSeek API地址，并正确构造请求头与JSON载荷。推荐使用node-fetch或原生https模块，避免引入不兼容依赖。

1、在云函数本地目录执行npm init -y初始化包管理文件。

2、运行npm install node-fetch安装网络请求库（若使用云开发基础版，请改用内置cloud.downloadFile不适用场景，此处必须用https原生模块）。

3、编辑index.js，引入https模块，定义POST请求选项，包含hostname为api.deepseek.com、path为/v1/chat/completions、method为POST。

4、在exports.main中解析小程序端传入的content字段，组装为符合OpenAI兼容格式的messages数组，例如[{"role":"user","content":"你好"}]。

5、将Authorization头设为Bearer 您的Secret Key，Content-Type设为application/json，并将完整请求体转为字符串写入req.write。

三、部署云函数并设置权限

微信云函数默认仅允许管理员调用，需显式开放给小程序端调用权限，同时确保出网策略允许访问外部HTTPS服务。

1、在云开发控制台选中callDeepSeek函数，点击“更多 > 函数配置”，将“调用来源”设为“所有小程序”或指定AppID。

2、进入“安全配置 > 出网访问”，开启“允许云函数访问公网”，否则请求将被拦截。

3、在本地终端执行cloudbase functions deploy callDeepSeek --region ap-guangzhou（请替换为实际地域）完成部署。

4、部署完成后，在控制台“日志”页查看首次调用输出，确认https.request未抛出ENOTFOUND或ECONNREFUSED错误。

四、小程序端发起云函数调用

小程序需通过wx.cloud.callFunction触发已部署的云函数，并将用户输入封装为data参数传递，等待返回结构化响应。

1、在小程序页面JS文件中，确保已执行wx.cloud.init并指定正确的环境ID。

2、绑定按钮事件，调用wx.cloud.callFunction，name设为callDeepSeek，data对象中包含content字段（如{ content: "解释量子纠缠" }）。

3、在success回调中，从res.result.choices[0].message.content提取模型返回文本，注意捕获res.result.error判断API是否返回业务错误。

4、将提取结果赋值给页面data中的responseText字段，并通过setData更新WXML视图显示。

五、处理流式响应与超时控制

DeepSeek API支持stream=true参数返回SSE流式数据，但微信云函数不支持分块传输编码响应；因此必须禁用流式，采用完整响应模式，并主动设置超时防止长时间阻塞。

1、在云函数请求选项中添加timeout: 15000（单位毫秒），避免默认超时过长影响小程序体验。

2、在https.request的req.on('timeout')事件中调用req.destroy()并返回{ error: "request timeout" }。

3、检查DeepSeek响应状态码：非200时读取res的data事件流，解析error.message字段，例如"Invalid API key"或"Model not found"。

4、在小程序端fail回调中判断err.errMsg是否含cloud.callFunction:fail，提示用户检查网络或稍后重试。

理论要掌握，实操不能落！以上关于《DeepSeek接入微信小程序指南》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！