当发表功能持续转圈无法发送时，请按以下优先级排查： 一、网络基础验证 1. 检查开发者工具「Network」面板： - 观察请求状态码（4xx/5xx表示异常） - 确认接口域名已加入小程序后台「开发管理 → 开发设置 → 服务器域名」 二、客户端代码核查 1. 设置合理超时时间（默认60秒）： ```javascript wx.request({ timeout: 60000, fail: (err) => console.log('错误码:', err.errCode) }) ``` 2. 完善回调处理： ```javascript complete: () => { this.setData({ isSending: false }) // 必须重置加载状态 } ``` 三、服务端接口诊断 1. 检查服务端日志： - 确认收到请求且响应时间＜10秒 - 排查数据库慢查询（超过500ms需优化） 四、安全策略验证 1. 检查HTTPS证书有效性（TLS 1.2+） 2. 确保未使用非常用端口（建议443） 五、用户端操作建议 1. 切换WiFi/4G网络测试 2. 通过「发现 → 小程序」入口彻底删除后重新搜索添加 --- 参考文档： [网络请求规范](https://developers.weixin.qq.com/miniprogram/dev/api/network/request/wx.request.html) [安全域名配置指南](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html)

根据官方文档，wx.downloadFile单次下载文件严格限制为200MB。您遇到的283MB文件下载成功属于特定设备的非官方支持行为，可能存在以下原因及解决方案： 一、官方限制说明 1. 文档明确规定：接口设计上限为200MB（基于2020.12.12版本更新日志的修复验证） 2. 执行差异： - iOS设备强制执行200MB限制 - 部分安卓机型可能绕过限制，但存在版本兼容风险（如微信客户端升级后可能失效） 二、文件大小检测方法 ```javascript wx.request({ url: '文件URL', method: 'HEAD', success(res) { const sizeBytes = parseInt(res.header['Content-Length']) || 0 const sizeMB = Math.ceil(sizeBytes / 1024 / 1024) if(sizeMB > 200) console.error('超出下载限制') } }) ``` *注：需处理服务器未返回Content-Length的情况* 三、实施建议 1. 强制前置校验：所有下载前必须通过HEAD请求验证文件大小 2. 超大文件处理： - 服务端分片：拆分为≤200MB的分段文件 - 流式压缩：服务端实时压缩传输（如启用gzip） 3. 存储管理：监控临时文件总量，避免超过4GB运行时上限 参考文档: [指南/基础能力/指南/文件系统](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/file-system.html)

小程序目前暂不支持iBeacon后台持续监听能力。iBeacon相关API（如wx.onBeaconUpdate、wx.startBeaconDiscovery）仅在前台运行时生效，无法在手机待机状态下工作，具体限制如下： 1. **框架限制**： - 小程序未提供类似wx.startLocationUpdateBackground的iBeacon后台监听API - Beacon服务生命周期与小程序前台状态绑定，页面隐藏后自动停止 2. **系统限制**： - 蓝牙信标功能依赖系统位置服务，需同时满足： - 微信获得系统位置权限（Android需设置为"使用小程序期间和离开小程序后"） - 用户授权scope.userLocation权限 **注意事项**： 1. 安卓系统需通过wx.openSetting引导用户设置位置权限为持续授权模式 2. iOS系统后台持续扫描受系统级限制，无法突破 参考文档： [蓝牙信标(Beacon)](https://developers.weixin.qq.com/miniprogram/dev/framework/device/beacon.html) [授权机制](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html)

在安全模式下必须返回完整的加密回包结构，不能直接返回"success"。正确回包应包含四个核心参数： **必要参数说明：** 1. Encrypt：经AES加密并Base64编码后的业务响应内容 2. MsgSignature：由Token、Timestamp、Nonce、Encrypt四参数排序拼接后做SHA1运算得出 3. TimeStamp：当前时间戳（推荐使用接收请求的时间戳） 4. Nonce：随机字符串（建议重新生成而非复用请求参数） **示例正确回包结构：** ```json { "Encrypt": "ELGdu...xSQ==", "MsgSignature": "1b9339...4dea1", "TimeStamp": 1713424427, "Nonce": "415670741" } ``` **注意事项：** 1. 加密流程必须严格遵循：生成新随机串->构建FullStr结构->AES加密->Base64编码 2. MsgSignature签名算法必须与微信服务器校验逻辑一致 3. 回包格式须与消息推送配置的数据格式完全匹配（JSON/XML二选一） 4. 若业务无需返回数据，仍需构造空内容的加密回包 参考文档：[消息推送文档](https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/message-push.html)

针对微信小程序消息推送的回包要求，根据官方技术规范整理如下： **一、明文模式回包要求** 1. 直接返回空字符串或纯文本"success" 2. HTTP响应头需设置Content-Type为text/plain 3. 无需携带任何结构化参数 **二、安全模式回包要求** 1. 必须返回包含加密数据的结构化响应： ```json { "Encrypt": "加密数据(Base64编码)", "MsgSignature": "消息签名", "TimeStamp": "UNIX时间戳", "Nonce": "随机字符串" } ``` 2. 格式必须与后台配置的数据格式一致（JSON/XML二选一） **三、核心判断标准** 1. 加密模式由小程序后台的【消息加解密方式】配置决定： - 选择"安全模式"时必须加密回包 - 选择"明文模式"时禁止加密回包 - "兼容模式"需同时支持两种回包（根据请求参数自动切换） **重要注意事项**： 1. 安全模式签名计算必须包含四要素： - Token - TimeStamp - Nonce - Encrypt字段值 2. 所有回包须在5秒内完成响应 3. 加密回包的Content-Type需设置为application/json或text/xml（与配置格式匹配） 参考文档： [消息推送技术文档](https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/message-push.html)

channel-video组件使用限制及功能说明如下： 1. **播放控制能力**： - 不支持获取播放进度相关事件（如timeupdate） - 无播放/暂停控制接口 - 仅支持基础属性：autoplay（同主体可用）、loop、muted、object-fit 2. **交互限制**： - 组件默认无跳转行为（与channel-live组件不同），若出现跳转需检查： a. 是否误用其他跳转接口 b. 基础库版本是否≥2.25.1 c. 视频号内容是否合规 - 不支持滑动切换视频功能，该组件仅展示单个视频 3. **替代方案**： - 需进度监控时，建议使用原生video组件+自有视频源 - 需要交互控制时，通过自定义播放器实现 自查建议： 1. 确认组件版本≥2.25.1 2. 检查是否混用其他视频号组件 3. 通过真机调试确认组件实际表现 参考文档： [channel-video组件文档](https://developers.weixin.qq.com/miniprogram/dev/component/channel-video.html) [视频号视频指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/channels-activity.html)

微信小程序**不支持通过页面内按钮直接触发分享到朋友圈功能**。根据官方技术要求，用户必须主动点击右上角菜单选择"分享到朋友圈"才能发起操作。 ### 合规实现流程： 1. **必要配置** ```javascript Page({ onShareTimeline() { // 必须配置此函数 return { title: '自定义标题', query: 'from=share', imageUrl: '/images/share.jpg' } } }) ``` 2. **用户引导设计** - 使用视觉元素（如浮动箭头图标）指向右上角菜单 - 添加提示文案"点击右上角分享到朋友圈" - 保持与微信原生控件一致的UI风格 ### 故障排查清单： 1. 按钮不显示： ✔ 检查基础库版本≥2.11.3（Android） ✔ 确认已正确定义`onShareTimeline` ✔ 排除页面包含web-view组件 2. 分享失败： ✔ iOS设备微信版本≥8.0.24 ✔ 单页模式布局是否符合规范 ✔ 检查是否存在诱导分享内容 参考文档： [分享到朋友圈指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/share-timeline.html) [页面接口文档](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html)

发送带小程序文字链的客服消息需按以下规范操作： **一、消息类型选择** 必须使用`msgtype: "text"`，文字链参数需嵌入text对象的content字段 **二、参数结构示例** ```json { "touser": "OPENID", "msgtype": "text", "text": { "content": "a href=\"备用链接\" data-miniprogram-appid=\"当前小程序APPID\" data-miniprogram-path=\"/pages/index/index?param=1\">点击跳转小程序" } } ``` **三、关键要求** 1. `data-miniprogram-appid`必须填写当前小程序自身的APPID 2. `data-miniprogram-path`需与app.json中的页面路径完全一致（可带参数） 3. 兼容性处理： - 必须包含`href`参数作为低版本备用链接 - 微信客户端6.5.16以下版本会强制跳转`href`链接 **四、自查清单** 1. 检查access_token有效性（有效期2小时） 2. 验证路径格式是否符合规范（如`/pages/index/index?param=1`） 3. 使用微信开发者工具真机调试验证不同版本客户端表现 参考文档： - [发送客服消息接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/kf-mgnt/kf-message/sendCustomMessage.html)

微信平台目前不支持撤回或删除已发送的一次性订阅消息。订阅消息发送成功后，消息会直接触达用户微信客户端，开发者无法通过接口或后台进行撤回操作。 建议处理方式： 1. 发送前严格校验消息内容 2. 通过业务系统记录消息发送日志 3. 如需更新信息，需重新发送新模板消息（需用户重新授权订阅） 参考文档: [订阅消息开发指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message.html) [发送订阅消息接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-message-management/subscribe-message/sendMessage.html)

文档地址：[获取手机号接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/user-info/phone-number/getPhoneNumber.html) 微信小程序获取用户手机号必须通过用户主动触发授权流程，目前仅支持以下方式： **前端按钮授权** 必须使用``组件设置`open-type="getPhoneNumber"`，通过`bindgetphonenumber`事件获取临时`code`，将`code`传给服务端调用`getPhoneNumber`接口解密手机号。 **注意事项**： - 所有手机号获取均需用户主动触发，无法通过纯后端接口直接获取 - 临时`code`有效期5分钟且一次性使用 - 需确保开发者工具版本≥1.02.1904090，wx-server-sdk≥0.4.0 若需排查问题，请检查： 1. 按钮组件是否按规范声明`open-type` 2. 服务端接口是否正确处理`code`参数 3. 小程序权限设置中是否开通手机号权限