在 Android 开发中READ_CONTACTS权限被拒是排查 Content Provider 相关问题时最常见的入口。很多开发者在Main2Activity里写完ActivityCompat.requestPermissions又在onRequestPermissionsResult里判断grantResults[0]结果发现CursorLoader查content://contacts/people依然返回空或者直接抛SecurityException。这类问题的落点往往不在查询代码本身而在权限声明、回调分支、URI 写法、适配器注册方式这几处。本篇从排障视角出发先带你在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一个 Key把 Codex 的 Base URL 指向 https://taotoken.net/api再让 Codex 对照onRequestPermissionsResult和AndroidManifest.xml逐行定位权限被拒的真实原因。TaoToken 在这里只负责给 Codex 提供 Key 和 Base URL不替代 Content Provider 的查询逻辑也不替代你对CursorLoader参数的理解。一、原问题与场景READ_CONTACTS 被拒后 CursorLoader 查不到数据原始场景很典型Main2Activity继承ListActivity在onCreate里用ContextCompat.checkSelfPermission检查Manifest.permission.READ_CONTACTS未授权就调用ActivityCompat.requestPermissions授权则调用listContacts()。listContacts()里用Uri.parse(content://contacts/people)构造 URI交给CursorLoader在后台线程执行查询再用SimpleCursorAdapter把ContactsContract.Contacts.DISPLAY_NAME和_ID映射到R.id.contactName、R.id.contactID最后setListAdapter。问题出在几个容易忽略的细节上。第一onRequestPermissionsResult里只判断了grantResults[0] PackageManager.PERMISSION_GRANTED但没有处理grantResults长度为 0 的情况某些机型在用户直接关闭对话框时会返回空数组此时访问grantResults[0]会越界。第二AndroidManifest.xml里如果只写了uses-permission android:nameandroid.permission.READ_CONTACTS /却漏了READ_CONTACTS在部分目标 SDK 上的运行时校验权限请求会静默失败。第三content://contacts/people是旧版 Contacts Provider 的写法在较新系统上更推荐ContactsContract.Contacts.CONTENT_URI否则可能查到空游标。第四SimpleCursorAdapter的构造函数如果用了已弃用的五参数版本没有传CursorAdapter.FLAG_REGISTER_CONTENT_OBSERVER数据变化时列表不会刷新看起来像“权限被拒后一直空白”。这些点单靠肉眼扫代码很容易漏。把 Codex 通道配通后可以让它把onRequestPermissionsResult、AndroidManifest.xml、listContacts()三处放在一起比对快速指出哪一处导致权限被拒或查询落空。二、TaoToken 前置给 Codex 配好 Key 与 Base URLTaoToken 的定位很明确它不替代 Android Studio也不替代 Content Provider 的查询逻辑它只做一件事——给 Codex 这类编码工具提供可用的 Key 和 Base URL让 Codex 能稳定地读取你的工程文件并做代码级排查。所以前置动作只有两步。第一步打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 在控制台创建一个 API Key。这个 Key 就是后面填进 Codex 配置里的凭证。创建入口在控制台的 API Keys 页面建议单独建一个用于本次排障的 Key方便后续轮换。第二步把 Codex 的 Base URL 填成 https://taotoken.net/api 。注意这里不要加任何多余路径Codex 的配置项通常叫base_url或OPENAI_BASE_URL具体字段名取决于你用的 Codex 版本。填完后Codex 发出的请求会走 TaoToken 的通道再由通道转发到模型侧。你不需要改CursorLoader的任何参数也不需要动AndroidManifest.xml配通道的目的只是让 Codex 能“看见”你的工程并给出定位建议。如果你用的是命令行方式启动 Codex可以先安装 CLInpm i -g taotoken/taotoken然后用一条命令把 Key、Base URL、模型 ID 一起传进去taotoken cc -k YOUR_API_KEY -u https://taotoken.net/api -m MODEL_ID这条命令里的-u就是 Base URL-k是刚创建的 Key-m是你要用的模型 ID。执行后 Codex 会以当前目录为工程根目录启动后续你让它读Main2Activity.java和AndroidManifest.xml时它就能直接定位到文件。三、可复制配置Codex 通道与工程文件对照配置分两块一块是 Codex 侧的通道配置一块是 Android 工程侧需要 Codex 对照的文件清单。Codex 侧如果你用的是配置文件方式通常在用户目录下建一个config.toml写入base_url https://taotoken.net/api api_key YOUR_API_KEY model MODEL_ID如果你用的是环境变量方式则设置export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEYYOUR_API_KEY两种方式选一种即可不要同时配否则容易出现 Key 覆盖。配完后可以用一条最小请求验证通道是否通curl https://taotoken.net/api/v1/models \ -H Authorization: Bearer YOUR_API_KEY如果返回模型列表说明 Key 和 Base URL 都正确。这一步很关键因为后面让 Codex 排查权限问题时如果通道本身不通Codex 会报连接错误而不是给你权限相关的建议容易误判。Android 工程侧你需要让 Codex 对照的文件至少包括Main2Activity.java重点看onCreate里的权限检查分支、onRequestPermissionsResult的回调分支、listContacts()里的 URI 和CursorLoader参数。AndroidManifest.xml重点看uses-permission android:nameandroid.permission.READ_CONTACTS /是否存在以及targetSdkVersion是否影响运行时权限。activity_main2.xml重点看R.id.contactName和R.id.contactID是否真实存在SimpleCursorAdapter的views数组是否和布局里的 ID 一一对应。build.gradle重点看compileSdkVersion和targetSdkVersion因为CursorLoader在 API 11 以上才可用SimpleCursorAdapter的新构造函数也需要对应版本。把这些文件放在同一个工程目录下启动 Codex 时以该目录为根然后给它一句明确的指令例如“对照 Main2Activity.java 的 onRequestPermissionsResult 和 AndroidManifest.xml找出 READ_CONTACTS 权限被拒后 CursorLoader 查询 content://contacts/people 返回空的可能原因按可能性排序。” Codex 会逐文件读取并给出定位。四、验证请求与成功结果权限通过后 CursorLoader 正常返回配置完成后验证分两步。第一步验证 Codex 通道第二步验证 Android 侧权限与查询。Codex 通道验证用上面的curl即可。如果返回 401说明 Key 不对如果返回 404说明 Base URL 路径写错检查是否误写成了https://taotoken.net/api/v1之外的多余路径如果返回模型列表说明通道正常。Android 侧验证先在设备上手动授予通讯录权限然后观察listContacts()是否被调用。如果onRequestPermissionsResult里grantResults[0]为PERMISSION_GRANTED但列表仍为空重点查三处一是content://contacts/people是否应换成ContactsContract.Contacts.CONTENT_URI二是CursorLoader的projection是否传了null传null会返回所有列效率低但不会导致空结果三是SimpleCursorAdapter的columns和views长度是否一致长度不一致会直接抛异常而不是返回空。一个可复制的成功结果长这样权限对话框弹出用户点“允许”onRequestPermissionsResult收到REQUEST_READ_CONTACTS且grantResults[0]为PERMISSION_GRANTEDlistContacts()执行CursorLoader.loadInBackground()返回非空CursorSimpleCursorAdapter把DISPLAY_NAME和_ID绑定到ListView界面上出现通讯录姓名和 ID。如果此时你让 Codex 检查日志它会提示你确认Cursor的getCount()是否大于 0以及moveToFirst()是否返回 true。如果权限被拒onRequestPermissionsResult里走else分支弹出 “Permission Denied”此时listContacts()不会被调用列表自然空白。这种情况下不要急着改查询代码先让 Codex 检查AndroidManifest.xml的权限声明和targetSdkVersion因为运行时权限在 targetSdk 23 以上才强制低于 23 时安装即授权不会弹对话框。五、本篇常见错排查READ_CONTACTS 与 Content Provider 的六个落点第一个落点AndroidManifest.xml漏写权限。这是最基础的错误但经常因为复制粘贴漏掉。检查uses-permission android:nameandroid.permission.READ_CONTACTS /是否在manifest下、application外。第二个落点onRequestPermissionsResult的requestCode不匹配。ActivityCompat.requestPermissions传的是REQUEST_READ_CONTACTS回调里switch也必须用同一个常量如果写成字面量123而常量定义变了就会走到default分支权限结果被忽略。第三个落点grantResults空数组越界。部分机型在用户直接点对话框外部关闭时会返回空grantResults此时grantResults[0]会抛ArrayIndexOutOfBoundsException。正确写法是先判断grantResults.length 0。第四个落点URI 写法过时。content://contacts/people在旧版 Contacts Provider 上可用但新系统更推荐ContactsContract.Contacts.CONTENT_URI。如果查询返回空游标先换 URI 再试。第五个落点SimpleCursorAdapter构造函数弃用。旧版五参数构造函数在 Honeycomb 之后被弃用新版六参数需要传CursorAdapter.FLAG_REGISTER_CONTENT_OBSERVER否则 Content Provider 数据变化时列表不刷新看起来像查询失败。第六个落点CursorLoader的selection和selectionArgs不匹配。如果selection里写了?但selectionArgs传了null查询会抛异常。例如按姓名筛选时ContactsContract.Contacts.DISPLAY_NAME LIKE ?必须配new String[]{%Lee}。这六个落点里前三个和权限直接相关后三个和 Content Provider 查询相关。让 Codex 按这个顺序检查通常能在几分钟内定位到具体行。如果你在排查过程中需要看模型对话来确认某个 API 的用法可以走模型对话入口如果需要长期在工程里做这类排查可以考虑 Coding Plan把 Codex 通道固定下来避免每次重新配 Key。六、语义一致 CTA按排障路径分流本篇的核心是排障所以 CTA 按排障路径分流不堆首页链接。如果你已经配好 Key 和 Base URL但 Codex 仍然报连接错误或者你想确认settings.json、ANTHROPIC_*这类配置字段的写法走 API Keys 和接入文档先到 https://taotoken.net/api-keys 检查 Key 状态再到 https://taotoken.net/doc 对照接入文档确认 Base URL 和字段名。如果你用的是 Claude Code重点看settings.json里的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY如果你用的是 Codex重点看config.toml里的base_url和api_key。如果你已经确认通道正常只是想验证某个模型对CursorLoader参数的解释是否正确走模型对话https://taotoken.net/chat 把Main2Activity的listContacts()片段贴进去问它projection传null和传具体列数组的区别。如果你打算长期在 Android 工程里做这类权限和 Content Provider 排查每次都要重新配 Key 很麻烦走 Coding Planhttps://taotoken.net/coding-plan 把 Codex 通道固定下来后续直接以工程目录启动即可。如果你在排查READ_CONTACTS时遇到的是CC Switch或Cline这类工具的配置问题同样先走 API Keys 和接入文档确认 Key 和 Base URL 的填写位置再回到工程里让 Codex 对照onRequestPermissionsResult和AndroidManifest.xml定位权限落点。TaoToken 在这里的角色始终是提供 Key 和 Base URLContent Provider 的查询逻辑、CursorLoader的参数、SimpleCursorAdapter的映射仍然由你在工程里决定。
