专注小程序 / APP 开发,用代码改变生活

获取方案
全国分站 主站首页 北京分站 石家庄分站 唐山分站 保定分站 廊坊分站 沧州分站 郑州分站 邯郸分站

微信小程序云开发实战:从零搭建一个记账本

小程序开发 2026-11-10 23 阅读 0 点赞 原创

很多独立开发者做小程序时,最头疼的不是页面写不出来,而是后端。服务器、数据库、域名备案、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:金额,Number
  • type:收入或支出,String
  • remark:备注,String
  • createTime:创建时间,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)

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

好想法,值得被认真交付

从小程序、APP 到全栈网站,一站式把想法变成可落地的产品

微信咨询

微信扫码,直接沟通需求