uni-app怎么获取联系人列表 uni-app读取手机通讯录权限【代码】

畫卷琴夢

畫卷琴夢

2026-04-04

1076人浏览

原创

uni.getcontact仅android有效,需先调用uni.authorize申请scope.contact权限并配置manifest.json,再调用uni.getcontact;ios、h5、小程序均不支持,推荐使用兼容性更好的uni.choosephonecontact。

uni-app怎么获取联系人列表 uni-app读取手机通讯录权限【代码】

uni-app 调用 uni.getContact 前必须处理权限,否则直接失败

Android 和 iOS 都不会在首次调用时自动弹出通讯录授权框——uni.getContact 是个“静默失败型” API:没权限就返回 { errMsg: "getContact:fail auth deny" } 或空数组,不报错也不提醒你缺权限。

必须先用 uni.authorizeuni.openSetting 主动拉起授权。但注意:scope.contact 在 iOS 上无效(苹果根本不允许网页/小程序类容器读通讯录),所以这个 API 实际只对 Android 生效。

  • Android 真机需在 manifest.json 中勾选“联系人”权限(HBuilderX 可视化操作,或手动加 "permissions": { "android": ["android.permission.READ_CONTACTS"] }
  • iOS 下 uni.getContact 永远不可用,别浪费时间测试
  • H5、微信小程序等平台不支持该 API,调用会直接报 getContact:fail not supported

Android 上正确调用 uni.getContact 的三步顺序

不是“直接调就完事”,顺序错了照样拿不到数据。尤其要注意:授权和拉起选择器必须分两步,且不能跳过授权检查。

  • 第一步:用 uni.authorize({ scope: 'scope.contact' }) 检查并申请权限;失败时用 uni.openSetting 引导用户手动开启
  • 第二步:确认授权成功后,再调 uni.getContact({ type: 'addressBook' })type 只能是 'addressBook',传 'weixin' 会静默失败
  • 第三步:结果里每个联系人字段不统一——namemobiletel 都可能为空;部分手机(如华为)会把号码存在 tel 而非 mobile,得都判空取
uni.authorize({ scope: 'scope.contact' })
  .then(() => uni.getContact({ type: 'addressBook' }))
  .then(res => {
    const contacts = res.contactList || []
    contacts.forEach(c => {
      const phone = c.mobile || c.tel || ''
      console.log(c.name, phone)
    })
  })
  .catch(err => {
    if (err.errMsg.includes('auth deny')) {
      uni.openSetting({}).then(res => {
        if (res.authSetting['scope.contact']) {
          // 再试一次
        }
      })
    }
  })

替代方案:为什么多数场景该用 uni.choosePhoneContact

如果你实际只需要让用户选一个联系人(比如填紧急联系人、邀请好友),别硬刚 uni.getContact。它要权限、兼容差、数据杂,而 uni.choosePhoneContact 是系统级联系人选择器,在 Android 和 iOS 上都可用,且无需提前申请通讯录权限。

  • 调用后直接弹出原生联系人列表,用户点选即返回 { name, mobile, tel },字段更干净
  • iOS 下也能用(因为走的是系统 picker,不读全量通讯录)
  • 不依赖 manifest.json 权限配置,H5 和小程序平台也兼容(H5 会降级为手动输入)
  • 注意:它不返回联系人列表,只返回单个选中的对象;需要多选?不存在的,API 不支持

真机调试时常见错误和对应解法

模拟器永远返回空或报错,一切以真机为准。遇到问题先看错误信息本身:

  • getContact:fail auth deny → 没授权,检查 manifest.jsonuni.authorize 是否执行
  • getContact:fail not supported → 当前平台不支持(H5 / 微信小程序 / iOS),别再试了
  • 返回空数组但无报错 → 手机通讯录确实为空,或厂商限制(如小米「隐私保护」里禁用了应用读取联系人)
  • 字段缺失(如只有 name 没号码)→ 检查联系人原始数据是否存了号码,部分手机把号码存在 tel 字段而非 mobile

安卓不同厂商 ROM 对通讯录访问控制差异很大,测试至少覆盖华为、小米、OPPO、vivo 的最新系统版本。有些机型即使开了权限,也要在设置里单独给 uni-app 开“读取联系人”开关——这个容易被忽略。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1062

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

2187

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2080

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

2229

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

333

5

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

0

10

火山引擎DNS解析配置步骤
火山引擎DNS解析配置步骤

使用火山引擎DNS解析网站域名时,需要确认域名已完成管理接入,并正确配置服务器IP、CNAME地址或验证记录。本专题整理域名添加、记录类型选择、TTL设置、解析状态检查、备案和访问测试等流程,适合新手搭建网站时参考。

2026.08.04

0

10

火山引擎对象存储使用教程
火山引擎对象存储使用教程

火山引擎对象存储适合用于网站图片、视频文件、备份数据、静态资源和应用附件管理。本专题整理TOS控制台入口、存储桶创建、地域选择、权限设置、文件上传、访问链接生成、CDN加速、费用查看和常见上传或访问失败问题,帮助用户快速掌握对象存储基础操作。

2026.08.04

1

10

火山引擎云服务器使用教程
火山引擎云服务器使用教程

火山引擎云服务器使用教程适合第一次购买、部署和管理云服务器的用户参考。本专题整理控制台入口、实例创建、地域和配置选择、系统镜像设置、安全组放行、远程连接、网站部署、续费计费和常见连接失败问题,帮助用户快速完成云服务器基础使用流程。

2026.08.04

3

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.4万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 131.8万人学习