小程序云函数调用注意教程｜超时、权限与环境隔离清单 – MPForge

一、先划边界：云函数和自有服务器怎么分工

结论先记住：云函数与自有服务器可以并存，关键是把边界写清——轻量业务逻辑上云函数，支付回调等高可靠链路先评估再定。

云函数省运维、和云数据库云存储天然连通，适合表单提交、列表查询、素材处理这类常规业务。但高可靠链路要另想：支付回调、库存扣减这类强一致场景，函数的超时机制与重试语义未必符合预期，先评估再选型，别因为「省事」把核心链路也搬上去。自有服务器与云函数并存时，用统一的接口网关或明确的调用约定切开，避免出现两边都改、两边都不知道谁在跑的混沌状态。

二、开工前备齐四样材料

环境列表、权限角色、资源配置、密钥保管，四样不齐就会在联调阶段反复返工。

• 环境列表：开发、测试、生产各建独立云环境，环境 ID 写进项目文档，测试环境与生产环境的 ID 相似度越低越好，防呆从命名开始。
• 权限角色：谁能部署生产环境、谁只读日志，按人配置，不用一个管理员账号全员共用。
• 超时与内存配置：每个函数单独设定，写清依据（如「导出任务 20 秒、查询接口 3 秒」），不搞全局一个值。
• 密钥保管：第三方密钥放云函数的环境变量或配置中心，禁止硬编码进代码提交仓库。

三、落地步骤：从环境拆分到联调验收

顺序不能乱：环境先隔离、职责先拆清、超时重试再定、日志脱敏收尾。按这五步走：

1. 按环境拆配置：开发与生产的数据库集合、存储目录、密钥全部隔离，前端按版本读取对应环境 ID，杜绝一套配置通吃。
2. 单函数职责清晰：一个函数只做一件事，命名见名知义；超过 500 行的函数就要考虑拆分，别养出「万能函数」。
3. 设合理超时与重试：查询类 3 秒内、文件处理类单独放宽；失败重试参考 小程序请求重试策略，超时设过长只会掩盖问题，不会解决问题。
4. 日志脱敏：日志记请求标识、错误码与耗时，不落手机号、unionid 明文与完整报文，出问题能排查又不泄露用户数据。
5. 本地与云端联调：列一张联调清单：本地调用、真机调用、生产环境各过一遍，云数据库权限口径见 小程序云数据库注意事项。

四、权限收紧：最小权限是底线

结论：前端直调云函数必须按「不可信」设计——权限默认拒绝，按需开放。

一条铁律：前端传来的任何「我是谁」字段都不可信，身份以云函数运行时提供的上下文为准。云存储的使用口径见 小程序云存储注意事项，安全检测整体要求见 小程序安全检测清单。

五、线上翻车点

结论：云开发项目的翻车点集中在三条——前端直调带强权限、超时过长掩盖故障、环境误发生产。

• 前端直调带强权限：管理员功能直接暴露给前端调用，被人抓包遍历就是数据泄露，管理动作必须收进服务端鉴权。
• 超时设过长掩盖问题：超时从 3 秒放宽到 60 秒，报表「通过率」好看了，用户体验烂了；超时拉长前先查慢查询。
• 环境误发生产：测试数据写进生产库、生产密钥用在测试脚本，轻则脏数据重则资损；部署脚本里加环境确认提示，发布流程走 小程序 CI 自动化上传 固化。

上线前整体自检对照 小程序上线发布检查清单 过一遍，云函数的环境与权限两项单独列验收。

六、避坑清单

这三条坑都和「图省事」有关：省运维别省隔离，省代码别省校验。

• 别把云函数当单体用：万能函数改一处动全身，发布风险与排查成本随体积指数上涨。
• 别在冷启动上过度纠结：常规业务用预热与请求合并即可缓解，真到了性能瓶颈再评估接入自有服务。
• 别用生产环境调试：调试一律在开发环境完成，生产环境只跑已验证版本，这条写进团队规范。
• 别把密钥写进代码仓库：换密钥要改代码重新部署，泄露要全员通知，环境变量一次到位。

七、常见问题 FAQ