微信小程序基础库版本低于 2.19.0 时，主要通过 wx.canIUse 判断接口可用性，或在 app.json 中配置 requiredMinimalVersion 强制最低版本。

快速处理思路

无法直接执行命令，需修改代码与配置文件。第一步在调用新接口前包裹 wx.canIUse 判断逻辑，第二步在 app.json 中声明最低版本要求，第三步在开发者工具中切换基础库版本进行模拟测试。

为什么会这样

低版本基础库不包含新接口的实现代码，直接调用会触发 undefined 错误。微信小程序基础库随微信客户端版本更新，旧版客户端内置的基础库版本较低，无法识别新 API 定义。兼容方案本质是防止代码执行到不存在的方法上，或引导用户升级微信客户端。

分步处理

第一步：接口可用性检测。在调用新接口前使用 wx.canIUse 方法，参数格式为'接口名.参数'，例如 wx.canIUse('chooseImage.sourceType.camera')。仅当返回 true 时执行新接口逻辑，否则执行降级方案或隐藏功能入口。

第二步：配置最低版本。打开项目根目录 app.json 文件，添加 setting 字段或直接添加 requiredMinimalVersion 字段，值设为'2.19.0'。配置后版本低于该值用户打开小程序时会提示升级微信。

第三步：代码降级处理。针对无法兼容的功能，准备备用方案。例如新接口不支持时，使用旧版接口替代，或提示用户当前版本不支持该功能，避免程序崩溃。

怎么验证是否生效

打开微信开发者工具，点击详情面板，找到基础库版本选项。手动切换至 2.19.0 以下版本，观察控制台是否报错。真机调试时，使用旧版微信客户端扫码，确认是否触发版本升级提示或降级逻辑正常执行。

常见坑

wx.canIUse 无法检测所有接口差异，部分接口存在但行为不一致。异步获取版本号可能导致初始化阶段判断失效，建议同步检测。requiredMinimalVersion 配置过高会流失低版本用户，需根据业务容忍度设定。

常见问题

如何强制用户升级微信版本

在 app.json 中配置 requiredMinimalVersion 字段即可。设置后低于该版本的用户打开小程序会看到系统弹出的升级提示，无法直接进入小程序。

wx.canIUse 返回 true 但接口仍报错怎么办

部分接口存在兼容性问题，需结合 try-catch 包裹调用代码。同时检查接口参数是否符合低版本要求，部分参数在高版本才支持。

基础库版本在哪里查看

在微信开发者工具详情面板查看当前调试版本。真机环境下可通过 wx.getSystemInfoSync().SDKVersion 获取当前运行基础库版本号。

参考来源

微信官方文档 - 基础库兼容方案

微信官方文档 - app.json 配置说明