必须在manifest.json的mp-weixin节点下配置"requiredPrivateInfos": ["chooseAddress"],否则iOS/Android均静默失败;还需先用uni.getSetting检查scope.address权限,拒绝后须调uni.openSetting引导用户手动开启。

uni-app调用chooseAddress前必须配requiredPrivateInfos
不配就直接报错,iOS 和 Android 都会静默失败,控制台可能只显示 chooseAddress:fail auth deny 或干脆无响应。这是最常被忽略的硬性前提。
打开项目根目录下的 manifest.json(uniApp 传统项目)或 manifest.ts(uniBest 项目),在 "mp-weixin" 节点下添加:
{
"mp-weixin": {
"requiredPrivateInfos": ["chooseAddress"]
}
}注意:requiredPrivateInfos 是微信强制要求的白名单,只写 "chooseAddress",别混入 "getLocation" 等其他接口;位置权限和地址权限是两套独立配置,不能复用。
chooseAddress 不会自动弹授权框,得先检查 scope.address
微信不会像旧版那样在首次调用时自动弹出地址授权弹窗,必须手动判断权限状态。直接 uni.chooseAddress() 会立刻失败,且用户看不到任何提示。
正确流程是:
- 先调
uni.getSetting()拿authSetting['scope.address'] - 值为
true:可直接调chooseAddress - 值为
false或undefined:需引导用户授权,不能跳过
示例片段:
让 AI 读懂微信公众号。自研 7 阶段提取管道,穿透反爬率 99.89%,Token 消耗降低 50%–87%。支持 ChatGPT、Claude、Perplexity、Gemini 等平台无缝引用。
uni.getSetting({ success: res => { const hasAuth = res.authSetting['scope.address'] if (hasAuth) { uni.chooseAddress({ /* ... */ }) } else { // 触发授权引导 } }})用户拒绝后怎么重新唤起授权?uni.openSetting 是唯一可靠方式
uni.authorize({ scope: 'scope.address' }) 在微信小程序中对地址权限无效——它只支持 scope.userLocation、scope.userInfo 等少数几个,scope.address 不在其中。强行调用会报 authorize:fail invalid scope。
所以拒绝后的标准动作是:
- 用
uni.showModal提示用户去设置页开启 - 用户点“确认”后,调
uni.openSetting() - 回调里检查
settingResult.authSetting['scope.address']判断是否真开了
别依赖“用户点过一次允许就永远有效”——微信会因版本更新、系统重置等原因清空授权状态,每次进入都应做兜底检查。
拿到地址后字段名和实际数据对不上?注意微信返回字段命名
微信 chooseAddress 返回对象的字段名和常见数据库字段不一致,容易拼错导致取不到值:
-
userName→ 收货人(不是name) -
telNumber→ 手机号(不是phone或mobile) -
provinceName/cityName/countyName→ 省市区(不是province、city) -
detailInfo→ 详细地址(不是address或street)
错误写法:res.province 或 res.address 会是 undefined;正确写法必须严格匹配微信文档字段,比如 res.provinceName + res.detailInfo。
另外,微信返回的地址数据不含 ID,也不保证唯一性,业务上需要自己生成或绑定用户 ID 做持久化。


















