uni-app
uniCloud
uniapp相关解答
插件市场
uniCloud
uni-app
uniCloud
uniapp相关解答
插件市场
uniCloud

# uniCloud和微信小程序云开发、支付宝小程序云开发有何区别？

微信、支付宝、百度的小程序，均提供了云开发。但它们都仅支持自家小程序，无法在其他端使用。

uniCloud和微信小程序云开发、支付宝小程序云开发使用相同的基础建设平台，微信小程序云开发背后是腾讯云的TCB团队，支付宝小程序云开发背后是阿里小程序云团队。uniCloud是DCloud和阿里小程序云团队、腾讯云的TCB团队直接展开深层次合作，在他们底层资源的基础上进行二次封装，提供的跨端云开发方案。

简单来说，uniCloud和微信小程序云开发、支付宝小程序云开发一样稳定健壮，但有更多优势：

  • 跨平台。不管你在uniCloud里选择了阿里还是腾讯的serverless，均可以跨uni-app的全端使用。从pc到h5，从Android到iOS，以及各家小程序快应用，十几个平台全端支持
  • uniCloud提供了clientDB神器，减少90%的服务器开发工作量，且保障数据安全。详见
  • uniCloud提供了uni-id、uniPay等重要框架，大幅减少开发者的相应功能开发量。
  • uniCloud提供了uni-starter (opens new window)，客户端开发工作量大幅减少。
  • uniCloud提供了uniCloud admin，管理端开发工作量大幅减少。
  • uniCloud提供了schema2code，只需编制数据库schema文件，用户端和管理端的数据列表、分页、搜索、详情查看、修改、删除，全套代码均能自动生成。
  • 更易学。uniCloud提供了JQL查询语言，比SQL和MongoDB的查询语法更简单易掌握，尤其是联表查询非常简单。详见
  • 更完善的工具链。前端uni-app、云端uniCloud、还有ide端的HBuilderX，互相紧密搭配，打造闭环的优秀开发体验
  • 更丰富的生态。插件市场有大量现成的轮子和资源 详见 (opens new window)

如果你已经使用过微信小程序云开发，想进一步了解对比差异或如何从微信小程序云迁移到uniCloud，详见

# uniCloud稳定吗？DCloud服务器异常会影响我的线上业务吗？

uniCloud是 DCloud 和阿里云、腾讯云等成熟云厂商合作推出的云服务产品，阿里云、腾讯云等提供云端基础资源，DCloud提供API设计、前端框架、IDE工具支持、管理控制台、插件生态等服务，开发者的云函数直接托管在阿里云等服务商的serverless平台。

用户终端上的应用在运行时，直连云服务商serverless平台，不会经过DCloud服务器，开发者无需担心因DCloud服务器负载而影响自己业务的问题。

尤其是腾讯云付费版，享受腾讯云的SLA。如果真出问题，腾讯云会负责赔偿（实际上不太会出现故障）

# 云函数 和 传统 Node.js 开发有何区别？

云函数相当于 Node.js + Serverless + DCloud改进。

  • 传统Node.js开发需要购买服务器，安装Node.js环境，部署 pm2 等守护进程；云函数无需考虑服务器环境，只需专心实现业务代码，然后将云函数一键上传，云服务商负责云函数运行环境的准备。
  • 传统Node.js开发模式，开发者需监控服务器参数，比如硬盘使用率，避免服务器负载过高导致业务中断；云函数模式下，开发者无需关心云函数运行的宿主环境，云厂商会实现服务调配及硬件监控。
  • 用户量较大时，传统Node.js开发需考虑购买更多服务器并实现负载均衡；云函数模式下，云服务商自动弹性扩容，开发者无需担心服务器扛不住压力。
  • 传统Node.js开发模式，需考虑安全防护，比如DDos攻击；云函数模式，云厂商的API网关会做拦截防护，开发者无需关心，并可节省高防IP等费用

总结一下，前端同学即便可熟练编写Node.js代码，但对于DB优化、弹性扩容、攻击防护、灾备处理等方面还是有经验欠缺的，但uniCloud将这些都封装好了，真正做到仅专注业务实现，其它都委托云厂商服务。

另外，在 Node.js 代码实现上，云函数每次执行的宿主环境（可简单理解为虚拟机或服务器硬件）可能相同，也可能不同，因此传统Node.js开发中将部分信息存储本地硬盘或内存的方案就不再适合，建议通过云数据库或云存储的方案替代。

当然还有最重要的一点，在uniCloud中，推荐大量业务使用clientDB，一个应用中写不了太多云函数。

# uniCloud只支持uni-app，怎么开发web界面？

uni-app可以开发web界面，详见：uni-app宽屏适配指南

如果是需要pc版admin的话，uniCloud提供了uniCloud admin

# 可否通过http url方式访问云函数或云数据库？

  • 场景1：比如App端微信支付，需要配服务器回调地址，此时需要一个HTTP URL。
  • 场景2：非uni-app开发的系统，想要连接uniCloud，读取数据，也需要通过HTTP URL方式访问。

uniCloud提供了云函数URL化，来满足上述需求。详见

# 微信云开发支持客户端直接操作数据库，uniCloud支持吗？

uniCloud提供了比微信云开发更优秀的前端操作数据库方案，见：clientDB

# 云开发是nodejs+改良版MongoDB组合，对比php+mysql的传统组合怎么样？

nodejs的性能优于php，MongoDB的性能也优于mysql。

对于前端而言，MongoDB这种类json的文档数据库更加易用，且有更高的灵活性。 操作MongoDB仍然使用js的方法。

MongoDB非常灵活，可以对大数据量的表随便增加字段。而mysql的表数据量一旦变大，每增加一个字段，数据库的体积和性能都会造成负面影响。

MongoDB的字段可以嵌套，表达tree型的数据非常方便，扩展起来随心所欲。

对于希望增加数据冗余以提高性能的开发者而言，nosql数据库则是利器。

当然，对于喜欢传统数据库的开发者而言，仍然可以按传统方式设计数据库表结构。

MongoDB的功能要比mysql强大很多。sql太简单的了，一段sql语句其实就是一个字符串，写不了复杂的逻辑。

而MongoDB有非常多的js api，各种聚合运算符，它是可编程的，而不是仅靠一段字符串sql语句来表达。

举个例子，商品数据表中有4个字段：浏览量、收藏量、购买量、评价。需要生成一个近期热门商品列表，4个字段各占25%的权重，加权后排序。这种需求sql是无法直接实现的。而MongoDB里可以一个查询直接返回排序好的结果。

SQL的模糊查询也很弱，like只有前后%，导致很多开发者不得不再使用ElastciSearch这些三方数据库。虽然后期版本的mysql也支持有限正则。但MongoDB的正则查询还是超过开发者预期的强大。

MongoDB虽然强大，但易用性不佳，尤其是聚合运算写起来非常复杂。

uniCloud在MongoDB的基础上改良，进一步提供了DB Schema和JQL。

DB Schema是一个json文件，可以对数据进行描述、约定字段值域、控制操作权限、描述字段之间的关系，让数据库管理更高效，并且大幅降低了服务端的代码开发工作量。详见

JQL是一套操作uniCloud数据库的方法，它更符合js开发者的习惯，并且极大的降低了学习成本和代码量。 比如联表查询、tree查询，都变的非常简单。像tree查询是以往只有oracle才有的功能。JQL文档详见

曾经DCloud官方也推进过阿里云和腾讯云提供serverless的mysql。但经过对MongoDB的深入研究和改良，DCloud已经放弃了难用的mysql。推荐开发者了解uniCloud的云数据库，用起来更强大和方便。

# 支持websocket吗？

websocket的实时特性导致serverless化比较复杂，目前曲线方案有：

  1. 如果使用三方sdk服务，比如推送、腾讯或声网等实时音视频方案，由于是连接三方服务器，不是连接uniCloud，这些方案仍然可以继续使用。
  2. 一些三方专业的websocket服务也可以使用，比如：GoEasy (opens new window)
  3. 如果是im方面的需求，那么基于uniPush的im服务是非常推荐的选择：https://ext.dcloud.net.cn/plugin?id=2670 (opens new window)
  4. 前端轮询获取服务器数据：https://ext.dcloud.net.cn/plugin?id=2740 (opens new window)

# 如何导入老数据库的数据？

  • 方式1：可以在HBuilderX里用db_init.json来批量创建云数据库和插入表内容，详见
  • 方式2：阿里云支持在uniCloud web控制台界面直接导入导出数据
  • 方式3：在云函数里，使用nodejs标准写法，连接老数据库，如使用mysql的插件 (opens new window)，把数据读出来，再批量写入云数据库
  • 方式4：将一个云函数URL化，用其他语言读取老数据库，通过http方式提交到云函数，云函数将接收到的数据存入云数据库

# 云函数访问时快时慢怎么回事？

云函数对应的资源，如果长时间不使用，会被阿里云或腾讯云平台从内存中释放。一旦被释放，启动云函数时会有一个冷启动的过程。

表现为：隔了很久不用，第一次用就会比较慢，然后立即访问第二次，则很快，毫秒级响应。

冷启动的速度一般不会超过1.5秒，如超过1.5秒应该是云函数写的有问题或网络有问题。

资源回收策略方面，阿里云是15分钟内没有第二次访问的云函数，就会被回收。腾讯云是半小时。

两家云厂商仍然在优化这个问题。目前如果开发者在意这个问题，给开发者的建议是：

  1. 使用clientDB可以减少遇到冷启动问题的概率
  2. 非高频访问的云函数，合并到高频云函数中。有的开发者使用纯单页方式编写云函数，即在一个云函数中通过路由处理实现了整个应用的所有后台逻辑。参考插件 (opens new window)
  3. 非高频访问的云函数，可以通过定时任务持续运行它（注意腾讯云可以使用这个方式完全避开冷启动，而阿里云的定时任务最短周期大于资源回收周期）
  4. 配置云函数的单实例多并发，请参考：单实例多并发

# uniCloud访问速度感觉不如传统服务器？

有开发者在一台单机上安装php或java，连接同电脑的mysql。然后与uniCloud比较速度，认为uniCloud偏慢。这里需要澄清如下差异：

  • 原因1. 冷启动。具体分析见上一问题

  • 原因2. 代码和数据库不在一台服务器 在一台单机上安装php或java，同时安装数据库，访问速度确实快。但在使用云数据库时，即数据库是单独的服务器，和运行代码不在一台服务器上时，就会略微造成些延迟。但商业应用的数据库肯定都是独立服务器。

  • 原因3. 拦截器 后端开发的请求一般都有路由管理框架或拦截器，每个请求都要拦截，校验权限。使用这类框架肯定会增加耗时。

clientDB就是这种情况，因为clientDB内部有权限校验系统，某些权限的验证还需要数据库查询。

所以虽然clientDB的速度慢一些，但实际上开发者在自己写了路由拦截和权限管理的框架后，速度也一样会下降。

从uni-id 3.0起，用户的角色权限缓存在token里，不再查库。clientDB的速度比之前提升了100毫秒左右。如果还未升级，请尽快升级 (opens new window)。同时注意如果用了uniCloud admin，也要配套升级。如果自己在云函数里编写过相关业务逻辑，请务必阅读升级注意事项。

  • 原因4. 数据库索引

查询表的索引要正确配置，需要在where里查询的字段都建议配上索引，否则查询会很慢。

但注意索引不能太多，否则增删改数据时又会变慢，精准很重要。推荐详细阅读索引文档

# 发布H5时还得自己找个服务器部署前端网页，可以不用自己再找服务器吗？

uniCloud支持前端网页托管，选择阿里云作为云厂商时完全免费！

  • 如果你已经有备案过的域名，直接解析过来即可；
  • 如果你要新注册域名，备案流程和传统云主机略有不同，涉及一个uniCloud没有固定ip的问题。此时可以去买花生壳的备案服务；也可以临时买一个短期固定ip，走固定ip备案。这里有开发者分享的经验贴 (opens new window)

如果是因为微信js sdk等服务要求配置固定ip白名单，那么腾讯云收费空间已经支持固定ip，详见

# uniCloud云数据库如何实现全文检索

uniCloud的云数据库本身就是文档型数据库，可以全文检索。

查询数据时可以传入正则表达式。相比sql的like只有前后的%，正则表达式要强大的多。详情请参考正则表达式查询

当然如果你需要额外配置ElastciSearch等三方数据库，也可以自己找服务器安装这些服务，同步数据，把需要搜索的数据同步过去。

# uniCloud内如何使用formdata

nodejs本身不支持formdata，但是可以通过手动拼装formdata的方式来进行支持，参考 (opens new window)

结合uniCloud.httpclient.request使用的示例

const FormData = require('form-data');
let form = new FormData();
form.append('my_field', 'my value');
form.append('my_buffer', new Buffer(10));

form.append('img', new Buffer(10), {
  filename: `${Date.now()}.png`,
  contentType: 'image/png'
})

uniCloud.httpclient.request('https://example.com',{
  content: form.getBuffer(),
  headers: form.getHeaders()
})

# 腾讯、阿里的serverless有什么大案例？

  • 微信小程序云开发，已经有50万开发者，包括腾讯自有的很多大日活应用都构建在腾讯云serverless上，如微信生活缴费、乘车码、微信读书、腾讯新闻、腾讯相册等。
  • 2019年双11，阿里部分业务已经迁移在serverless上。支付宝小程序也提供了云开发功能。

# 如何控制云函数数量？云函数是否可以按多级目录整理

不需要控制数量，实际开发中不会突破限制。

因为实际开发中会使用框架而不是真的一个一个开发云函数。

  1. 使用clientDB。这种方式是在前端直接操作数据库，此时一个云函数都不需要写。开发效率远超传统开发模式。包括它配套的action云函数是不占用云函数数量的。
  2. 使用uni-cloud-router单路由云函数框架，这种方式只有一个云函数，所有接口都是这个云函数的不同参数，它有统一的路由管理。

以免费空间的48个云函数举例，一般情况下：

  • 后台管理系统使用uniCloud admin，会自带一个uni-admin的云函数；
  • 前端项目，会有一个uni-id配套的user-center云函数。如果和uniCloud admin复用一个服务空间，此云函数也不需要；
  • 如果有热搜词统计跑批，uni-search (opens new window)配套一个云函数uni-analyse-searchhot；

上述几个是官方推荐的几个常用框架所带的云函数，然后开发者自己的代码里，大多数业务使用clientDB开发，不写云函数，或者写了配套的action云函数也不占用云函数数量；如果还需要自己写一些云函数，再加上uni-cloud-router，用这个单路由云函数搞定剩余需求；另外如果有跑批数据的需求可以再来一个云函数。所以无论如何48个云函数都占不满。

uniCloud的每个云函数是一个独立进程，不存在云函数级别的多级目录概念。

每个云函数下可以有子目录，但它们都属于这个云函数的一部分，而不是另一个云函数。

单路由云函数框架不止是官方提供的uni-cloud-router，插件市场有很多类似框架：详见 (opens new window)

# 港澳台及境外用户访问比较慢怎么办

港澳台及境外用户需要使用全球加速。uniCloud服务商为阿里云时支持配置全球加速，步骤如下：

  1. 参考阿里云全球加速 (opens new window)文档，开通服务并对自有域名进行加速
  2. 将上述域名CNAME到api.bspapp.com
  3. 自行初始化uniCloud传入endpoint参数，其值为开通全球加速的自有域名

# 腾讯云提示当前实名主体已经有三个账号怎么办

开通腾讯云服务空间时实名认证提示实名主体已有三个账号，这往往是开发者在微信小程序开发工具里不小心开通了多个免费的小程序云，此时可以参考以下流程注销不用的账号：

  1. 打开腾讯云找回账号 (opens new window)页面
  2. 选择找回账号方式为实名信息
  3. 操作完成之后可以看到自己实名信息对应的全部腾讯云账号
  4. 选择不使用的账号登录之后注销即可，参考文档：注销腾讯云账号 (opens new window)

同时，如果付费购买腾讯云服务空间，每个账号可以最多拥有50个腾讯云服务空间（注意其中仅有一个享受免费额度）。

# 高并发下简单的防止超卖

uniCloud阿里云现已支持redis，开通并使用redis请参考:redis开通和使用，如何使用redis防止超卖请参考：redis高并发抢购（推荐使用）。如下方式针对无redis场景比较不灵活（不推荐使用）

高并发时很多用户同时对一条数据读写，很容易造成数据混乱，表现在秒杀抢购等场景就是超卖。以秒杀为例，开发者可以从扣除库存这步入手对超卖进行很大程度的限制，下面是一个简单的示例（注意以下代码未使用事务）

// 云函数
const db = uniCloud.database()
const dbCmd = db.command
exports.main = async function(event){
  const transaction = await db.startTransaction()
  // 其他业务逻辑...
  // 库存减一
  const reduceRes = await db.collection('goods').where({
    _id: 'goods_id', // 商品ID
    stock: dbCmd.gt(1) // 限制库存大于1的才允许扣除库存
  }).update({
    stock: dbCmd.inc(-1)
  })
  if(reduceRes.updated === 0) { // 如果没成功更新库存就认为下单失败
    await transaction.rollback()
    return {
      code: 1001,
      message: '下单失败'
    }
  }
}

# 云存储、数据库还没有使用就多了几次

关于云存储：这里的读写次数，并不一定是针对文件的：包括：上传文件、修改Policy、修改ACL、修改CORS 等操作，都会被认为是COS写。环境初始化时也会执行很多次初始化操作，写入 policy/acl/cors 等配置信息。用户每次操作 修改安全域名、修改静态域名等，也会触发 CORS 的写入。

关于数据库：开发者通过uniCloud web控制台访问数据库也会增加少量读写次数

# 部署网站到前端网页托管报“The requested file was not found on this server.”

  • 部署history模式的uni-app项目时，如果未修改前端网页托管的配置，直接访问子页面时就会遇到上面的错误。如何配置请参考部署uni-app项目

# 使用腾讯云报未登录Cloudbase

腾讯云会在本地storage存储一些信息，请不要在应用使用过程中使用clearStorage等接口直接删除storage。

# 阿里云前端网页托管域名报错指引

  1. 错误信息：该域名已经被添加过，不能重复添加

前端网页托管会和阿里云上其他的CDN业务（包括但不限于CDN）冲突，如需绑定到前端网页托管请先将此域名与其他业务解除关联。

  1. 错误信息：The root domain of your domain is reserved by another account

当前域名有在阿里云开通全站加速相关业务（可能配置了泛域名加速），与前端网页托管冲突。可以考虑使用三级域名或去除泛域名加速改为单独配置需要加速的域名。

# 授权其他用户访问服务空间

详见文档：服务空间的多人协作

# 如何使用promise/async/await

uniCloud客户端callFunction及数据库相关接口会返回Promise类型结果，请参考以下写法使用：

// index.vue
<template>
  <view class="content">
    <button type="default" @click="testThen">promise+then</button>
    <button type="default" @click="testAwait">async+await</button>
  </view>
</template>

<script>
  export default {
    data() {
      return {}
    },
    methods: {
      testThen() {
        uniCloud.callFunction({
          name: 'test'
        }).then(res => {
          console.log(res)
        }).catch(err => {
          console.error(err)
        })
      },
      async testAwait() {
        const res = await uniCloud.callFunction({
          name: 'test'
        })
        console.log(res)

        // 如需捕获错误需使用如下写法
        // try {
        //   const res = await uniCloud.callFunction({
        //     name: 'test'
        //   })
        //   console.log(res)
        // } catch (err) {
        //   console.error(err)
        // }

      }
    }
  }
</script>

<style>
</style>

# 发生故障时如何判断故障点

当你的系统出问题时，如何判断是DCloud还是阿里云或腾讯云的问题？

首先再次声明，DCloud的服务仅限于开发阶段。发行部署后，应用的访问不经过DCloud的服务器。

  1. 通过域名判断故障点
  • unicloud.dcloud.net.cn，属于DCloud，这个网站是开发期间使用的，你的应用上线运行时，不经过DCloud服务器。 如果该域名可以访问，但是在该域名下操作连接阿里云或腾讯云的数据出现问题，那么也是阿里云或腾讯云出了问题。
  • bspapp.com，属于阿里云。如果该域名访问报错，说明阿里云serverless出故障了。
  • tencentcloudapi.com，属于腾讯云。如果该域名访问报错，说明腾讯云serverless出故障了。

当然还有一种情况报错，其实是客户端的问题，包括浏览器的跨域问题，或者小程序的域名白名单问题，导致客户端无法连接uniCloud。这需要通过配置来解决，参考文档：小程序和浏览器的域名访问配置

  1. 通过测试系统判断故障点

如果测试系统不正常，那就说明这家云厂商的服务出故障了。

这2个系统是完全独立的，如果两个系统都故障了，那就是2家云厂商都故障了，而不是DCloud服务故障了。再次声明，发布后的服务，不连接DCloud的服务器。

当遇到uniCloud故障时，在uniCloud的QQ群或论坛里反馈即可。因为阿里云、腾讯云其实都有拨测系统，他们也会及时知道故障并解决的。

# 常见数据库错误

operation exceeded time limit、云数据库执行时间超限错误

此错误一般由数据库操作超时引发，具体如何优化请参考：性能优化

使用事务时出现WriteConflict错误

事务的执行会锁行，同时执行的不同事务在操作同一行数据是会存在冲突导致写入失败。尽量优化流程，避免事务互相冲突

# 云函数通过https访问其他服务器时出现“certificate has expired”

本章节仅对let's encrypt证书调整进行说明，其他情况请检查对应网站证书是否过期

let's encrypt于2021年9月30日根证书过期并切换到新版根证书。详情参考：DST Root CA X3 Expiration (September 2021) (opens new window)。此次过期行为引起nodejs8请求使用了let's encrypt证书的网站时出现certificate has expired错误。

解决方案有以下两种：

  1. 将云函数升级到nodejs12，删除旧云函数，配置node版本之后重新上传。详情参考：云函数package.json

  2. （不推荐）使用uniCloud.httpclient.request时传入rejectUnauthorized: false。示例代码如下：

await uniCloud.httpclient.request('https://xxx.com/get', {
	rejectUnauthorized: false
})

# 调用云函数时出现“Unauthenticated access is denied”

如使用腾讯云作为服务商，出现此问题时请检查前端是否有执行clearStorage操作。clearStorage会清理掉腾讯云设置的token，导致请求云函数报错。

上次更新: 2022/5/5 下午7:19:58
特别声明：本手册内容来源uniapp官方
内容出处：uniapp.dcloud.net.cn
ON THIS PAGE
uniCloud和微信小程序云开发、支付宝小程序云开发有何区别？
uniCloud稳定吗？DCloud服务器异常会影响我的线上业务吗？
云函数 和 传统 Node.js 开发有何区别？
uniCloud只支持uni-app，怎么开发web界面？
可否通过http url方式访问云函数或云数据库？
微信云开发支持客户端直接操作数据库，uniCloud支持吗？
云开发是nodejs+改良版MongoDB组合，对比php+mysql的传统组合怎么样？
支持websocket吗？
如何导入老数据库的数据？
云函数访问时快时慢怎么回事？
uniCloud访问速度感觉不如传统服务器？
发布H5时还得自己找个服务器部署前端网页，可以不用自己再找服务器吗？
uniCloud云数据库如何实现全文检索
uniCloud内如何使用formdata
腾讯、阿里的serverless有什么大案例？
如何控制云函数数量？云函数是否可以按多级目录整理
港澳台及境外用户访问比较慢怎么办
腾讯云提示当前实名主体已经有三个账号怎么办
高并发下简单的防止超卖
云存储、数据库还没有使用就多了几次
部署网站到前端网页托管报“The requested file was not found on this server.”
使用腾讯云报未登录Cloudbase
阿里云前端网页托管域名报错指引
授权其他用户访问服务空间
如何使用promise/async/await
发生故障时如何判断故障点
常见数据库错误
云函数通过https访问其他服务器时出现“certificate has expired”
调用云函数时出现“Unauthenticated access is denied”