很多刚接触小程序开发的朋友，一上来就会被“数据库”这个概念卡住。你打开微信开发者工具，新建一个云开发项目，看到那个“云数据库”的图标，点进去发现里面空空如也，只有默认的几个示例集合。这时候你心里肯定在嘀咕：我到底该怎么把我电脑上那个MySQL表，或者我服务器上那个几十万条数据的表，弄到小程序里来用？

这个问题的本质，其实是“小程序如何与数据源建立连接”。你需要先想清楚一件事：你的数据到底放在哪里？这决定了你获取数据的路径完全不一样。我见过太多人把“云开发数据库”和“传统后端数据库”混为一谈，结果折腾半天发现小程序端根本连不上自己的服务器数据库——因为小程序有严格的安全域名限制，直接连接数据库端口（比如3306）是行不通的。

一、如果你的数据在微信云开发数据库里

这是最省事的方式。你不需要自己买服务器，不需要配置Nginx，甚至不需要懂SQL语句。云开发数据库本质上是MongoDB，它用“集合”来对应你传统观念里的“表”。

操作步骤很简单：在云开发控制台里，点击“数据库”，然后“新建集合”，给它起个名字，比如“users”。但这里有个坑——以为建完集合就能直接在小程序里用db.collection('users').get()拿到数据，结果返回空数组。为什么？因为集合里一条记录都没有。你得先往里边塞数据。你可以手动在控制台里点“添加记录”，一条一条填；也可以用代码批量导入。批量导入的方法，是在云函数里写一个循环插入的逻辑，或者更直接一点，在控制台里找到“导入”按钮，支持JSON和CSV格式。如果你原来有MySQL的表，可以先用工具把数据导出成CSV，再微调字段名（注意云开发数据库的字段名是大小写敏感的），然后导入。

拿到数据之后，小程序端怎么读？在页面的onLoad里，先初始化云环境，然后这样写：

const db = wx.cloud.database()
db.collection('users').where({
  age: db.command.gt(18)
}).get({
  success: res => {
    console.log(res.data)
  }
})

这里有个容易被忽略的细节：.get()一次最多只能拿20条数据。如果你表里有2000条，需要分页。在这里卡住，以为是自己代码写错了。分页要用.skip()和.limit()组合，或者用doc()配合_id做游标查询。

二、如果你的数据在自建服务器或第三方服务上

这种情况更常见，因为很多公司已经有现成的业务数据库，比如MySQL、PostgreSQL。小程序不能直连这些数据库，你需要一个中间层——也就是你自己的后端接口。这个接口通常用Node.js、Python Flask、Java Spring Boot之类写，部署在服务器上，然后小程序通过wx.request()去调用。

具体操作：假设你有一个用户表，你想在小程序里展示用户列表。第一步，在你的后端写一个API，比如/api/users，返回JSON格式的数据。用Node.js+Express举例，大概长这样：

app.get('/api/users', async (req, res) => {
  const users = await db.query('SELECT * FROM users WHERE age > ?', [18])
  res.json({ code: 0, data: users })
})

第二步，在小程序端，你需要在app.json或项目设置里，把服务器的域名添加到“request合法域名”中。这一步会忘，结果调试时一直报“errno: 600001”。注意，域名不能带端口号，而且必须是HTTPS（除非你在开发工具里勾选了“不校验合法域名”）。

第三步，在小程序页面里请求这个接口：

wx.request({
  url: 'https://yourdomain.com/api/users',
  success: res => {
    this.setData({ userList: res.data.data })
  }
})

这里有个对比：云开发数据库的方式，数据请求是在小程序端直接发起的，省去了你自己维护服务器的成本，但缺点是查询能力有限（比如不支持联表查询）；自建服务器的方式，灵活度极高，你想怎么查就怎么查，但你要处理服务器运维、HTTPS证书、接口安全等问题。

三、一个容易被忽略的“中间态”：云函数操作数据库

如果你既想用云开发的便利性，又需要做一些复杂的数据库操作（比如事务、聚合查询），可以考虑用云函数。云函数运行在Node.js环境中，它可以直接操作云开发数据库，并且没有20条的限制。比如你要从“orders”表里统计每个用户的消费总额，小程序端直接调用云函数，云函数里写：

const cloud = require('wx-server-sdk')
cloud.init()
const db = cloud.database()
exports.main = async () => {
  return await db.collection('orders').aggregate()
    .group({
      _id: '$userId',
      total: $.sum('$amount')
    })
    .end()
}

这种做法的好处是，你把复杂逻辑藏在了后端，小程序端只负责展示结果。而且云函数的调用方式跟普通接口一样，通过wx.cloud.callFunction()，不需要配置域名。

四、真实场景中的“表结构迁移”问题

假设你原来有一个MySQL的用户表，字段有id、name、created_at。你想把它搬到云开发数据库里。直接导出CSV导入后，你会发现id字段在云开发里变成了普通的字符串，而不是自动递增的_id。这时候你需要在导入前，把id字段的值赋给_id字段，或者在导入后用云函数批量更新。更稳妥的做法是，保留_id作为云开发自动生成的唯一标识，把你的业务id作为一个普通字段存着。这样后续做关联查询时，你才能用_id做高效的文档定位。

还有一个踩过的坑：时间字段的格式。MySQL里的created_at通常是2024-01-01 12:00:00这样的字符串，但云开发数据库推荐用Date对象存储。如果你直接导入字符串，后续做时间范围查询时会很痛苦。解决办法是，在导入前把字符串转成ISO格式的时间字符串，或者在云函数里写一段转换逻辑。

五、扩展：没有数据库也能“获得”数据

有时候你并不需要真的连接一个数据库表。比如你只是想展示一个固定的城市列表、配置项，或者一些不常变动的数据。这种情况下，你可以直接把数据写在代码里，或者放在一个JSON文件里，通过require引入。这种做法在小程序里是完全可行的，而且加载速度极快。举个例子，你有一个“省市区三级联动”的组件，如果每次都要从数据库拉取全国几千条地区数据，用户体验会很差。不如把地区数据压缩成一个JSON文件，放在utils目录下，页面加载时直接读取本地数据。

当然，这种方式的缺点是数据更新不实时。如果哪天行政区划调整了，你得重新发版。所以具体用哪种，取决于你的业务场景：实时性要求高的，走接口或云数据库；实时性要求低的，本地存一份完全够用。

最后说一句，不管你选哪种方式，都要注意数据安全。小程序端直接操作云数据库时，记得在云开发控制台里设置好权限规则，别让任何人能删掉你的整个集合。自建接口的话，务必加上登录态的校验，比如用wx.login拿到的code去换openid，然后每次请求都带上这个身份标识，后端做鉴权。