小程序无法分享到朋友圈的排查指引： **核心排查点**： 1. **接口配置验证** - 必须同时设置`onShareAppMessage`（发送给朋友）和`onShareTimeline`（分享到朋友圈）事件处理函数 - 检查基础库版本≥2.11.3，微信客户端版本要求：Android≥8.0.24/iOS≥8.0.24 2. **组件限制排查** - 页面若包含`web-view`组件将完全禁用分享功能 - 单页模式下禁用`navigator`等跳转组件（场景值1154时触发） 3. **单页模式限制** - 通过`wx.getLaunchOptionsSync().scene`判断是否进入单页模式（场景值1154） - 单页模式下禁止页面跳转、登录、支付等操作 4. **权限与版本验证** - 开发版/体验版需确保测试用户有体验权限 - 真机调试时确认已通过版本兼容性检查 **操作建议**： 1. 使用`wx.getSystemInfoSync()`检查SDKVersion字段确认基础库版本 2. 移除页面中的web-view组件或创建独立分享页 3. 在单页模式中避免任何页面跳转行为 参考文档： [分享到朋友圈能力说明](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/share-timeline.html) [页面事件处理函数规范](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html)

微信小程序支持本地文件上传，主要根据文件类型选择对应API： 1. 文件类型选择方案： - 聊天文件选择：使用wx.chooseMessageFile 支持格式：doc/xls/ppt/pdf/zip等非媒体文件 最大选择数：10个 2. 媒体文件选择：使用wx.chooseMedia（推荐替代已废弃的wx.chooseImage） 支持格式：图片/视频 最大选择数：9个 支持来源：相册/相机 3. 两种API的主要区别： - wx.chooseMessageFile：从微信会话记录中选择文件 - wx.chooseMedia：从本地相册或相机获取媒体文件 官方限制说明： - 不支持直接访问手机本地文件系统 - 所有文件选择必须通过上述API实现 - 小程序插件环境受限（wx.chooseMessageFile不可用） 建议根据实际场景选择对应接口，若需同时支持多种文件类型，可采用组合调用方案。 参考文档： [wx.chooseMessageFile文档](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseMessageFile.html) [wx.chooseMedia文档](https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseMedia.html)

在WebView组件中实现H5与小程序的通信，**不需要配置wx.config**。具体实现方式如下： 1. **H5页面调用方法**： ```javascript wx.miniProgram.postMessage({ data: { key: 'value' } }) ``` 2. **小程序端监听**： ```html web-view src="你的H5页面地址" bindmessage="onMessage" /> ``` ```javascript Page({ onMessage(e) { console.log('接收数据:', e.detail.data) // 数据格式为数组（合并多次postMessage的结果） } }) ``` **关键注意事项**： - 必须在小程序管理后台将H5域名配置到"业务域名"白名单 - iOS设备若遇消息无响应，可在web-view的src末尾添加`#wechat_redirect` - 消息合并机制：当触发小程序后退、组件销毁、分享等事件时，所有未处理的postMessage数据会合并成数组传递 - 每个页面只能存在一个web-view组件 参考文档： [web-view组件文档](https://developers.weixin.qq.com/miniprogram/dev/component/web-view.html)

校验文件部署需遵循以下要求： 1. **二级域名独立校验** 必须将验证文件放置在`prop.xxxxx.com`域名的以下位置： - 根目录（通过 `https://prop.xxxxx.com/校验文件名.txt` 可访问） - 或 `/api/abc` 子目录（通过 `https://prop.xxxxx.com/api/abc/校验文件名.txt` 可访问） 2. **校验文件独立性** 每个小程序需使用独立的校验文件，不可与其他小程序共用 3. **服务器配置检查** - 确认域名`prop.xxxxx.com`已完成ICP备案 - 确保服务器未禁止.txt文件访问（需返回HTTP 200状态码） **自查建议**： 1. 通过浏览器直接输入校验文件URL，验证能否正常下载 2. 重新提交校验时，路径需与文件实际位置完全匹配 参考文档： [扫普通链接二维码打开小程序接入指南](https://developers.weixin.qq.com/miniprogramintroduction/qrcode.html)

广告位ID使用规范： 1. 同一广告单元ID使用规则： - 根据微信广告规范，同一广告单元ID可重复使用，但必须确保广告实例独立创建 - 推荐为不同位置创建独立广告单元ID，便于数据统计和样式控制 实现方案： 1. 广告插入策略： - 采用固定间隔插入方式（如每10条数据插入广告），结合屏幕高度动态计算间隔 - 使用ad-custom组件时必须绑定unit-id和事件处理器 ```javascript // 修正后的数据结构示例 const dataList = [ { type: 'content', ... }, { type: 'ad', adData: { unitId: 'adunit-xxx', // 必填项 onLoad: handleAdLoad, // 事件绑定 onError: handleAdError } } ] ``` 2. 视觉控制规范： - 通过外层容器宽度控制广告尺寸（禁止直接设置广告组件样式） - 使用IntersectionObserver实现广告曝光监测 ```css /* 正确做法：通过外层容器控制 */ .ad-wrapper { width: 100%; /* 控制广告宽度 */ margin: 20rpx 0; } ``` 3. 预加载优化： - 在页面跳转前预加载广告数据 ```javascript wx.preloadAd([{ unitId: 'adunit-xxx', type: 'custom' // 原生模板广告必须指定类型 }]) ``` 关键注意事项： 1. 单屏广告控制： - 通过计算首屏可见元素数量，确保同一屏幕仅渲染一个广告组件 - 使用wx.createIntersectionObserver()监测广告位置 2. 错误处理： - 广告加载失败时隐藏父容器（保留组件实例） - 同一广告单元连续错误时切换备用广告位ID 参考文档： [原生模板广告开发指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/ad/custom-ad.html) [ad-custom组件文档](https://developers.weixin.qq.com/miniprogram/dev/component/ad-custom.html) [广告预加载接口](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/ad/preload-ad.html)

要调整小程序图标大小，请按以下步骤操作： 1. 使用icon组件的size属性控制尺寸： ```html ``` 2. size属性特性说明： - 默认值：23（单位默认px） - 单位支持：基础库2.4.0+支持rpx/px，2.21.3+支持rem等单位 - 推荐使用rpx单位实现响应式布局 注意事项： 1. icon组件仅支持预定义类型（success/info等），如需自定义图片请改用image组件 2. 请检查基础库版本是否支持所需单位（开发工具->详情->本地设置查看基础库版本） 参考文档： [icon组件文档](https://developers.weixin.qq.com/miniprogram/dev/component/icon.html)

msgSecCheck接口支持小程序与小游戏的内容安全检测，调用时需注意以下要点： 1. **接口通用性**： - 核心功能与接口实现完全一致，适用于小程序和小游戏场景 - 使用统一的access_token机制，不区分平台类型 2. **版本要求**： - 必须使用2.0版本接口（1.0版本已于2021年9月1日停用） - 请求参数中需强制指定version=2字段 3. **调用规范**： - 参数结构及字段要求完全一致，仅文档展示形式存在差异 - 需特别注意scene参数与openid的关联要求： - openid必须为近两小时访问过小程序的用户 - scene参数需根据场景选择合法值（1资料/2评论/3论坛/4社交日志） 4. **频率控制**： - 频率限制按appId独立计算，与平台类型无关 - 每日调用上限为2,000,000次 参考文档： - [msgSecCheck接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/sec-center/sec-check/msgSecCheck.html)

可以通过查询测试任务列表接口获取任务维度的成功率数据，具体方法如下： 1. 调用任务列表查询接口： ```http GET https://minitest.weixin.qq.com/thirdapi/plan_list ``` 必填参数： - token（用户令牌） - group_en_id（项目英文ID） - page_index（页码） 2. 在接口返回的`plan_list`数组中，每个任务对象包含： - `success_rate`字段：表示任务整体成功率（浮点型，范围0.0~1.0） - `status`字段：需结合状态码判断（状态码>10表示任务完成，12表示成功结束） 注意事项： - 该字段为任务维度统计，非单个用例的通过率 - 需通过status=12判断任务是否正常完成 参考文档： [测试任务接口文档](https://developers.weixin.qq.com/miniprogram/dev/devtools/minitest/api_plan.html)

微信小程序没有提供直接监听手机物理返回键的API，但可通过以下方式间接处理返回操作： 一、页面栈管理方案 1. 使用页面生命周期函数 在页面的`onUnload`生命周期中处理返回逻辑，需注意： - 该事件会在页面卸载时触发（包括跳转其他页面） - 无法区分物理返回键与导航栏返回按钮的操作 二、页面返回确认方案 使用`wx.enableAlertBeforeUnload`接口（基础库2.12.0+）： 1. 开启页面返回确认弹窗 2. 通过用户点击弹窗"取消"按钮触发回调 3. 可捕获部分返回操作（但无法直接监听按键事件） 注意事项： - 安卓物理返回键行为遵循页面栈规则：最后一个页面退出时会直接关闭小程序 - iOS设备无物理返回键硬件 - 手势滑动返回不会触发上述任何监听 参考文档： [页面路由](https://developers.weixin.qq.com/miniprogram/dev/framework/app-service/route.html) [wx.enableAlertBeforeUnload](https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.enableAlertBeforeUnload.html)

微信小程序内嵌H5页面无法通过传统网页授权获取code的机制，这是由平台安全策略决定的。核心问题如下： ### 一、授权机制隔离 1. **环境隔离性** 小程序Webview运行在独立沙箱环境中： - 无法直接调用微信公众号的JS SDK接口 - 不支持传统H5网页的OAuth授权流程（包括获取code、access_token等） 2. **凭证体系差异** - 小程序使用wx.login获取的code仅适用于小程序体系（通过code2Session接口换取openid） - 微信公众号网页授权code属于另一套凭证体系，两者无法互通 ### 二、官方解决方案 必须使用小程序原生授权机制： ```javascript wx.login({ success: res => { const code = res.code // 有效期为5分钟 // 将code发送至开发者服务器换取openid } }) ``` ### 三、替代方案建议 若必须使用H5授权流程： 1. **外部浏览器方案** 通过URL Scheme生成外部跳转链接，引导用户通过"右上角..."菜单打开系统浏览器 2. **开放标签方案** 使用`wx-open-launch-weapp>`标签跳转至关联公众号的H5页面（需满足：公众号已关联小程序） ### 四、自查建议 1. 检查H5页面是否混用了`wx.redirectTo`等小程序API 2. 确认小程序与公众号是否绑定同一开放平台账号 3. 在开发者工具中查看控制台是否有"invalid scope"相关报错 参考文档： [小程序登录流程](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html) [Webview使用限制](https://developers.weixin.qq.com/miniprogram/dev/component/web-view.html)