[mini-blog]第一次部署过程中的问题点总结(最近很多人在问)

最近很多人问mini-blog的部署,确实第一次部署小程序有点繁琐,有些是小程序本身的限制,有些是迭代过程中的变化造成,这里统一汇总下。

关于本地环境

  1. 确保小程序IDE是最新的版本。
  2. 本地已安装nodejs环境(小程序云开发有相关依赖)
  3. 确保已开通小程序云开发环境,并了解一些基本概念。

关于云函数上传

第一次下载源码加载后,优先安装云函数本地依赖「每个云函数都需要」

右击相应的云函数,选择在终端打开:

云函数截图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,所以相应的AppIdAppSecret要配置在syncService这个云函数下面

截图8

如果手动执行同步文章云函数报错,皆是由于配置问题导致,请仔细核对AppIdAppSecret是否配置正确「注意大小写,再次强调」

另外检查公众号对应的白名单是否配置和确认是否存在多处获取access_token的地方「access_token会抢占,其他地方获取过,那小程序端获取的access_token就失效了,影响文章同步」。

关于后台管理

后台管理是通过配置openId来实现权限管控的,具体是在adminService云函数下配置对应的环境变量,key名为author,value为相应的openId,可以配置多个,逗号分隔即可。

截图9

openId的获取,可以直接看控制台日志,已经打印出来了,在app.js第30行

截图10

关于海报组件

如果发现文章详情页报错包含wxa-plugin-canvas的错误时,那是说明你本地没有安装海报组件。

相关教程可以参考基于云开发的小程序海报功能的实现,已经写的很详细了。

额外说明下,如果npm安装组件过程中报错,可以尝试将小程序中的package.jsonlock.json删除后再进行安装

截图11

如果海报组件都已经按照上述步骤完成,但发现会报如下错误

fail invalid page hint....
截图12

不要激动,程序本身没有问题,是正常的,报错是因为小程序没有发布过线上环境,找不到相应的page地址。

原因是在生成海报组件时,会生成当前文章页的小程序码,小程序码中包含的跳转页面的校验是根据你线上环境页面来的「如果页面不存在就会报该错误」。

所以,等小程序上线后可以再尝试点击试下。

最后

基本上所有遇到的问题都是上面所提到的导致,后续遇到类似问题不再一一说明了。

另外碰到错误可以看对应的日志「小程序看控制台,云函数看云函数的日志」,日志中都有对应的行数,找到相应的代码行数看下,基本上就能定位到问题了。

最后,还是建议根据时间轴看下我的文章,mini-blog期间的迭代变化,文章中基本都有体现。

最后的最后,遇到问题还是需要学会独立去解决,这也是一种能力。

Ps.GitHub开源地址:
https://github.com/CavinCao/mini-blog

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容