uni-app调用微信小程序插件必须严格遵循原生流程：manifest.json中provider须为插件方AppID且置于mp-weixin节点下，plugins为对象；pages.json usingComponents路径须带plugin://前缀；广告插件路径须含正确adpid后缀；真机调试前须在微信开发者工具启用插件调试。
uni-app 在微信小程序中使用插件，不是 npm install 或 import 就能跑通的事——必须严格走微信原生插件接入流程，漏掉任一环节，requireplugin 就会报 "plugin not found"，组件白屏且控制台可能无提示。
manifest.json 里 provider 和 plugins 结构写错就全挂
插件配置必须放在 manifest.json 的 mp-weixin 节点下，不是根节点，也不是 h5 或 app 节点。常见错误包括：
-
provider填成你自己小程序的appid，实际应填插件方在微信公众平台注册的小程序 AppID（如群工具是wx1234567890abcdef，直播是wxa75efa648b60994b） -
plugins写成数组[]，正确格式是对象{}，key 名要和后续requirePlugin('xxx')里的字符串完全一致 -
version写"latest"或留空，必须与微信公众平台插件详情页「当前可用版本」严格一致（比如"1.4.0"写成"1.4"也会静默失败）
pages.json 中 usingComponents 必须带 plugin:// 前缀
如果你用的是插件提供的自定义组件（如 uni-ad、ezplayer），不能写相对路径或 npm 路径，必须用固定协议格式：
- 路径必须以
plugin://<plugin-key>/<component-path>开头，例如："ezplayer": "plugin://ezplayer/ezplayer" -
<plugin-key>必须和manifest.json中plugins对象的 key 一致 - 路径中的
<component-path>来自插件包内plugin.json定义的 component 入口，不能随意改成/index或/main - 广告类插件（如
uni-ad）还强制要求页面路径末尾带_<adpid>，例如pages/ad/ad_1013000002，漏掉下划线或写错数字都会导致真机加载失败
JS 中 requirePlugin 必须动态调用并校验 API 存在性
不能在 data、computed 或模块顶层 import 时引入，必须在方法内按需加载，并检查返回值是否可用：
- 先判断环境：
if (uni.getSystemInfoSync().platform !== 'ios' && uni.getSystemInfoSync().platform !== 'android')才执行requirePlugin，避免 H5/App 端报错 - 调用后必须校验：
const groupTool = requirePlugin('groupTool'); if (!groupTool || typeof groupTool.getGroupList !== 'function')，否则真机运行时可能卡死或静默失败 - 部分 API（如
groupTool.openGroupChat）会触发用户授权，需提前在manifest.json的permission字段声明对应 scope（如scope.groupChat） - 分包页面使用插件时，若未在
pages.json对应页面配置usingPlugins: true，插件 JS 包不会随分包加载，首次调用必失败
真机调试前必须开启微信开发者工具的插件调试
HBuilderX 编译出的代码，在微信开发者工具里默认不加载插件资源，即使所有配置都正确，也会表现为组件不渲染、requirePlugin 返回 undefined：
- 打开微信开发者工具 → 右上角「详情」→「本地设置」→ 勾选「启用插件调试」
- 确保小程序后台已通过插件申请审核（尤其是群工具、直播等敏感插件，个人主体小程序多数不支持）
- 真机测试必须通过合法入口进入：群工具需从群聊卡片打开，直播需从已绑定的直播间跳转，直接扫码或搜索进入无法触发插件上下文
- 域名白名单、TLS 版本、HTTPS 协议、用户群成员身份等环境条件缺一不可，这些在模拟器里测不出来
最常被忽略的一点：插件 JS 包本身不参与 uni-app 的构建流程，它由微信基础库在运行时独立下载加载。这意味着编译时一切正常，不代表真机一定可用；控制台没报错，也不代表插件 API 已就绪。务必在真实群聊卡片或直播间场景下做终验。
