企业官网建设流程全解析

1. 视频提取功能为什么卡在云函数这一层

微信小程序做视频提取，最容易踩的坑不是解析逻辑本身，而是请求链路。你在本地用 Python 或 Node 跑一个解析服务，浏览器里访问得好好的，一放进小程序就报request:fail url not in domain list，或者干脆提示域名必须 HTTPS。这不是代码写错了，而是小程序的网络请求有硬性约束：正式环境只允许请求已备案、已配置到后台白名单的 HTTPS 域名。

视频提取功能的核心动作其实很清晰：用户粘贴一条分享链接，服务端解析出无水印视频地址，小程序拿到地址后播放或下载。问题在于解析服务通常跑在自建服务器上，而小程序不能直接调用它。这时候云函数就成了最省事的中转层——小程序调云函数，云函数再去请求你的解析 API，返回结果给前端。整条链路绕开了域名白名单和 HTTPS 证书的麻烦，同时云函数天然支持 HTTPS 出站请求。

这篇面向已经写过基础小程序的开发者，重点讲三件事：云函数的目录结构怎么组织、config.json和 API 调用骨架怎么写、以及一次完整的视频链接解析与提取验证流程怎么跑通。你跟着做完，应该能拿到一个可用的视频提取链路，而不是停留在“知道原理”的阶段。

适合谁看：手里已经有一个能跑的小程序项目，想加视频提取功能，但对云函数和接口配置不太熟的开发者。如果你还没建过小程序项目，建议先把基础页面和云开发环境开起来再往下看。

2. TaoToken 前置：把模型调用和接口调试串起来

视频提取功能本身不一定要用大模型，但整个开发过程里有两处会用到 AI 能力：一是让 AI 帮你生成云函数骨架和排错，二是解析接口返回的字段结构不固定时，用模型做一次结构化整理。我习惯把这类调用统一走 TaoToken，省得每个服务单独配一套 Key。

TaoToken 是一个模型调用与 API 管理的入口，官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api 。它的作用是让你用一个 Key 就能调用多种模型，同时在控制台里看到每次请求的消耗和返回，调试接口时比较直观。

你需要提前准备的东西：

• 一个 TaoToken 账号，进入控制台创建 API Key，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite
• 如果只是调试模型返回，用模型对话页面就够了：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite
• 如果你打算长期用 AI 辅助写小程序代码，可以看 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite
• Key 管理页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite

拿到 Key 之后，先别急着写云函数。建议在模型对话页面里发一条测试请求，确认 Key 能用、返回正常。这一步花两分钟，能避免后面云函数报 401 时你分不清是 Key 问题还是代码问题。

注意：API Key 只放在云函数的环境变量或服务端配置里，不要写进小程序前端代码。小程序包是可以被反编译的，前端出现 Key 等于公开。

3. 云函数目录结构与 config.json 配置

云函数的目录结构决定了它能不能被正确部署和调用。微信云开发的云函数标准结构是这样的：

cloudfunctions/ └── videoExtract/ ├── index.js ├── package.json └── config.json

index.js是入口文件，package.json声明依赖，config.json用来配置云函数的权限和超时等参数。很多人忽略config.json，结果云函数请求外部接口时被拦，或者超时时间不够导致解析失败。

先看config.json的写法：

{ "permissions": { "openapi": [] }, "timeout": 20, "envVariables": { "TAOTOKEN_API_KEY": "你的Key", "EXTRACT_API_BASE": "https://your-domain.com" } }

这里有几个关键点。timeout设成 20 秒，是因为视频解析接口有时候响应慢，默认 3 秒很容易超时。envVariables里放的是环境变量，云函数运行时可以通过process.env读取，这样 Key 不会硬编码在代码里。permissions.openapi留空是因为我们不需要调用微信开放接口，只做外部 HTTP 请求。

package.json里需要声明 HTTP 请求库。云函数环境自带axios的情况不统一，稳妥做法是显式声明：

{ "name": "videoExtract", "version": "1.0.0", "dependencies": { "axios": "^1.6.0" } }

写完这两个文件后，在微信开发者工具里右键videoExtract目录，选择“上传并部署：云端安装依赖”。部署完成后，云函数列表里能看到它，状态是正常的。

这里有个容易踩的坑：config.json修改后必须重新部署才生效。我试过改完超时时间直接测试，结果还是按旧配置跑，排查了半天才发现是没重新上传。

4. 云函数 API 调用骨架与解析逻辑

云函数的核心逻辑分三步：接收小程序传来的分享链接、请求解析 API、把结果整理后返回。下面是一个可运行的骨架，你可以直接替换EXTRACT_API_BASE和字段名。

const cloud = require('wx-server-sdk'); const axios = require('axios'); cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV }); exports.main = async (event, context) => { const { shareLink } = event; if (!shareLink || typeof shareLink !== 'string') { return { code: 400, msg: '缺少分享链接' }; } const apiBase = process.env.EXTRACT_API_BASE; const apiKey = process.env.TAOTOKEN_API_KEY; try { const resp = await axios.post( `${apiBase}/api/video/download`, { url: shareLink }, { timeout: 15000, headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${apiKey}` } } ); const data = resp.data; if (!data || data.code !== 0) { return { code: 500, msg: '解析失败', detail: data }; } const videoInfo = data.data || {}; const playUrl = videoInfo.play_url || videoInfo.url || ''; const title = videoInfo.title || '未命名视频'; if (!playUrl) { return { code: 500, msg: '未获取到视频地址', detail: videoInfo }; } return { code: 0, msg: 'ok', data: { title, playUrl, cover: videoInfo.cover || '', duration: videoInfo.duration || 0 } }; } catch (err) { console.error('videoExtract error:', err.message); return { code: 500, msg: '请求解析服务失败', detail: err.message }; } };

这段代码里，event是小程序调用时传进来的参数，shareLink就是用户粘贴的分享链接。请求解析服务时带了Authorization头，如果你的解析服务不需要鉴权，可以去掉。返回结构统一成{ code, msg, data }，前端处理起来简单。

小程序端调用云函数的写法：

wx.cloud.callFunction({ name: 'videoExtract', data: { shareLink: '用户粘贴的分享链接' }, success: res => { const result = res.result; if (result.code === 0) { this.setData({ playUrl: result.data.playUrl, videoTitle: result.data.title }); } else { wx.showToast({ title: result.msg, icon: 'none' }); } }, fail: err => { console.error('云函数调用失败', err); wx.showToast({ title: '调用失败', icon: 'none' }); } });

前端拿到playUrl后，直接绑定到<video>组件的src属性就能播放。如果要下载到本地，需要用wx.downloadFile配合wx.saveVideoToPhotosAlbum，但下载的域名同样要在小程序后台配置合法域名，或者也走云函数中转。

5. 完整验证流程：从请求到结果返回

配置写完后，跑一次完整验证。步骤如下：

第一步，在微信开发者工具的云函数目录里，右键videoExtract，选择“本地调试”。本地调试可以让你在不上传的情况下测试逻辑，但环境变量需要在调试面板里手动填。

第二步，在调试面板的“测试参数”里填入：

{ "shareLink": "https://v.douyin.com/xxxxx/" }

第三步，点击“调用”，观察返回结果。如果返回code: 0并且data.playUrl是一个可访问的地址，说明链路通了。如果返回code: 500，看detail字段里的错误信息。

第四步，把云函数部署到云端，在小程序页面里真实操作一次：粘贴链接、点击解析、等待结果、点击播放。这一步能暴露本地调试发现不了的问题，比如环境变量没生效、超时时间不够、域名白名单没配。

实测下来，最常见的失败原因是解析服务返回的字段名和代码里写的不一致。比如有的服务返回video_url，有的返回play_url，代码里只取了一个就会拿到空值。解决办法是在云函数里做兼容：

const playUrl = videoInfo.play_url || videoInfo.video_url || videoInfo.url || '';

另外，如果解析服务本身需要先获取一个 token 再请求，那云函数里要加一步 token 获取逻辑，不能直接发解析请求。这个要看你的解析服务文档。

验证通过后，建议在云函数里加一行日志，记录每次解析的链接和结果状态，方便后面排查问题：

console.log('extract result:', { shareLink, code: data.code, hasUrl: !!playUrl });

6. 本篇常见错误排查

报错一：request:fail url not in domain list

这个错误通常出现在小程序前端直接请求解析 API 的时候。原因是解析 API 的域名没有配置到小程序后台的“request 合法域名”里。解决办法有两个：一是把域名配到后台白名单，但要求域名已备案且支持 HTTPS；二是走云函数中转，前端只调云函数，不直接请求外部 API。推荐第二种，省去备案和证书的麻烦。

报错二：云函数返回code: 500，detail显示timeout of 15000ms exceeded

解析服务响应太慢，超过了云函数里设置的timeout。先确认config.json里的timeout是否大于 axios 的timeout，两者要匹配。如果解析服务本身就需要 20 秒以上，那要考虑换服务或者做异步处理。另外，云函数的超时上限和套餐有关，免费版通常最多 20 秒，超出要升级。

报错三：Cannot find module 'axios'

云函数部署时没有安装依赖。检查package.json里是否声明了axios，然后重新上传并选择“云端安装依赖”。如果本地node_modules里有但云端没有，说明上传时没勾选安装依赖选项。

报错四：返回code: 0但playUrl为空

解析服务返回了结果，但字段名和代码里取的不一致。把detail里的原始返回打印出来，对照字段名修改取值逻辑。常见字段有play_url、video_url、url、download_url，做一层兼容取值。

报错五：小程序端调用云函数报cloud function execution error

云函数内部抛了未捕获的异常。检查index.js里是否有try/catch包住主逻辑，以及cloud.init是否在入口处调用。另外，云函数名称要和wx.cloud.callFunction里的name完全一致，大小写敏感。

如果排查过程中需要确认模型返回或接口调试，可以到模型对话页面发一条测试请求：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。如果是要长期做小程序开发、频繁让 AI 生成代码和排错，Coding Plan 会更顺手：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。Key 的管理和新建在 API Keys 页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。接入文档里有完整的请求示例和参数说明：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

最后补一个实用技巧：云函数的环境变量在本地调试时不会自动读取config.json里的配置，需要在调试面板手动填。部署到云端后才会按config.json生效。这个差异导致很多人本地测试通过、线上失败，排查时先确认环境变量是否在两边都正确设置。