Skip to content

GitLab

Closed
Created by xingkai@kevin

如果排查调试小程序线上问题

一：使用 vConsole 工具

只有拥有开发者权限或者体验者权限的人员才能使用该功能

  1. 打开开发版或者体验版小程序，右上角打开调试模式
image-20231129134524636
  1. 再打开线上小程序，就会出现vConsole按钮，进行查看相关错误信息

二：使用微信开发者工具

配置本地环境

node - v14.17.4

npm - 6.14.18

npm install -g lhb-cli --registry=http://47.114.119.218:4873/
lhb use self

配置git

brew install git

git config --global user.name "username" # 设置gitlab的用户名

git config --global user.email "xxxx@yyy.com" # 设置gitlab的邮箱

拉取项目

以多经云店小程序为例，项目地址：https://gitlab.lanhanba.com/pms/locationbusinesswxmp

  1. 运行打包项目

npm i

npm run build:pe

  1. 开发者工具指向项目目录，多经云店的打包路径是weapp目录

image-20231129165338735

  1. 效果呈现，理论上当前程序跟线上的程序基本能呈现。

image-20231129165817013

二维码编译

使用场景

经常使用在二维码推广上，带有特定的参数，比如说分享人、资源id等信息。

调试方法

  1. 开发者工具添加二维码图片

image-20231129170106139

  1. 保存识别出来的参数内容

image-20231129170239210

image-20231129170311538

image-20231129170410099

上图中的启动参数即是二维码的内容，场景类型可自己选择性添加

  1. 进行调试

Short Link 编译

举个例子： #小程序://多经云店/Ma7BOqDZKiK36ls

使用场景

short link 只适用于微信内使用，包括微信、企业微信、朋友圈

获取方式

  1. 小程序右上角，复制链接

image-20231129192605331

  1. 通过服务端生成 generateShortLink

注意事项

  • 单个小程序每日生成 ShortLink 上限为100万个（包含短期有效 ShortLink 与长期有效 ShortLink ）

  • 单个小程序总共可生成永久有效 ShortLink 上限为10万个，请谨慎调用。

  • 短期有效ShortLink 有效时间为30天，单个小程序生成短期有效ShortLink 不设上限。

调试方法

  1. 获取到链接

  2. 编辑器添加 Short Link 编译

image-20231129192825254

  1. 保存参数，方便调试

URL Link 编译

示例：https://wxaurl.cn/pFawq35qbfd

使用场景

可适用于短信、邮件、网页、微信内拉起小程序

获取方式

  1. 通过服务端生成generateUrlLink

注意事项

  1. 每天生成 URL Scheme 和 URL Link 总数量上限为50万

  2. 有限期30天，不支持永久有效

  3. 微信外部一个独立的URL Scheme只能被一个用户访问；微信内部不限制

  4. 在微信内或者安卓手机打开 URL Link 时，默认会先跳转官方 H5 中间页

调试方法

  1. 获取到链接

  2. 编辑器添加 URL Link 编译

image-20231129194753499

  1. 保存参数，方便调试

URL Scheme 编译

使用场景

  • 适用于从短信、邮件、微信外网页等场景打开小程序

调试方法

  1. 通过服务端生成 generateScheme

注意事项

  1. iOS系统支持识别 URL Scheme，可在短信等应用场景中直接通过Scheme跳转小程序。

  2. Android系统不支持直接识别 URL Scheme，用户无法通过 Scheme 正常打开小程序，开发者需要使用 H5 页面中转，再跳转到 Scheme 实现打开小程序，location.href = 'weixin://dl/business/?t= TICKET'

  3. 每天生成 URL Scheme 和 URL Link 总数量上限为50万

  4. 网页地址示例代码：https://postpay-2g5hm2oxbbb721a4-1258211818.tcloudbaseapp.com/jump-mp.html

调试方法

  1. 获取到链接

  2. 编辑器添加 URL Scheme 编译

image-20231129200132376

  1. 保存参数，方便调试

三：小程序错误日志

PC 网页访问

https://wedata.weixin.qq.com/mp2/js-error-list

js分析，看查看具体某个人错误情况，需要定期修补错误

微信告警群

image-20231129200731574

一旦发生错误，告警群里会第一时间收到消息