微信小程序的本地缓存文件与本地缓存数据是两个独立概念： 1. **本地缓存文件（文件系统）** - 通过`FileSystemManager.saveFile()`将临时文件转为缓存文件 - 属于文件系统范畴，用于处理图片/音视频等二进制文件 - 存储路径通过文件管理器操作 2. **本地缓存数据（键值存储）** - 通过`wx.setStorage/wx.getStorage`系列API操作 - 用于存储字符串、JSON等结构化数据 - 以key-value形式存储 两种存储机制的区别： | 维度 | 文件系统 | 键值存储 | |------------|----------------------------|------------------------| | 数据形式 | 二进制文件 | 字符串/JSON对象 | | 容量限制 | 200MB（共享空间） | 10MB（独立空间） | | 清理策略 | 随代码包清理 | 用户主动清理或系统回收 | | 典型应用场景 | 用户头像缓存、离线文档 | 用户配置、登录态数据 | 参考文档： - [文件系统](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/file-system.html) - [数据缓存](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/storage.html)

根据微信小程序开发规范，聊天工具模式的可用性与账号主体类型无关，个人小程序同样支持该能力。以下是针对开发问题的排查建议： **核心排查步骤**： 1. 基础配置验证 - 确保基础库版本≥3.7.8（Android微信8.0.56+/iOS微信8.0.56+） - 检查app.json配置是否包含完整参数： ```json "chatTools": [{ "root": "分包路径", "entryPagePath": "入口路径", "desc": "功能描述" }], "rendererOptions": { "skyline": { "disableABTest": true, "defaultDisplayBlock": true, "sdkVersionBegin": "3.7.0" } } ``` - 确认使用独立分包且当前仅配置1个聊天工具 2. 关键调试点 - 在聊天工具分包页调用`wx.getApiCategory()`，确认返回apiCategory=chatTool - 检查`wx.openChatTool`调用参数： ```javascript // 单聊场景 wx.openChatTool({roomid: 'open_single_roomid', chatType: 1}) // 群聊场景 wx.openChatTool({roomid: 'opengid', chatType: 3}) ``` - 确保聊天室id参数与chatType严格匹配 3. 技术限制核查 - 确认聊天工具分包使用skyline渲染引擎 - 禁用以下接口： * navigateToMiniProgram * openEmbeddedMiniProgram * 所有openChannels系列接口 * 广告组件（ad/ad-custom） 参考文档： [聊天工具开发指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/chatTool.html) [wx.openChatTool API文档](https://developers.weixin.qq.com/miniprogram/dev/api/chattool/wx.openChatTool.html)

针对输入法候选词不显示的问题，请按以下关键步骤排查： 1. **核心属性检查** - 检查是否设置`password`属性（该属性会触发密文输入模式，遮蔽候选词） - 确认未使用`safe-password`类型（仅限Webview且会启用安全键盘，需基础库≥2.18.0） 2. **组件类型验证** - 常规输入应使用`type="text"`或保持默认类型 - 检查是否误用`nickname`等特殊输入类型（特定类型可能限制候选词） 3. **输入法兼容性测试** - 尝试切换系统默认输入法（部分第三方输入法存在兼容问题） - 在真机上测试不同品牌机型（不同ROM可能有输入法差异） 4. **框架行为排查** - 检查是否在自定义组件中使用`wx://form-field`行为获取表单值 - 避免在聚焦期间使用CSS动画（可能导致输入法渲染异常） 验证建议： ```wxml <!-- 正确类型示例 --> ``` ```javascript // 检查bindinput事件返回值 onInput(e) { console.log('原始输入数据:', e.detail.value) } ``` 如问题仍未解决： 1. 使用开发者工具"真机调试"模式捕捉输入事件 2. 提供复现问题的机型+系统版本+输入法版本组合 参考文档： [input组件类型说明](https://developers.weixin.qq.com/miniprogram/dev/component/input.html) [自定义组件表单行为](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/behaviors.html)

wx.chooseAddress接口目前主要支持中国大陆地区的地址信息获取，国际地址暂不支持。若需处理国际地址，建议通过以下方案实现： 1. 自行设计表单组件 - 在页面中添加自定义地址输入表单 - 使用多个输入字段分别收集国家、省份、城市等信息 2. 数据保存注意事项： - 确保后端接口支持国际地址字段存储 - 验证地址格式时需兼容不同国家的行政区划结构 若遇到保存失败问题，请按以下步骤排查： 1. 检查是否所有必填字段均有合法值 2. 确认接口请求参数格式符合后端要求 3. 查看网络请求返回的具体错误信息 参考文档: [wx.chooseAddress接口文档](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/address/wx.chooseAddress.html)

公众号认证服务号已具备分享接口权限，若无法自定义分享内容，请按以下步骤排查： 1. **接口规范验证** - 必须使用wx.updateTimelineShareData设置朋友圈分享（替换废弃的onMenuShareTimeline） - 配置代码需在wx.ready回调内执行 - 检查jsApiList是否包含updateAppMessageShareData和updateTimelineShareData 2. **关键配置检查** - 当前页面URL需与公众号设置的JS安全域名完全一致（含http/https协议头） - 使用[微信JS接口签名校验工具]验证签名算法正确性 - 确保link参数域名与安全域名匹配 3. **点击状态处理方案** - 新版接口已取消点击状态回调机制 - 可通过微信消息模板/服务端日志分析分享行为 - 建议在分享链接中追加追踪参数进行效果监测 参考文档： [公众号/微信网页开发/公众号/鸿蒙网页开发适配指南/公众号/JS-SDK说明文档](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html) [公众号/开发前必读/公众号/更新日志/公众号/接口权限说明](https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Explanation_of_interface_privileges.html)

授权页无法调起微信客户端的常见原因及排查方案： **核心原因分析：** 1. **移动应用绑定异常** - 检查多端应用是否已绑定微信开放平台移动应用账号 - 验证移动应用的iOS Bundle ID/Android包名是否与App实际信息一致 2. **SDK初始化问题** - 确保已正确集成微信OpenSDK并完成初始化配置 - 检查移动应用的AppID和签名配置（特别注意Android的签名证书SHA1值） 3. **测试环境限制** - 确认未在「移动应用助手」调试环境测试，必须构建APK/IPA安装包到真机测试 - 开发阶段需通过`adb install`（Android）或Xcode安装（iOS）进行验证 4. **版本发布问题** - 若修改过authorizeMiniprogramType参数，需切换回小程序模式重新发版 - 确保用户访问的是最新发布的小程序版本 **解决方案步骤：** 1. 登录微信开放平台，检查移动应用账号的「多端应用」绑定状态 2. 核对project.miniapp.json中OpenSDK配置项是否勾选 3. 通过`keytool -list -v`命令（Android）验证签名是否与开放平台登记一致 4. 使用Xcode或Android Studio构建正式安装包进行真机测试 参考文档： [多端框架登录服务接入指南](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/miniapp/quickstart/auth.html) [微信OpenSDK集成文档](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/WeChat_Login/Development_Guide.html) [多端应用配置说明](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/miniapp/api/diffapi/WeChatLogin.html)

针对二维码跳转失效问题，请按以下步骤排查： 1. **规则状态验证** - 登录小程序后台 → 开发 → 开发管理 → 普通链接二维码规则 - 确认目标规则状态为"已发布"，且未超过每月100次发布限制 2. **路径匹配检查** - 确保实际链接与配置规则完全匹配： - 协议头（HTTP/HTTPS）严格一致 - 域名全匹配（包括www等子域名差异） - 路径需为配置规则的子路径（当规则以/结尾时） 3. **参数冲突排查** - 检查参数是否符合前缀匹配规则（如规则参数为`id=123`，则`id=1234`有效但`id=12`无效） - 验证是否存在未发布的更具体规则（如已发布`a/`但存在未发布`a/b`） 4. **测试验证** - 使用开发者工具创建测试链接，选择与线上版本一致的发布版本进行测试 - 确认测试用户身份为管理员/开发者/体验者 **注意事项**：通过开发者工具"通过二维码编译"功能解析实际二维码内容，与后台规则进行逐字符比对 参考文档： [扫码打开小程序接入指南](https://developers.weixin.qq.com/miniprogramintroduction/qrcode.html) [特殊场景调试方法](https://developers.weixin.qq.com/miniprogram/dev/devtools/different.html)

微信官方文本内容安全检测接口仍使用`openapi.security.msgSecCheck`方法，但需注意以下要点： 1. **版本要求**： - 必须使用2.0版本（version参数设为2） - 要求wx-server-sdk版本≥0.4.0 2. **错误码变化原因**： - 旧版87014错误码已整合到新版标签体系（如20001时政类标签） - 返回0表示接口调用成功，需结合result.suggest字段判断内容安全性 3. **自查建议**： - 检查请求参数是否包含必填的openid（需最近两小时访问过小程序的用户） - 确认scene参数设置正确（1-资料场景/2-评论场景等） - 查看返回结果的suggest字段："risky"表示高风险，"pass"表示正常 参考文档： [msgSecCheck接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/sec-center/sec-check/msgSecCheck.html)

公众号可以同时使用自有服务器和微信云托管服务，但需严格遵守access_token管理规范： 1. **冲突风险** 若两套系统同时调用获取access_token接口，会导致凭证互相覆盖，触发接口调用失败 2. **核心规范** 必须通过单一中控服务器统一管理access_token（根据微信官方接口协议要求），禁止多系统并发刷新 3. **实施方案** - 选择唯一凭证管理中心：仅通过自有服务器或云托管中的一方进行token管理 - 获取新token后需立即停止使用旧凭证，但旧token仍有5分钟共存期 注意事项： 若已存在自有服务器维护token，开通云托管时需在云托管服务中禁用所有access_token相关接口调用，否则将违反微信接口调用频率限制规则 参考文档： [公众号/开始开发/公众号/接口域名说明/公众号/获取Accesstoken](https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html) [公众号/开发前必读/公众号/更新日志/公众号/入门指引](https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Getting_Started_Guide.html)

在小程序获取手机号的标准流程中，微信官方提供的手机号快速验证组件**无需用户手动输入验证码**。该流程通过以下方式实现： 1. **前端组件触发** 使用 `` 组件，用户点击后直接触发微信原生授权流程 2. **后端解密获取** 通过 `res.detail.code` 传递动态令牌至后端，调用 `phonenumber.getPhoneNumber` 接口解密获取真实手机号 若出现需要用户输入验证码的场景，请按以下步骤排查： 1. 确认是否使用了非官方手机号获取方式（如自行开发的短信验证模块） 2. 检查自定义输入框代码： - 确保 `` 组件未设置 `disabled` 属性 - 检查是否通过 CSS 样式或 JS 事件阻止了粘贴功能 3. 建议优先采用微信官方手机号快速验证组件，避免手动输入验证码环节 参考文档: [手机号快速验证组件](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/getPhoneNumber.html) [input组件属性说明](https://developers.weixin.qq.com/miniprogram/dev/component/input.html)