很多独立开发者做小程序时,最头疼的不是页面写不出来,而是后端。服务器、数据库、域名备案、HTTPS 证书,一整套下来,一个想法还没验证就先花掉几千块。微信小程序的云开发正好解决了这个问题:数据库、存储、云函数都托管在微信侧,前端直接调用,不用自己运维。

这篇文章用一个「极简记账本」作为例子,把云开发里最常用的几个能力串一遍:数据库增删改查、云函数、以及用户身份识别。代码可以直接跑,适合作为你下一个工具类小程序的起点。
一、初始化与项目结构
在微信开发者工具里新建项目时选择「云开发」模板,或者在已有项目里开通云开发环境。开通后会得到一个环境 ID,形如 cloud1-xxxxxx。
在 app.js 里做一次全局初始化:
App({
onLaunch() {
if (!wx.cloud) {
console.error('请使用 2.2.3 或以上的基础库')
return
}
wx.cloud.init({
env: 'cloud1-xxxxxx',
traceUser: true
})
}
})
traceUser 打开后,云开发控制台的用户管理里能看到访问记录,排查问题很方便。
二、设计数据集合
记账本只需要一个集合 bills,每条记录大致长这样:
_openid:云开发自动写入,标识数据属于哪个用户amount:金额,Numbertype:收入或支出,Stringremark:备注,StringcreateTime:创建时间,Date
在云开发控制台手动创建集合 bills,权限设置为「仅创建者可读写」。这一步很关键,默认权限是「所有用户可读,仅创建者可写」,账目数据不该被别的用户读到。
三、新增一条账单
前端直接操作数据库,不需要云函数:
const db = wx.cloud.database()
async function addBill({ amount, type, remark }) {
const res = await db.collection('bills').add({
data: {
amount: Number(amount),
type,
remark,
createTime: db.serverDate()
}
})
return res._id
}
用 db.serverDate() 而不是 new Date(),可以避免用户手机时间不准导致排序错乱。
四、分页查询与列表渲染
小程序端单次查询默认最多返回 20 条,做列表必须分页。常见的写法是记录已加载条数,用 skip 往后翻:
const PAGE_SIZE = 20
let page = 0
async function loadBills() {
const res = await db.collection('bills')
.orderBy('createTime', 'desc')
.skip(page * PAGE_SIZE)
.limit(PAGE_SIZE)
.get()
page++
return res.data
}
如果数据量会到几千条以上,skip 越翻越慢,更好的做法是用上一页最后一条的 createTime 作为游标:
db.collection('bills')
.where({ createTime: db.command.lt(lastTime) })
.orderBy('createTime', 'desc')
.limit(PAGE_SIZE)
.get()
这种游标分页在数据量大时性能稳定得多,值得一开始就用上。
五、用云函数做聚合统计
首页要显示「本月支出总额」,这个计算放在前端做既费流量又容易被篡改。用云函数配合聚合查询更合适:
// cloudfunctions/summary/index.js
const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })
const db = cloud.database()
const $ = db.command.aggregate
exports.main = async (event) => {
const { start, end } = event
const res = await db.collection('bills')
.aggregate()
.match({
createTime: db.command.gte(new Date(start)).and(db.command.lt(new Date(end))),
type: 'expense'
})
.group({
_id: null,
total: $.sum('$amount')
})
.end()
return { total: res.list[0] ? res.list[0].total : 0 }
}
注意云函数里 cloud.init 用 DYNAMIC_CURRENT_ENV,这样部署到哪个环境就用哪个环境,不用改代码。另外云函数默认超时 3 秒,聚合查询如果数据多,记得在控制台把超时调到 10 秒。
六、获取用户身份
云函数里可以直接拿到调用者的 openid,不需要前端传:
const { OPENID } = cloud.getWXContext()
前端也可以调用 wx.cloud.callFunction 的返回结果里拿到 openid,用来做「我的」页面展示。但要注意,openid 只在小程序内有效,不要拿它当业务主键存到外部系统。
七、几个实际会遇到的细节
- 云开发数据库的
where查询对字段类型敏感,字符串和数字混存会导致查不到,写入时统一用Number()转换。 - 云函数本地调试时,
wx-server-sdk的版本要和云端一致,否则可能出现本地能跑、线上报错的情况。 - 免费额度对个人工具类小程序基本够用,但数据库读写次数和云函数调用次数要留意,列表页避免在
onShow里无脑全量刷新。 - 删除账单用
db.collection('bills').doc(id).remove(),在「仅创建者可读写」权限下,用户只能删自己的数据,天然安全。
八、小结
云开发把后端门槛降到了几乎为零,一个记账本从建集合到跑通增删查统,熟练的话半天就能完成。对独立开发者来说,这意味着可以把精力放在交互和场景上,而不是被服务器配置拖住。先把最小闭环跑通,再考虑要不要迁移到自建后端,这个顺序在小程序上通常是对的。

评论 (0)
还没有评论,快来抢沙发吧~