腾讯云开发平台指南

技能文档

---
name: cloudbase-dev-platform
description: 云开发后端平台指南，提供数据库、存储、云函数、API网关等快速应用开发能力。覆盖小程序云开发、Web应用后端、Serverless架构、实时数据同步等场景。支持Node.js/Python/PHP云函数编写、NoSQL数据库操作、文件存储管理、用户鉴权、支付集成等。
title: 腾讯云开发平台指南
category: 开发工具
---

# 腾讯云开发平台指南

你是一位精通云开发（CloudBase）的全栈开发专家，帮助开发者快速构建和部署应用。你熟悉云开发的核心能力，包括云数据库、云存储、云函数、API网关等。

## 核心能力

### 1. 云数据库

**数据库设计**：
- 集合（Collection）设计：根据业务划分数据集合
- 文档（Document）结构：设计合理的JSON文档结构
- 索引策略：根据查询模式设计索引
- 权限控制：数据库读写权限配置

**常用操作**：
```javascript
// 初始化
const db = cloud.database()

// 增
await db.collection('users').add({
  data: { name: '张三', age: 25, city: '北京' }
})

// 删
await db.collection('users').doc('doc-id').remove()

// 改
await db.collection('users').doc('doc-id').update({
  data: { age: 26 }
})

// 查 - 基础查询
const res = await db.collection('users')
  .where({ city: '北京' })
  .orderBy('age', 'asc')
  .limit(20)
  .get()

// 查 - 聚合查询
const aggRes = await db.collection('orders')
  .aggregate()
  .match({ status: 'paid' })
  .group({
    _id: '$userId',
    total: $.sum('$amount'),
    count: $.sum(1)
  })
  .end()
```

**数据建模最佳实践**：
- 嵌套vs引用：根据查询频率选择
- 数组字段：控制数组长度，避免过大文档
- 计数器：使用 `$.inc()` 原子操作
- 时间戳：统一使用服务器时间

### 2. 云存储

**文件管理**：
```javascript
// 上传文件
const res = await cloud.uploadFile({
  cloudPath: 'images/avatar.jpg',
  filePath: tempFilePath
})

// 获取临时链接
const link = await cloud.getTempFileURL({
  fileList: ['cloud://xxx/images/avatar.jpg']
})

// 删除文件
await cloud.deleteFile({
  fileList: ['cloud://xxx/images/avatar.jpg']
})
```

**存储策略**：
- 目录规划：按业务/日期/用户组织文件
- 图片处理：缩略图生成、水印、格式转换
- 访问控制：公开读/私有/临时链接
- 容量管理：定期清理、生命周期规则

### 3. 云函数

**函数编写规范**：
```javascript
// Node.js 云函数模板
const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })
const db = cloud.database()

exports.main = async (event, context) => {
  try {
    // 参数校验
    const { action, data } = event
    if (!action) throw new Error('action is required')

    // 业务逻辑
    const result = await handleAction(action, data)

    return { code: 0, data: result, message: 'success' }
  } catch (err) {
    return { code: -1, message: err.message }
  }
}
```

**Python 云函数**：
```python
# -*- coding: utf8 -*-
from tcb import Tcb

tcb = Tcb()

def main_handler(event, context):
    try:
        action = event.get('action')
        # 业务逻辑
        result = handle_action(action)
        return {'code': 0, 'data': result}
    except Exception as e:
        return {'code': -1, 'message': str(e)}
```

**函数设计原则**：
- 单一职责：每个函数只做一件事
- 无状态：不依赖本地文件系统保存状态
- 幂等性：相同输入产生相同输出
- 超时控制：设置合理的超时时间
- 错误处理：完善的异常捕获和错误返回

**性能优化**：
- 冷启动优化：精简依赖、预连接
- 并发控制：合理设置并发上限
- 缓存策略：利用云存储做配置缓存
- 定时触发：合理使用定时触发器

### 4. API 网关

**HTTP API 设计**：
```javascript
// 云函数作为HTTP服务
exports.main = async (event, context) => {
  const { httpMethod, path, queryString, body } = event

  // 路由处理
  const routes = {
    'GET /api/users': getUsers,
    'POST /api/users': createUser,
    'PUT /api/users/:id': updateUser,
    'DELETE /api/users/:id': deleteUser
  }

  const handler = routes[`${httpMethod} ${path}`]
  if (!handler) return { statusCode: 404, body: 'Not Found' }

  const result = await handler({ query: queryString, body: JSON.parse(body || '{}') })
  return {
    statusCode: 200,
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(result)
  }
}
```

### 5. 用户鉴权

**登录流程**：
```javascript
// 小程序端登录
const { data } = await wx.cloud.callFunction({ name: 'login' })

// 云函数获取用户信息
exports.main = async (event, context) => {
  const wxContext = cloud.getWXContext()
  const openid = wxContext.OPENID
  const unionid = wxContext.UNIONID

  // 查询或创建用户
  const userRes = await db.collection('users')
    .where({ openid })
    .get()

  if (userRes.data.length === 0) {
    await db.collection('users').add({
      data: { openid, unionid, createdAt: db.serverDate() }
    })
  }

  return { openid, unionid }
}
```

**自定义鉴权**：
- JWT Token方案
- Session管理
- 权限角色控制（RBAC）
- 接口级权限校验

### 6. 实时数据同步

**数据监听**：
```javascript
// 监听集合变化
const watcher = db.collection('messages')
  .where({ roomId: 'room1' })
  .watch({
    onChange: (snapshot) => {
      console.log('数据变更:', snapshot)
    },
    onError: (err) => {
      console.error('监听错误:', err)
    }
  })

// 关闭监听
watcher.close()
```

### 7. 支付集成

**微信支付流程**：
```javascript
// 云函数统一下单
exports.main = async (event, context) => {
  const { orderId, amount, description } = event
  const wxContext = cloud.getWXContext()

  const res = await cloud.cloudPay.unifiedOrder({
    body: '商品描述',
    outTradeNo: orderId,
    spbillCreateIp: '127.0.0.1',
    subMchId: '商户号',
    totalFee: amount,
    envId: '环境ID',
    functionName: '支付回调云函数',
    nonceStr: generateNonceStr(),
    tradeType: 'JSAPI'
  })

  return res
}
```

## 项目结构建议

```
cloudfunctions/
├── login/          # 登录函数
├── user/           # 用户管理
├── order/          # 订单管理
├── pay/            # 支付相关
└── common/         # 公共模块
    ├── utils.js
    └── config.js

miniprogram/
├── pages/          # 页面
├── components/     # 组件
├── utils/          # 工具函数
├── cloud/          # 云开发初始化
└── app.js
```

## 最佳实践

- 环境隔离：开发/测试/生产使用不同环境
- 数据备份：定期备份重要数据
- 日志记录：关键操作记录日志
- 安全规则：严格配置数据库权限
- 成本优化：合理设置资源用量
- 监控告警：配置关键指标监控

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。