[mini-blog]第一次部署过程中的问题点总结(最近很多人在问)
[mini-blog]第一次部署过程中的问题点总结(最近很多人在问)
最近很多人问
mini-blog的部署，确实第一次部署小程序有点繁琐，有些是小程序本身的限制，有些是迭代过程中的变化造成，这里统一汇总下。
关于本地环境
- 确保小程序
IDE是最新的版本。 - 本地已安装
nodejs环境（小程序云开发有相关依赖） - 确保已开通小程序云开发环境，并了解一些基本概念。
关于云函数上传
第一次下载源码加载后，优先安装云函数本地依赖「每个云函数都需要」
右击相应的云函数，选择在终端打开:
云函数截图1
通过命令安装相应的依赖:
npm install wx-server-sdk@latest
云函数截图2
安装完成后，右击相应的云函数，选择创建并部署:所有文件
云函数截图3
关于云环境配置
在运行小程序前，需要对云环境进行配置，首先找到自己的云环境ID，云开发控制台右上角就有。
截图4
接着进行配置，配置包含两部分，小程序端和云函数端。「这两部分是独立的，可以理解为前后端了」
首先是云函数端，为每个云函数进行环境变量的配置，配置的key为Env「注意大小写」，对应value就是你的云环境ID
截图5
然后是小程序端，小程序端在utils下的config.js中
截图6
关于云数据库
数据库的集合数量没有变，还是这几个：
//缓存小程序or公众号的accessToken
access_token
//小程序文章集合
mini_posts
//小程序评论内容集合
mini_comments
//小程序用户操作文章关联（收藏、点赞）
mini_posts_related
//小程序博客相关配置集合
mini_config
//小程序博客相关操作日志
mini_logs
//小程序博客用户FormID（用于模板消息推送）
mini_formids在创建完之后，一定修改下集合的权限，不然小程序端是没有权限读取集合中的数据的
截图7
关于公众号文章同步
目前最新版与原教程[mini-blog]基于云开发的博客小程序使用教程说明的有点出入
同步文章的云函数已经从adminService变更为syncService,所以相应的AppId和AppSecret要配置在syncService这个云函数下面
截图8
如果手动执行同步文章云函数报错，皆是由于配置问题导致，请仔细核对AppId和AppSecret是否配置正确「注意大小写，再次强调」
另外检查公众号对应的白名单是否配置和确认是否存在多处获取access_token的地方「access_token会抢占，其他地方获取过，那小程序端获取的access_token就失效了，影响文章同步」。
关于后台管理
后台管理是通过配置openId来实现权限管控的，具体是在adminService云函数下配置对应的环境变量，key名为author,value为相应的openId,可以配置多个，逗号分隔即可。
截图9
openId的获取，可以直接看控制台日志，已经打印出来了，在app.js第30行
截图10
关于海报组件
如果发现文章详情页报错包含wxa-plugin-canvas的错误时，那是说明你本地没有安装海报组件。
相关教程可以参考基于云开发的小程序海报功能的实现,已经写的很详细了。
额外说明下，如果npm安装组件过程中报错，可以尝试将小程序中的package.json和lock.json删除后再进行安装
截图11
如果海报组件都已经按照上述步骤完成，但发现会报如下错误
fail invalid page hint....
截图12
不要激动，程序本身没有问题，是正常的，报错是因为小程序没有发布过线上环境，找不到相应的page地址。
原因是在生成海报组件时，会生成当前文章页的小程序码，小程序码中包含的跳转页面的校验是根据你线上环境页面来的「如果页面不存在就会报该错误」。
所以，等小程序上线后可以再尝试点击试下。
最后
基本上所有遇到的问题都是上面所提到的导致，后续遇到类似问题不再一一说明了。
另外碰到错误可以看对应的日志「小程序看控制台，云函数看云函数的日志」，日志中都有对应的行数，找到相应的代码行数看下，基本上就能定位到问题了。
最后，还是建议根据时间轴看下我的文章，mini-blog期间的迭代变化，文章中基本都有体现。
最后的最后，遇到问题还是需要学会独立去解决，这也是一种能力。