如何通过手机号列表查询ContactsContract中的联系人？

嘿，这个需求完全可行，但得先纠正一个小误区：你没法直接在ContactsContract.Contacts表上用手机号做筛选，因为这个表只存联系人的基本信息（比如姓名、是否有手机号标记），具体的手机号数据存在ContactsContract.CommonDataKinds.Phone这个子表里。下面给你两种靠谱的实现方式：

方式一：直接查询手机号表（推荐） #

直接针对Phone表查询，能直接拿到对应手机号关联的联系人信息，代码示例如下：

// 你的手机号列表
List<String> phoneNumberList = Arrays.asList("138xxxx1234", "139xxxx5678");

// 构造IN子句的占位符，比如列表有2个元素就生成 "?,?"
String placeholders = String.join(",", Collections.nCopies(phoneNumberList.size(), "?"));
String selection = ContactsContract.CommonDataKinds.Phone.NUMBER + " IN (" + placeholders + ")";

// 转换列表为字符串数组，作为查询参数
String[] selectionArgs = phoneNumberList.toArray(new String[0]);

// 执行查询
Cursor cur = cr.query(
    ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
    // 可以指定需要的字段，比如联系人ID、姓名、手机号
    new String[]{
        ContactsContract.CommonDataKinds.Phone.CONTACT_ID,
        ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,
        ContactsContract.CommonDataKinds.Phone.NUMBER
    },
    selection,
    selectionArgs,
    ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME + " ASC"
);

方式二：关联Contacts表查询（如果需要更多联系人主表字段） #

如果你需要获取Contacts表中的其他字段（比如联系人头像ID），可以通过CONTACT_ID关联两张表，用ContentResolver的查询语法实现关联：

List<String> phoneNumberList = Arrays.asList("138xxxx1234", "139xxxx5678");
String placeholders = String.join(",", Collections.nCopies(phoneNumberList.size(), "?"));
String selection = ContactsContract.Contacts._ID + " IN (" +
    "SELECT " + ContactsContract.CommonDataKinds.Phone.CONTACT_ID +
    " FROM " + ContactsContract.CommonDataKinds.Phone.TABLE_NAME +
    " WHERE " + ContactsContract.CommonDataKinds.Phone.NUMBER + " IN (" + placeholders + ")" +
")";

String[] selectionArgs = phoneNumberList.toArray(new String[0]);

Cursor cur = cr.query(
    ContactsContract.Contacts.CONTENT_URI,
    null,
    selection,
    selectionArgs,
    ContactsContract.Contacts.DISPLAY_NAME + " ASC"
);

重要注意事项 #

• 权限问题：别忘了在AndroidManifest.xml中添加<uses-permission android:name="android.permission.READ_CONTACTS"/>，并且在运行时申请权限（Android 6.0+）。
• 手机号格式问题：系统存储的手机号可能带区号、空格、连字符（比如+86 138xxxx1234），如果你的列表是纯数字格式，可能需要用模糊匹配（比如LIKE ?，把参数改成%138xxxx1234%），或者先统一格式再查询。
• IN子句长度限制：Android的SQLite对IN子句的参数数量有默认限制（通常是999个），如果你的手机号列表超过这个数量，建议拆分多次查询，再合并结果。

内容的提问来源于stack exchange，提问作者MareCieco