如何在 Android Studio（Java）中正确读取联系人电话号码-java教程-PHP中文网

如何在 Android Studio（Java）中正确读取联系人电话号码

本文详解在 Android 中通过 ContactsContract API 安全、可靠地获取联系人姓名与电话号码的完整流程，重点解决 getColumnIndex(NUMBER) 返回 -1 的常见错误原因（如权限缺失、URI 误用、投影不匹配），并提供适配 Android 6.0+ 动态权限与 API 级别差异的健壮实现。

本文详解在 android 中通过 contactscontract api 安全、可靠地获取联系人姓名与电话号码的完整流程，重点解决 `getcolumnindex(number) 返回 -1` 的常见错误原因（如权限缺失、uri 误用、投影不匹配），并提供适配 android 6.0+ 动态权限与 api 级别差异的健壮实现。

在 Android 中读取联系人电话号码是一个看似简单却极易出错的操作。你遇到的 phoneNumberIndex = -1 错误，根本原因在于：你使用的 contactUri 指向的是 ContactsContract.Contacts 表（联系人摘要），而非 ContactsContract.CommonDataKinds.Phone 表（电话号码明细）。因此，即使光标成功返回，其列名也仅包含 display_name、has_phone_number 等摘要字段（正如你的 Log 输出所示），而 绝不会包含 data1（即 NUMBER 字段） —— 这正是 getColumnIndex(Phone.NUMBER) 返回 -1 的直接原因。

✅ 正确做法：两级查询（Contacts → Phone）

必须分两步操作：

先查联系人摘要（Contacts）：确认该联系人存在且拥有电话号码（has_phone_number == 1）；
再查电话号码明细（Phone）：使用 ContactsContract.CommonDataKinds.Phone.CONTENT_URI 并通过 CONTACT_ID 关联查询。

同时，权限配置必须完整：

OpenJDK 24

下载

<!-- AndroidManifest.xml -->
<uses-permission android:name="android.permission.READ_CONTACTS"></uses-permission><uses-permission android:name="android.permission.READ_CALL_LOG"></uses-permission><!-- 关键！部分厂商ROM必需 -->

⚠️ 注意：READ_CALL_LOG 权限虽非官方文档强制要求，但在 Samsung、Xiaomi、OPPO 等主流定制 ROM 上，缺少它将导致 Phone.NUMBER 字段始终为空或查询失败——这正是你问题中“文档没帮上忙”的核心症结。

✅ 完整、安全的 Java 实现（含动态权限检查）

// 1. 检查并请求必要权限（Android 6.0+）
private static final int REQUEST_PERMISSIONS = 1001;
private void requestContactPermissions() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS)
            != PackageManager.PERMISSION_GRANTED ||
        ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CALL_LOG)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.READ_CONTACTS, Manifest.permission.READ_CALL_LOG},
                REQUEST_PERMISSIONS);
    } else {
        fetchContactPhoneNumber();
    }
}

// 2. 核心逻辑：两级查询
private ContactInfo fetchContactPhoneNumber(Uri contactUri) {
    ContactInfo contactInfo = null;

    // Step 1: 查询 Contacts 表，获取 contact_id 和 has_phone_number
    String[] contactProjection = {
            ContactsContract.Contacts._ID,
            ContactsContract.Contacts.DISPLAY_NAME,
            ContactsContract.Contacts.HAS_PHONE_NUMBER
    };

    try (Cursor contactCursor = getContentResolver().query(
            contactUri, contactProjection, null, null, null)) {

        if (contactCursor == null || !contactCursor.moveToFirst()) {
            Log.e("Contact", "Contact not found or cursor empty");
            return null;
        }

        String contactId = contactCursor.getString(
                contactCursor.getColumnIndexOrThrow(ContactsContract.Contacts._ID));
        int hasPhone = contactCursor.getInt(
                contactCursor.getColumnIndexOrThrow(ContactsContract.Contacts.HAS_PHONE_NUMBER));
        String name = contactCursor.getString(
                contactCursor.getColumnIndexOrThrow(ContactsContract.Contacts.DISPLAY_NAME));

        if (hasPhone == 0) {
            Log.w("Contact", "Contact has no phone number");
            return new ContactInfo(name, null);
        }

        // Step 2: 查询 Phone 表，通过 contact_id 关联获取号码
        String[] phoneProjection = {
                ContactsContract.CommonDataKinds.Phone.NUMBER,
                ContactsContract.CommonDataKinds.Phone.TYPE,
                ContactsContract.CommonDataKinds.Phone.LABEL
        };
        String phoneSelection = ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = ?";

        try (Cursor phoneCursor = getContentResolver().query(
                ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                phoneProjection,
                phoneSelection,
                new String[]{contactId},
                null)) {

            if (phoneCursor != null && phoneCursor.moveToFirst()) {
                String phoneNumber = phoneCursor.getString(
                        phoneCursor.getColumnIndexOrThrow(ContactsContract.CommonDataKinds.Phone.NUMBER));
                contactInfo = new ContactInfo(name, phoneNumber.trim());
                Log.d("Contact", "Found number: " + phoneNumber);
            } else {
                Log.w("Contact", "No phone number found for contact ID: " + contactId);
            }
        }
    } catch (Exception e) {
        Log.e("Contact", "Error fetching contact info", e);
    }

    return contactInfo;
}

? 关键注意事项

永远不要对 ContactsContract.Contacts.CONTENT_URI 使用 Phone.NUMBER 投影：它只返回摘要字段；
READ_CALL_LOG 是隐性刚需：尤其在 Android 10+ 及国产 ROM 上，缺之必败；
使用 getColumnIndexOrThrow() 替代 getColumnIndex()：避免静默 -1 导致崩溃；
空值与空格处理：getString() 可能返回 null 或带空格字符串，务必 trim() 后判空；
适配 Android 8.0+：若需多号码，可在 Phone 查询中遍历 phoneCursor 获取所有号码（moveToNext()）；
UI 线程安全：上述操作应在后台线程（如 AsyncTask、Executors 或 Coroutine）执行，避免阻塞主线程。