| title | 腾讯云 CloudBase 入门 |
|---|
RentHub 的后端完全运行在腾讯云 CloudBase上。这篇文档会帮你建立一个清晰的框架——CloudBase 到底帮我们做了什么，以及它的五大核心能力分别是什么。
官方文档：快速开始
传统开发需要自己租服务器、安装数据库、写接口……CloudBase 把这些全部打包成“开箱即用的云服务”，让你只关注业务逻辑，不用操心基础设施。
一句话总结：
CloudBase = 数据库 + 函数 + 托管 + 存储 + 登录，全部在云端，按需调用。
RentHub 的小程序直接通过微信的 wx.cloud SDK 调用这些服务，不需要自己搭 API 服务器。
云函数分层、与小程序的联调及仓库脚本约定，在读完本章后建议对照 RentHub 业务仓库开发工作流 与本文 云函数 一节。
你可能听说过 Excel 或 MySQL——那是“表格型”数据库，数据整整齐齐排成行和列。
文档型数据库（CloudBase 用的是 MongoDB 风格）则把每条数据存成一个JSON 对象，叫做“文档”。好处是结构灵活——同一个集合里不同文档可以有不同字段。每当需要补充新的数据的时候，只需要在这篇文档的末尾加上新的字段即可。
// 一条「上架物品」（asset）文档的例子
{
"_id": "asset_001",
"title": "工业手电钻（含电池充电器）",
"price": 45,
"pricingUnit": "day",
"tags": ["可自提", "押金可退"],
"owner": "user_123"
}| 概念 | 类比 Excel | 说明 |
|---|---|---|
| 数据库（Database） | 整个 Excel 文件 | 一个环境下可建多个数据库 |
| 集合（Collection） | 一张工作表 | 存放同类数据，如 assets、orders |
| 文档（Document） | 一行数据 | 一条记录，格式为 JSON |
| 字段（Field） | 一列 | 文档里的每个 key |
RentHub 的主要集合包括 users（用户）、assets（资产）、orders（订单）、messages（消息）等。
在小程序端，读取数据的代码大概长这样：
const db = wx.cloud.database();
const result = await db.collection('assets').where({ status: 'available' }).get();
console.log(result.data); // 返回所有可用资产深入阅读：CloudBase 数据库官方文档
想象一下：你雇了一个助手，每次你交给他一个任务（发送请求），他处理完就把结果还给你，然后消失——你不用管他住在哪里、用什么电脑工作。
云函数就是这样的助手。你写一段 Node.js 代码上传到云端，需要时“调用”它，它运行、返回结果，然后自动释放资源。你不需要维护服务器。
有些操作不能直接在小程序前端做，比如：
- 操作其他用户的数据（权限控制）
- 调用第三方 API（需要隐藏密钥）
- 复杂的业务逻辑（如订单状态流转）
- 涉及支付逻辑
- 发送模板消息
这些都放在云函数里执行，更安全、更可控。
RentHub 按业务域划分云函数：
| 云函数 | 职责 |
|---|---|
user |
用户注册、登录、信息更新 |
asset |
上架物品发布、编辑、下架 |
order |
下单、取消、状态流转 |
message |
消息发送与通知 |
admin |
管理后台专用操作 |
help |
帮助与客服相关 |
调用云函数的代码示例：
const res = await wx.cloud.callFunction({
name: 'asset', // 云函数名称
data: { // 传给云函数的参数
action: 'create',
title: '露营帐篷四人款',
price: 120,
},
});
console.log(res.result); // 云函数返回的结果在业务仓库里，各云函数（如 order、user、breach、insurance 等）建议采用统一的目录与职责划分，并按需调整执行超时：可在 cloudfunctions/<名称>/config.json 与云开发控制台中配置，避免调用第三方接口等耗时场景下默认时限过短导致失败。
| 路径 | 职责 | 说明 |
|---|---|---|
| index.js | 入口与路由 | 仅负责 cloud.init、exports.main，根据 event.action 分发到对应 handler；不写业务逻辑。 |
| handlers/ | 动作处理 | 每个 action 对应处理函数：校验入参、调用 services 与数据库、返回统一结构 { success, data?, message? }。 |
| services/ | 业务逻辑 | 纯计算、规则与流程编排；不直接依赖 wx-server-sdk，便于单测。 |
| utils/ | 通用工具 | 配置读取、安全校验、第三方 SDK 封装等，供 handlers 与 services 复用。 |
| constants.js | 常量 | 状态码、错误码、配置键名等集中定义。 |
这样划分，首先是把云环境、路由与可单独验证的业务规则拆开：services/ 不绑 wx-server-sdk，在普通 Node 环境里即可 require 编写、导出并跑单元测试，不必为每条规则起整套云函数。handlers/ 只管「接 action、校验、调 services/库、组返回」，变更某个动作时影响面小，长期维护更可控。各目录职责单一、边界清楚，符合原子化思路——每个模块只做一类事，再组合成完整调用链，避免「一个大文件里什么都写」带来的耦合。
约定：index.js 只做「解析 event → 调用 handler → 返回结果」；新增 action 时在入口注册，并委托给 handlers/ 下的实现。
cloudfunctions/order/
├── index.js
├── constants.js
├── handlers/
│ ├── order.js
│ ├── payment.js
│ ├── renewal.js
│ ├── evidence.js
│ ├── callback.js
│ └── admin.js
├── services/
│ ├── deliverySubsidy.js
│ └── settlement.js
└── utils/
深入阅读：CloudBase 云函数官方文档
云函数适合短时间运行的任务（几秒内完成）。但如果你有一个持续运行的服务——比如 RentHub 的 Web 管理后台——就需要“云托管”。
云托管本质上是容器化的服务器：你把代码打包成 Docker 镜像，上传后腾讯云帮你运行、自动扩缩容、处理流量。你依然不用维护物理服务器。
| 对比维度 | 云函数 | 云托管 |
|---|---|---|
| 运行时长 | 短（通常 < 30s） | 可持续运行 |
| 适合场景 | 单次操作、事件触发 | HTTP API、长连接 |
| 技术形式 | 单个 JS 文件 | Docker 容器 |
| 冷启动 | 有（首次调用稍慢） | 可保持常驻 |
RentHub 的 Web 管理后台后端接口部署在云托管上。
深入阅读：CloudBase 云托管官方文档
用来存放文件——图片、PDF、视频等。数据库存的是结构化数据（JSON），而图片这样的二进制文件太大，不适合放在数据库里，应该放在云存储中。
每个上传的文件会得到一个唯一的 fileID（云文件地址），可以保存到数据库，需要时用这个 ID 下载或生成临时链接。
资产图片、用户头像、合同附件、实名认证照片等都存在云存储中：
// 上传图片
const uploadResult = await wx.cloud.uploadFile({
cloudPath: `assets/${Date.now()}.jpg`, // 存储路径
filePath: tempFilePath, // 本地临时路径
});
const fileID = uploadResult.fileID; // 拿到云端 ID，存入数据库
// 获取临时访问链接（有效期有限）
const { fileList } = await wx.cloud.getTempFileURL({
fileList: [fileID],
});
console.log(fileList[0].tempFileURL);深入阅读：CloudBase 云存储官方文档
任何有用户系统的应用都需要解决两个问题：
- 你是谁？（Authentication / 认证）——用户登录，证明自己的身份
- 你能做什么？（Authorization / 授权）——控制不同用户的操作权限
CloudBase 支持多种登录方式，RentHub 主要使用：
| 登录方式 | 适用端 | 说明 |
|---|---|---|
| 微信登录 | 小程序 | 用户一键授权，无需输密码，最常用 |
| 自定义登录 | Web 管理后台 | 后台管理员用账号密码登录 |
微信小程序登录的流程比较特殊，简化版如下：
用户打开小程序
↓
wx.login() 获取临时 code
↓
云函数用 code 换取用户的 openid（微信用户唯一标识）
↓
用 openid 在数据库查找或创建用户记录
↓
返回登录状态，用户进入应用
CloudBase 在微信小程序环境下会自动帮你处理大部分认证流程，你只需要在数据库权限中配置“仅创建者可读写”之类的规则，CloudBase 会自动比对当前登录用户。
CloudBase 数据库有四种权限模式：
| 权限模式 | 说明 |
|---|---|
| 仅创建者可读写 | 只有数据的创建者能操作，适合用户私有数据 |
| 所有用户可读，仅创建者可写 | 适合公开展示但只能自己编辑的内容（如上架物品） |
| 所有用户可读写 | 完全公开，慎用 |
| 仅管理端可读写 | 只有云函数（服务端）能操作，最安全 |
RentHub 的敏感操作（如修改订单状态）都通过云函数以管理员身份执行，绕过前端权限限制，确保安全。
深入阅读：CloudBase 登录鉴权官方文档
| 能力 | 解决什么问题 | RentHub 中的用途 |
|---|---|---|
| 文档型数据库 | 存储结构化业务数据 | 用户、上架物品、订单、消息 |
| 云函数 | 安全执行服务端逻辑 | 业务操作、第三方 API 调用 |
| 云托管 | 运行持续性后端服务 | 管理后台 API |
| 云存储 | 存放图片等文件 | 物品展示图、用户头像 |
| 身份验证 | 管理用户登录与权限 | 微信一键登录、数据访问控制 |
- CloudBase 控制台入口：console.cloud.tencent.com/tcb