WeChat Mini Program Cloud Development: Overview, Advantages, and Common Pitfalls

Recently, WeChat Mini Programs introduced a new capability called "Mini Program Cloud Development" (小程序·云开发), which provides a serverless backend for rapid Mini Program development. The author, a Mini Program developer, shares personal experiences and practical tips.

What is Mini Program Cloud Development?

It is a Serverless service that offers cloud functions, cloud databases, and cloud file storage, all accessed through specific interfaces such as wx.cloud.xxx.

What Mini Program Cloud Development is NOT

It is not a full PaaS platform. The cloud functions are provided as FaaS (Function as a Service), similar to AWS Lambda, Azure Functions, or Google Cloud Functions.

It is also not a generic BaaS like LeanCloud or Bmob. Its APIs are deeply encapsulated and can only be invoked within Mini Programs via wx.cloud or the wx-server-sdk. Therefore, it can only be used inside Mini Programs, not in other apps.

Suitable Scenarios

Ideal for business logic that can be completed entirely on the Mini Program side without complex management interfaces, because cloud functions and databases cannot be called outside the Mini Program environment.

Advantages

1. Simple WeChat Login Logic

The platform automatically validates user login. Developers can obtain the user’s OpenID directly via event.userInfo.openId, and database/file storage APIs automatically associate data with the corresponding OpenID.

2. Free Tier

Provides 1 GB of free database storage and 5 GB of free file storage, sufficient for many personal projects.

3. Easy to Use

Only basic JavaScript knowledge and an understanding of asynchronous programming (Promises) are required.

4. Non‑Intrusive

No additional libraries are needed; the cloud capabilities are built into the Mini Program base library.

Common Pitfalls Encountered During Development

1. Asynchronous Requests Must Use Promises

When a cloud function performs network requests (e.g., calling external APIs), the traditional callback pattern cannot be used because the function returns to the client before the request completes. Promises must be used to handle the asynchronous flow.

Example code:

var rp = require('request-promise');
exports.main = (event, context) => {
  var res = rp('https://api.douban.com/v2/book/isbn/' + event.isbn)
    .then(html => {
      return html;
    })
    .catch(err => {
      console.log(err);
    });
  return res;
};

2. Simple Permission Model

The cloud database offers four basic permission types:

Only creator can write, everyone can read (e.g., public articles).

Creator can read and write, others have no access (e.g., private photo album).

Only admin can write, everyone can read (e.g., product information).

Only admin can read and write (e.g., backend‑only data).

These permissions are often insufficient, so additional logic (e.g., an is_private flag) is needed in code to enforce fine‑grained access control.

Demo Project

The author provides a demo repository on GitHub (https://github.com/Tencent-CloudEDU/WXCloud-bookcase) for readers to explore, star, fork, and submit pull requests.

Additional resources and promotional links are included at the end of the original article.