
Android 13 起,即使应用处于终止状态(进程被杀),也无法主动读取联系人数据;必须在前台运行并获得动态授权后才能访问,且需在 AndroidManifest.xml 中新增 声明以满足隐私新规。
android 13 起,应用被杀后台后读取联系人:权限与查询声明详解 —— android 13 起,即使应用处于终止状态(进程被杀),也无法主动读取联系人数据;必须在前台运行并获得动态授权后才能访问,且需在 androidmanifest.xml 中新增 `
在 Android 13(API 级别 33)及更高版本中,Google 进一步强化了用户隐私保护机制,对敏感数据(如联系人)的访问施加了更严格的限制。关键前提必须明确:应用在完全终止(即进程被系统杀死、不在前台也不在后台服务中存活)状态下,无法主动执行任何联系人读取操作。 这是系统级设计,并非技术限制可绕过——没有后台持久化权限、没有前台服务豁免、也没有隐式广播或 JobIntentService 能触发联系人读取。
✅ 正确做法:应用必须处于前台活跃状态(Activity 可见或前台 Service 正在运行),并在用户明确授予权限后,才可安全访问联系人数据。
必要配置步骤(缺一不可)
-
声明运行时权限
在AndroidManifest.xml中声明基础权限:<uses-permission android:name="android.permission.READ_CONTACTS"></uses-permission>
-
新增
<queries></queries>声明(Android 13+ 强制要求)
自 Android 13 起,若应用需通过ContentResolver查询ContactsContract.Contacts.CONTENT_URI等 URI,必须显式声明意图查询能力,否则query()调用将静默失败(返回空光标,无异常抛出):<queries><intent><action android:name="android.intent.action.VIEW"></action><category android:name="android.intent.category.DEFAULT"></category><data android:mimetype="vnd.android.cursor.dir/contact"></data></intent></queries>
⚠️ 注意:该
<queries></queries>标签需与<manifest></manifest>同级(位于根节点下),不可嵌套在<application></application>内;否则构建会失败或声明无效。
Android Adb Skill下载Android 开发调试技能,通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能:(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作;(2)...
-
运行时动态申请权限(SDK ≥ 33)
即使已声明<queries></queries>,仍需在代码中请求READ_CONTACTS权限(目标 SDK ≥ 33 时为危险权限):if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) { if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_CONTACTS}, REQUEST_CODE_READ_CONTACTS); } } -
安全读取示例(Kotlin)
权限授予后,使用标准ContentResolver查询(务必在主线程外执行):fun loadContacts() { lifecycleScope.launch(Dispatchers.IO) { val projection = arrayOf( ContactsContract.Contacts._ID, ContactsContract.Contacts.DISPLAY_NAME, ContactsContract.Contacts.HAS_PHONE_NUMBER ) val cursor = contentResolver.query( ContactsContract.Contacts.CONTENT_URI, projection, null, null, null ) cursor?.use { while (it.moveToNext()) { val id = it.getString(it.getColumnIndexOrThrow(ContactsContract.Contacts._ID)) val name = it.getString(it.getColumnIndexOrThrow(ContactsContract.Contacts.DISPLAY_NAME)) // 继续查询电话/邮箱(需额外权限和子查询) } } } }
重要注意事项
- ❌ 无后台唤醒能力:
BroadcastReceiver(如监听联系人变更)、WorkManager或AlarmManager均无法在应用被杀后触发联系人读取逻辑。 - ✅ 替代方案建议:如需“准实时”同步,可引导用户启用系统级联系人同步(如通过
AccountManager注册账户),或使用JobIntentService在应用下次启动时批量补同步。 - ? 最小权限原则:仅申请
READ_CONTACTS,避免请求READ_CONTACTS+WRITE_CONTACTS组合权限,降低审核风险。 - ? 适配兼容性:
<queries></queries>对 Android 12 及以下版本无影响,但建议统一添加以保障未来兼容性。
总之,Android 13 并未开放“被杀后读联系人”的能力,而是通过 <queries></queries> + 动态权限 + 前台约束,构建更透明、可控的数据访问链路。开发者应聚焦于用户体验优化(如权限说明弹窗、渐进式授权),而非尝试突破系统沙箱边界。










