云函数发http请求须用axios或node-fetch，禁用fetch；需配置公网访问、超时及必要headers；参数通过event.data接收，敏感信息存环境变量；函数目录结构和unicloud.init调用时机必须正确。
云函数里怎么发 HTTP 请求？别用 fetch，用 axios 或 node-fetch
uniCloud 云函数运行在 Node.js 环境（阿里云为 Node.js 14+，腾讯云为 Node.js 16+），但默认不支持 fetch（原生无此 API），也不能直接用浏览器版的 XMLHttpRequest。必须引入兼容的 HTTP 客户端库。
推荐用 axios（最稳）或 node-fetch（轻量）。不要写 require('http') 手动拼接——容易漏 header、超时、重定向等细节，且阿里云/腾讯云默认禁止外网出方向，需额外开通白名单（见下文）。
-
package.json中必须声明依赖，例如：{"dependencies": {"axios": "^1.7.2"}} - 入口文件
index.js顶部加const axios = require('axios'); - 调用时用
await axios.get(event.url)或await axios.post(event.api, event.data)，别忘了try/catch - 返回值必须是 JSON 序列化安全的对象：不能含
Date、Function、undefined、Buffer；建议统一返回{ code: 200, data: ... }格式
外部 API 调用失败常见原因：网络策略、超时、CORS 不是问题
前端开发者常误以为 “跨域” 是云函数调外部 API 的障碍——其实不是。云函数跑在服务端，根本不存在浏览器 CORS 限制。真正卡住你的通常是以下三点：
- 阿里云/腾讯云默认禁用外网出方向：必须登录控制台，在「云函数 → 安全配置」中开启「允许访问公网」（阿里云叫“公网访问”，腾讯云叫“VPC 公网访问”）
- 没设超时：第三方接口响应慢时，云函数默认 15 秒超时（阿里云）或 60 秒（腾讯云），建议显式加
timeout: 10000 - 没传必要 header：比如某些 API 要求
Authorization或User-Agent，漏掉就 401/403；axios默认不带，得手动配headers: { 'User-Agent': 'uniCloud' } - HTTPS 证书校验失败（少见但存在）：若对方用自签名证书，可临时加
httpsAgent: new https.Agent({ rejectUnauthorized: false })（仅测试用，上线前务必移除）
uniCloud.callFunction 怎么传参给云函数？event.data 是唯一入口
前端调用 uniCloud.callFunction 时，所有参数都塞进 data 字段，最终变成云函数 event.data。它不是 req.body，也没有 event.queryString 或 event.headers ——那些是传统 HTTP 框架概念，云函数不提供。
- 正确写法：
uniCloud.callFunction({ name: 'weather-api', data: { city: 'shanghai', units: 'c' } }) - 云函数内接收：
const { city, units } = event.data;（解构安全，event.data可能为null或{}） - 别写
event.body或event.query——它们不存在，读出来一定是undefined - 敏感参数（如 API key）绝不能从前端传！应存于云函数后台环境变量（阿里云叫「环境变量」，腾讯云叫「Secrets」），用
process.env.API_KEY读取
本地调试 vs 线上部署：路径和初始化最容易翻车
本地能跑通，上传后报 Function not found 或 uniCloud is not initialized？八成是目录或初始化问题。
- 云函数必须放在项目根目录下的
cloudfunctions文件夹里，且每个函数是一个独立子目录，例如：cloudfunctions/weather-api/index.js -
index.js是唯一入口，名字不能改（不接受main.js或handler.js） - 前端首次调用前，必须执行
uniCloud.init({ provider: 'aliyun' })（阿里云填aliyun，腾讯云填tcb），否则直接报错 - HBuilderX 里右键云函数目录 → 「上传部署为云函数」，不是「上传所有」——后者会清空线上已有函数
- 本地调试时，HBuilderX 会自动注入
uniCloud对象；真机运行时，必须确保uniCloud.init在App.vue的onLaunch中执行一次
event.data 和 process.env 的边界在哪——这些地方没填对，函数就永远卡在“请求发不出去”或“参数收不到”。大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
