1. Android 2.1 读取联系人信息踩过的坑与场景还原Android 2.1 获取联系人信息这件事放在今天看像是考古但真到维护老设备、车机、工控面板或者教学模拟器的时候你还是得把ContactsContract这套 API 翻出来。它是什么简单说就是 Android 2.0 之后取代旧People接口的联系人数据访问层能做什么让你通过ContentResolver查询联系人姓名、ID、电话号码、邮箱等字段。适合谁正在做 Android 2.1 兼容适配、需要在低版本系统上跑通联系人读取并做接口校验的开发者。我试过在 API Level 7 的模拟器上直接抄网上老代码结果READ_CONTACTS没声明query返回 null日志里一片安静。后来把权限、URI、游标解析、字段判空这几步拆开才把链路跑通。这篇就按“权限声明 → 查询代码 → 通过 TaoToken 统一 Key 通道做接口调用与结果校验 → 报错排查”的顺序给你一份能直接复制的操作记录。核心检索词先摆出来Android 2.1 获取联系人信息、READ_CONTACTS 权限适配、ContactsContract 查询游标解析。这三个词贯穿全文你照着做就能在模拟器上输出联系人列表验证日志。需要提前说明的是Android 2.1 的ContactsContract和后续版本在字段常量上基本一致但权限模型、运行时行为、targetSdkVersion处理差别很大。2.1 时代还是安装时授权没有运行时权限弹窗所以AndroidManifest.xml里写清楚就行。但如果你把同一套代码放到高版本跑就必须补运行时申请否则query直接抛SecurityException。这也是很多人搜“android2.1获得联系人信息”却在高版本模拟器上失败的原因。场景还原一下你有一个 Android 2.1 的模拟器或者老设备想读取通讯录里的姓名和手机号同时希望把读取结果通过一个统一的 API 通道上报或校验避免每个设备单独配 Key。TaoToken 在这里扮演的是统一 Key/API 通道的角色官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 地址是 https://taotoken.net/api 。注意它不是让你绕过系统权限而是帮你把“读取到的联系人数据做接口调用与结果校验”这一步的鉴权统一起来。下面进入实操。先确认你的工程minSdkVersion和targetSdkVersion。Android 2.1 对应 API Level 7targetSdkVersion建议写 7 或 8避免高版本行为干扰。然后声明权限再写查询方法最后接 TaoToken 通道做校验。每一步我都会给可复制的片段和预期结果。2. TaoToken 统一 Key 通道前置准备与 READ_CONTACTS 权限声明在写联系人查询之前先把 TaoToken 的前置准备做完这样后面读取到数据就能立刻做接口校验不用来回切工程。TaoToken 提供统一 Key 和 API 通道适合多设备、多环境共用一套鉴权配置的场景。你需要拿到三件套Base URL、API Key、Model ID。Base URL 用 https://taotoken.net/api API Key 在控制台的 API Keys 页面创建Model ID 按你实际要调用的模型填写。创建 Key 的入口在控制台路径是 console 下的 api-keys。如果你用的是 Claude Code 这类编码工具做辅助开发也可以走 coding-plan 通道但本篇重点是 Android 端读取联系人后做接口校验所以用标准 API Key 即可。文档入口在 doc 里遇到字段不清楚可以查。拿到 Key 之后Android 2.1 工程里做网络请求要注意2.1 时代HttpURLConnection是主力OkHttp高版本可能不兼容建议直接用HttpURLConnection或者DefaultHttpClient。同时别忘了在AndroidManifest.xml里加INTERNET权限否则接口调用直接失败。权限声明部分READ_CONTACTS是必须的。Android 2.1 没有运行时权限所以写在 manifest 里就生效。完整片段如下?xml version1.0 encodingutf-8? manifest xmlns:androidhttp://schemas.android.com/apk/res/android packagecom.example.contactdemo android:versionCode1 android:versionName1.0 uses-sdk android:minSdkVersion7 android:targetSdkVersion7 / uses-permission android:nameandroid.permission.READ_CONTACTS / uses-permission android:nameandroid.permission.INTERNET / application android:labelstring/app_name android:icondrawable/ic_launcher activity android:name.MainActivity android:labelstring/app_name intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity /application /manifest注意targetSdkVersion7这一行。如果你写成高版本部分模拟器会启用新的权限校验逻辑导致query行为不一致。实测下来API 7 模拟器上这样写最稳。TaoToken 的配置建议单独放一个常量类方便替换public class TaoTokenConfig { public static final String BASE_URL https://taotoken.net/api; public static final String API_KEY sk-你的Key; public static final String MODEL_ID 你的ModelID; }这里的三件套 Base URL、API Key、Model ID 必须齐全缺一个接口就会返回 401 或者模型不存在。很多人只填了 Key 忘了 Model ID结果报model not found排查半天。权限声明完先别急着写查询。建议在MainActivity的onCreate里加一行日志确认权限确实被系统识别Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); int result checkCallingOrSelfPermission(android.permission.READ_CONTACTS); System.out.println(READ_CONTACTS check result result); }如果输出0说明权限已授予输出-1就是没声明成功。这一步能帮你快速定位“查询返回 null”是不是权限引起的。3. ContactsContract 查询与游标解析的可复制配置这一节是核心。Android 2.1 获取联系人信息靠的是ContactsContract.Contacts.CONTENT_URI和ContactsContract.CommonDataKinds.Phone.CONTENT_URI两个 URI。前者拿姓名和 ID后者拿电话号码。旧People接口已经废弃别再用了。先给完整查询方法你可以直接复制到MainActivity里public void getContact() { Cursor cur getContentResolver().query( ContactsContract.Contacts.CONTENT_URI, null, null, null, null); if (cur null) { System.out.println(contacts cursor is null, check READ_CONTACTS); return; } if (cur.moveToFirst()) { int idColumn cur.getColumnIndex(ContactsContract.Contacts._ID); int displayNameColumn cur.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME); int hasPhoneColumn cur.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER); do { String contactId cur.getString(idColumn); String displayName cur.getString(displayNameColumn); int phoneCount cur.getInt(hasPhoneColumn); System.out.println(contactId contactId , name displayName); if (phoneCount 0) { Cursor phones getContentResolver().query( ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID contactId, null, null); if (phones ! null phones.moveToFirst()) { do { String phoneNumber phones.getString( phones.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER)); System.out.println(phone phoneNumber); } while (phones.moveToNext()); } if (phones ! null) { phones.close(); } } } while (cur.moveToNext()); } cur.close(); }如果你只想拿手机号过滤条件加上TYPE_MOBILECursor phones getContentResolver().query( ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID contactId and ContactsContract.CommonDataKinds.Phone.TYPE ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE, null, null);这里有几个容易忽略的点。第一cur.getColumnIndex在 Android 2.1 上如果字段不存在会返回-1直接getString(-1)会抛异常所以字段名必须和常量完全一致。第二HAS_PHONE_NUMBER返回的是0或1不是布尔别写成getBoolean。第三游标用完必须close()2.1 时代资源回收没现在积极不关容易泄漏。为了让读取结果能通过 TaoToken 通道做校验我把联系人数据拼成 JSON再用HttpURLConnection发出去。配置片段如下public void uploadContacts(String jsonBody) { try { URL url new URL(TaoTokenConfig.BASE_URL /v1/chat/completions); HttpURLConnection conn (HttpURLConnection) url.openConnection(); conn.setRequestMethod(POST); conn.setRequestProperty(Content-Type, application/json); conn.setRequestProperty(Authorization, Bearer TaoTokenConfig.API_KEY); conn.setDoOutput(true); OutputStream os conn.getOutputStream(); os.write(jsonBody.getBytes(UTF-8)); os.close(); int code conn.getResponseCode(); System.out.println(taotoken response code code); InputStream is (code 200 code 300) ? conn.getInputStream() : conn.getErrorStream(); BufferedReader reader new BufferedReader(new InputStreamReader(is)); String line; StringBuilder sb new StringBuilder(); while ((line reader.readLine()) ! null) { sb.append(line); } reader.close(); System.out.println(taotoken response body sb.toString()); } catch (Exception e) { e.printStackTrace(); } }请求体里带上model字段值就是TaoTokenConfig.MODEL_ID。这样三件套 Base URL、API Key、Model ID 全部用上接口才能正常返回。4. 模拟器验证请求与成功结果日志配置写完跑一遍验证。先在 Android 2.1 模拟器里手动加两个联系人一个带手机号一个不带方便观察分支。然后调用getContact()再调用uploadContacts()。预期日志分两段。第一段是联系人读取READ_CONTACTS check result 0 contactId1, name张三 phone13800000000 contactId2, name李四第二段是 TaoToken 接口返回taotoken response code 200 taotoken response body {id:chatcmpl-xxx,choices:[{message:{role:assistant,content:...}}]}看到response code 200并且choices里有内容说明整条链路通了权限声明生效、ContactsContract查询成功、游标解析正确、TaoToken 统一 Key 通道鉴权通过。如果你想单独验证模型通道是否正常可以走模型对话入口用同样的 Key 发一条简单消息确认返回结构一致。这一步能帮你区分是联系人读取的问题还是接口鉴权的问题。验证时注意模拟器网络。Android 2.1 模拟器默认可能没有网络需要在启动参数里加 DNS 或者用10.0.2.2访问宿主机。如果你直接请求https://taotoken.net/api确认模拟器能解析域名。实测下来API 7 模拟器对 TLS 支持有限如果遇到握手失败检查 JDK 版本和模拟器镜像。成功结果还有一个细节choices数组里message.content是字符串如果你做结果校验解析时注意转义。Android 2.1 自带org.json可以直接用JSONObject obj new JSONObject(responseBody); JSONArray choices obj.getJSONArray(choices); String content choices.getJSONObject(0) .getJSONObject(message) .getString(content); System.out.println(parsed content content);这样你就完成了从联系人读取到接口校验的闭环。5. 本篇常见报错排查401、cursor null 与 OAuth 问题跑不通的时候对照下面几类真实报错排查。第一类taotoken response code 401。这是鉴权失败原因通常是 API Key 写错、Key 被删除、或者Authorization头格式不对。正确格式是Bearer加空格加 Key。检查TaoTokenConfig.API_KEY有没有多余空格确认 Key 是在 console 的 api-keys 页面创建的。如果用的是 Claude Code 相关通道注意 OAuth 流程和 API Key 是两套别混用。第二类contacts cursor is null。这是权限或 URI 问题。先看READ_CONTACTS是否声明再看targetSdkVersion是否过高。高版本需要运行时申请2.1 不需要。如果权限没问题检查ContactsContract.Contacts.CONTENT_URI有没有拼错。还有一种情况是模拟器通讯录为空moveToFirst()返回 false日志里不会打印联系人但游标不是 null注意区分。第三类local proxy failed。这个报错通常出现在网络层说明请求没发出去。检查模拟器网络、INTERNET权限、以及 Base URL 是否写成https://taotoken.net/api。如果你在代码里配了本地代理去掉再试。注意不要使用任何非官方的网络中转方式直接用标准 API 地址。第四类reading choices相关解析异常。返回体里没有choices字段可能是 Model ID 填错或者请求体缺少model字段。确认三件套 Base URL、API Key、Model ID 都正确。如果返回的是错误对象先打印完整 body 再解析。第五类OAuth相关报错。如果你在 Claude Code 或类似工具里配置OAuth 和 API Key 是不同鉴权方式。本篇 Android 端用 API Key不要走 OAuth 回调。遇到 OAuth 报错回到 api-keys 页面重新生成 Key。第六类SecurityException: Permission Denial。这是READ_CONTACTS没生效。Android 2.1 上检查 manifest 的uses-permission是否在application标签外。高版本上补运行时申请。排查顺序建议先看权限日志再看游标是否为 null再看接口返回码最后看解析。这样能快速定位是读取环节还是接口环节。6. 语义一致 CTA 与后续接入建议整条链路跑通后你可以把联系人读取和接口校验拆成两个模块方便复用。读取模块只负责ContactsContract查询和游标解析校验模块只负责 TaoToken 通道调用。这样换设备、换模型时只改配置类。如果你后续要做长期编码或 Agent 类任务可以了解 Coding Plan 通道适合持续性的开发辅助场景。如果只是验证模型返回走模型对话入口更直接。接口鉴权和 Key 管理统一在 API Keys 页面处理接入细节查接入文档。需要再确认一遍三件套Base URL 用 https://taotoken.net/api API Key 在控制台创建Model ID 按实际调用填写。Android 2.1 获取联系人信息这件事难点不在查询本身而在权限适配和游标边界处理。把这两块做稳再接统一 Key 通道做校验整个流程就能在模拟器上稳定复现。