小米手机 Attempt to invoke interface method ‘boolean android.database.Cursor.moveToFirst()‘ 空指针异常排查：从 Ur

1. 小米手机 Cursor.moveToFirst 空指针异常到底怎么来的android.database.Cursor.moveToFirst()空指针异常说白了就是cursor这个对象本身是null你却直接调了它的方法。在小米手机MIUI上这个问题特别容易出现在「选图片 / 选文件」之后拿路径的环节。你写的是标准写法Cursor cursor getContentResolver().query(uri, proj, null, null, null); cursor.moveToFirst(); // 这里崩了别的机型跑得好好的一到小米就崩异常栈顶就是Attempt to invoke interface method boolean android.database.Cursor.moveToFirst() on a null object reference。核心检索词就是「小米手机 Cursor.moveToFirst 空指针异常」它属于 Android 媒体库查询里非常典型的一类坑。先讲清楚它是什么、能影响谁。ContentResolver.query()的返回值是Cursor但这个方法允许返回 null。官方文档写得很清楚查询失败、Uri 无法识别、权限不足、provider 进程异常时都可能返回 null。很多教程代码默认它非空于是moveToFirst()就成了定时炸弹。适合阅读本文的人做 Android 相册选图、文件选择、图片上传、裁剪跳转的开发者尤其是需要兼容 MIUI 的团队。为什么小米特别容易触发关键在于Uri 的形态。Android 4.4KITKAT之前ACTION_PICK返回的 Uri 往往带绝对路径uri.getPath()直接能用。4.4 之后系统改成返回content://形式的媒体库编码 Uri需要再查一次_data列才能拿到绝对路径。而 MIUI 不管版本高低用ACTION_PICK拿到的经常只是一个图片编码 Uri甚至在某些版本里这个 Uri 的 authority 和标准 MediaStore 不一致导致query()直接返回 null。我试过在几台小米上对比同一段选图代码ACTION_PICK在小米上崩换成ACTION_GET_CONTENT后低版本能拿到路径高版本仍然要走转换。所以真正的排查链路是三层第一层确认 Uri 从哪来哪个 Action、哪个 scheme第二层确认query()是否返回 null而不是假设它非空第三层才是把 content Uri 转成绝对路径。很多人一上来就抄转换工具类却忽略了第一层结果 Uri 本身就不对工具类里query()照样返回 null异常只是换了个位置。还有一个隐蔽点file://与绝对路径混用。有些老代码在onActivityResult里判断uri.getScheme().equals(file)就直接uri.getPath()但小米返回的可能是content://getScheme()是content走到else分支后没做判空cursor为 null 就崩。反过来如果你强行把content://拼成file://去读也会因为权限或路径不存在而查询失败。所以「Uri 解析」和「路径互转」必须成对处理不能只做一半。下面这张表先帮你建立判断依据后面每一节都会围绕它展开现象可能原因先查什么moveToFirst 空指针query 返回 null打印 uri.toString() 和 scheme只有小米崩MIUI 返回编码 Uri换 ACTION_GET_CONTENT 并做转换拿到路径为 null没查 _data 列检查 projection 与列名file 路径读不到content/file 混用统一走 Uri 转换工具理解了这个链路你就知道为什么单纯加一句if (cursor ! null)只能防崩、不能拿到路径。防崩是底线拿到正确路径才是目标。下一节先解决「查询前的准备」也就是把 Uri 来源和权限理顺再进入可复制的配置代码。2. TaoToken 前置准备把模型接入和排查思路一起理清这一节讲前置准备。你可能会问排查一个 Android 空指针跟模型接入有什么关系关系在于这类兼容性问题往往需要反复查文档、比对不同版本的 API 行为、生成和验证工具类代码。如果你手边有一个稳定的模型对话入口用来快速核对DocumentsContract的用法、生成判空封装、解释异常栈效率会高很多。TaoToken 就是这样一个入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。先说清楚它是什么、能做什么、适合谁。TaoToken 提供统一的模型调用入口你可以用它做模型对话、代码生成、文档问答也可以配合 Coding Plan 做长期的编码辅助。适合的人群包括需要边写 Android 代码边查 API 的开发者、要批量生成兼容性工具方法的团队、以及想把模型能力接进自己工具链的人。对于本文场景最实用的用法是把异常栈贴进去让它帮你定位是 Uri 问题还是判空问题或者让它按你的项目结构生成MiPictureHelper这类工具类你再对照修改。前置准备分三步。第一步拿到 API Key。进入控制台创建密钥地址是 https://taotoken.net/console 密钥管理页在 https://taotoken.net/api-keys 。创建后复制保存注意不要提交到 Git 仓库。第二步确认你要用的模型 ID。不同模型在代码理解和长上下文上的表现不同排查异常栈建议选上下文较长的模型。第三步选接入方式临时验证用模型对话页 https://taotoken.net/models 长期编码用 Coding Plan https://taotoken.net/coding-plan 需要看接口细节查文档 https://taotoken.net/doc 。这里要强调一个安全边界TaoToken 是合规的模型调用入口不是任何形式的网络中转工具也不涉及绕过网络限制的操作。你只需要把它当成一个「模型 API 服务」来用即可。所有配置都通过标准的 Base URL API Key Model ID 三件套完成和调用其他模型服务的方式一致。如果你用的是 Claude Code 这类命令行编码工具接入时同样遵循三件套。Base URL 填 https://taotoken.net/api Key 填你创建的密钥Model ID 填你选定的模型。具体路径参考文档 https://taotoken.net/doc 里面有 ClaudeCodeAnthropic 相关的接入说明。配置完成后你就可以在终端里直接让它帮你分析 Android 异常、生成工具类、解释DocumentsContract.isDocumentUri的返回值差异。为什么要在排查前做这一步因为 Cursor 空指针的根因往往不在你写的那一行而在 Uri 的来源和版本分支。人工翻文档容易漏模型可以帮你把「4.4 前后差异 MIUI 特例 file/content 混用」这几条线一次性列出来你再逐条验证。下一节进入可复制配置我会给出完整的判空封装、Uri 转路径工具类以及settings级别的接入片段你可以直接抄进项目。3. 可复制配置Cursor 判空封装与 Uri 路径互转工具类这一节是全文的技术核心给出可以直接复制进项目的代码。先给接入侧的配置片段再给 Android 侧的判空封装和路径转换工具类。接入配置以 JSON 形式给出路径与原文一致方便你对照自己的工具链修改。{ provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的密钥, model_id: 你的模型ID, timeout_seconds: 60 }如果你用的是 TOML 风格的配置比如某些 CLI 工具等价写法如下[provider.taotoken] base_url https://taotoken.net/api api_key sk-你的密钥 model_id 你的模型ID timeout_seconds 60如果你用的是 Claude Code 的 settings 风格配置路径通常在你的用户配置目录下字段名以官方文档为准核心仍是 Base URL、Key、Model ID 三项。配置完成后可以用模型对话页 https://taotoken.net/models 做一次连通性验证确认返回正常再进入编码环节。接下来是 Android 侧。第一件事永远不要假设 query 返回非空。把查询封装成一个安全方法返回 null 时给出明确日志而不是让调用方去猜。public static Cursor safeQuery(Context context, Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { if (context null || uri null) { Log.w(SafeQuery, context or uri is null, uri uri); return null; } Cursor cursor null; try { cursor context.getContentResolver().query(uri, projection, selection, selectionArgs, sortOrder); if (cursor null) { Log.w(SafeQuery, query returned null, uri uri , scheme uri.getScheme()); } } catch (Exception e) { Log.e(SafeQuery, query threw exception, uri uri, e); if (cursor ! null) { cursor.close(); cursor null; } } return cursor; }有了这个封装任何调用点都必须先判空再moveToFirst()Cursor cursor safeQuery(context, uri, projection, null, null, null); if (cursor ! null cursor.moveToFirst()) { int index cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA); String path cursor.getString(index); Log.i(PathResult, resolved path path); } else { Log.w(PathResult, cursor is null or empty, fallback needed, uri uri); } cursor.close();注意cursor.close()要放在判空之外且确保 cursor 非空时才关。更稳妥的写法是用 try-finally前面safeQuery已经处理了异常这里只需保证关闭。第二件事Uri 与绝对路径互转。下面这个工具类覆盖了 DocumentProvider、DownloadsProvider、MediaProvider、content 和 file 五种情况并对每个query结果判空。它和原文的MiPictureHelper思路一致但补上了判空和日志避免在小米上再次踩坑。public class UriPathHelper { public static String getPath(Context context, Uri uri) { if (uri null) { Log.w(UriPathHelper, uri is null); return null; } Log.i(UriPathHelper, resolve uri uri , scheme uri.getScheme()); boolean isKitKat Build.VERSION.SDK_INT Build.VERSION_CODES.KITKAT; if (isKitKat DocumentsContract.isDocumentUri(context, uri)) { if (isExternalStorageDocument(uri)) { String docId DocumentsContract.getDocumentId(uri); String[] split docId.split(:); if (primary.equalsIgnoreCase(split[0])) { return Environment.getExternalStorageDirectory() / split[1]; } } else if (isDownloadsDocument(uri)) { String id DocumentsContract.getDocumentId(uri); Uri contentUri ContentUris.withAppendedId( Uri.parse(content://downloads/public_downloads), Long.valueOf(id)); return getDataColumn(context, contentUri, null, null); } else if (isMediaDocument(uri)) { String docId DocumentsContract.getDocumentId(uri); String[] split docId.split(:); Uri contentUri null; if (image.equals(split[0])) { contentUri MediaStore.Images.Media.EXTERNAL_CONTENT_URI; } else if (video.equals(split[0])) { contentUri MediaStore.Video.Media.EXTERNAL_CONTENT_URI; } else if (audio.equals(split[0])) { contentUri MediaStore.Audio.Media.EXTERNAL_CONTENT_URI; } return getDataColumn(context, contentUri, _id?, new String[]{split[1]}); } } else if (content.equalsIgnoreCase(uri.getScheme())) { if (isGooglePhotosUri(uri)) { return uri.getLastPathSegment(); } return getDataColumn(context, uri, null, null); } else if (file.equalsIgnoreCase(uri.getScheme())) { return uri.getPath(); } return null; } public static String getDataColumn(Context context, Uri uri, String selection, String[] selectionArgs) { Cursor cursor null; String column _data; String[] projection {column}; try { cursor context.getContentResolver().query(uri, projection, selection, selectionArgs, null); if (cursor ! null cursor.moveToFirst()) { int index cursor.getColumnIndexOrThrow(column); return cursor.getString(index); } else { Log.w(UriPathHelper, getDataColumn cursor null or empty, uri uri); } } catch (Exception e) { Log.e(UriPathHelper, getDataColumn failed, uri uri, e); } finally { if (cursor ! null) { cursor.close(); } } return null; } public static boolean isExternalStorageDocument(Uri uri) { return com.android.externalstorage.documents.equals(uri.getAuthority()); } public static boolean isDownloadsDocument(Uri uri) { return com.android.providers.downloads.documents.equals(uri.getAuthority()); } public static boolean isMediaDocument(Uri uri) { return com.android.providers.media.documents.equals(uri.getAuthority()); } public static boolean isGooglePhotosUri(Uri uri) { return com.google.android.apps.photos.content.equals(uri.getAuthority()); } }调用侧要配合ACTION_GET_CONTENT并分版本处理这是原文验证过的统一方案Intent intent new Intent(Intent.ACTION_GET_CONTENT); intent.setType(image/*); startActivityForResult(intent, PICK_PICTURE); Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); if (requestCode PICK_PICTURE resultCode RESULT_OK data ! null) { Uri uri data.getData(); String path UriPathHelper.getPath(this, uri); Log.i(PickResult, uri uri , path path); if (path null) { Log.w(PickResult, path is null, need fallback by copying stream); } } }如果getPath仍然返回 null说明该 Uri 无法通过_data列解析这时不要硬转改为把InputStream拷贝到应用私有目录再使用。这是最稳的兜底方案也能绕开 MIUI 的编码 Uri 差异。下一节讲如何验证 query 返回值用日志和断点把问题钉死。4. 验证请求与成功结果用日志和断点确认 query 返回值代码抄完不代表问题解决必须验证。这一节给出具体的验证动作目标是确认三件事Uri 的 scheme 是什么、query()到底返回了 null 还是空 Cursor、最终路径是否正确。验证手段是日志加断点两者配合。先看日志。在safeQuery和getDataColumn里我已经埋了日志关键字段是uri、scheme、authority。运行后过滤 tagSafeQuery和UriPathHelper你会看到类似输出I/UriPathHelper: resolve uricontent://media/external/images/media/12345, schemecontent W/SafeQuery: query returned null, uricontent://media/external/images/media/12345, schemecontent如果看到query returned null说明这个 Uri 在当前设备上无法被 MediaStore 识别可能是 MIUI 的 authority 差异也可能是权限问题。如果看到getDataColumn cursor null or empty说明 query 没抛异常但返回了空结果通常是 selection 条件不对或列名不匹配。再看断点。在cursor.moveToFirst()这一行打断点运行到小米设备上观察cursor的值。如果断点处cursor显示为null那就直接证实了空指针来源。此时在 Variables 面板里展开uri看它的scheme和authority和标准 MediaStore 对比。这一步能帮你区分是「Uri 本身不对」还是「查询条件不对」。验证成功的结果应该长这样I/UriPathHelper: resolve uricontent://media/external/images/media/12345, schemecontent I/PickResult: uricontent://media/external/images/media/12345, path/storage/emulated/0/DCIM/Camera/IMG_20240101_120000.jpg拿到这个绝对路径后你可以直接用于上传、裁剪或显示。如果路径是 null日志会提示path is null, need fallback by copying stream这时走兜底方案public static String copyToCache(Context context, Uri uri) { try (InputStream in context.getContentResolver().openInputStream(uri)) { if (in null) return null; File dir new File(context.getCacheDir(), picked); if (!dir.exists()) dir.mkdirs(); File out new File(dir, img_ System.currentTimeMillis() .jpg); try (OutputStream os new FileOutputStream(out)) { byte[] buf new byte[8192]; int len; while ((len in.read(buf)) ! -1) { os.write(buf, 0, len); } } Log.i(CopyToCache, copied to out.getAbsolutePath()); return out.getAbsolutePath(); } catch (Exception e) { Log.e(CopyToCache, copy failed, uri uri, e); return null; } }这个兜底方案不依赖_data列只要openInputStream能打开就能用兼容性最好。验证时建议在小米和其他品牌各跑一遍对比日志差异。如果只有小米走到兜底分支说明 MIUI 的 Uri 确实特殊但你的代码已经能兜住不会再崩。还有一个验证技巧把DocumentsContract.isDocumentUri(context, uri)的返回值也打出来。有些小米返回的 Uri 看起来是content://但isDocumentUri返回 false于是代码走不到 DocumentProvider 分支直接落到getDataColumn而getDataColumn里 query 返回 null。打印这个布尔值能帮你快速定位分支走向。验证通过后建议把日志级别从Log.i降到Log.d避免线上刷屏但保留Log.w和Log.e用于异常上报。下一节集中处理常见报错把 401、local proxy failed、reading choices、OAuth 这几类错误和本文场景对照起来。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 对照排查环节要分清两类错误一类是 Android 运行时的 Cursor 问题一类是接入模型服务时的配置问题。两者容易混在一起因为很多人一边调 Android 一边用模型辅助报错信息混着看就乱了。这一节逐条对照。先说 Android 侧最典型的报错。Attempt to invoke interface method boolean android.database.Cursor.moveToFirst() on a null object reference根因就是 cursor 为 null解决方式是本文第 3 节的判空封装。CursorIndexOutOfBoundsException则是 cursor 非空但列索引不对检查getColumnIndexOrThrow的列名是否存在于 projection 中。SecurityException: Permission Denial说明没申请读媒体权限Android 13 之后要用READ_MEDIA_IMAGES低版本用READ_EXTERNAL_STORAGE。再说接入侧的报错。401 Unauthorized通常表示 API Key 无效或没带上检查api_key字段是否填对、是否有多余空格、是否用了过期密钥。local proxy failed一般出现在本地网络配置异常时检查你的运行环境是否能正常访问https://taotoken.net/api以及是否有本地网络策略拦截。reading choices这类报错多出现在流式响应解析阶段通常是响应体格式和客户端预期不一致检查模型 ID 是否填错、接口路径是否为/api。OAuth相关报错出现在使用 OAuth 流程的工具里检查回调地址和授权范围是否配置正确。把两类错误对照成一张表排查时先分类再定位报错关键词所属环节优先检查moveToFirst nullAndroid 查询cursor 判空、Uri schemePermission DenialAndroid 权限媒体权限声明与动态申请401 Unauthorized模型接入API Key 是否正确local proxy failed网络环境能否访问 API 地址reading choices响应解析Model ID 与接口路径OAuth授权流程回调地址与授权范围如果你用的是 Claude Code 或 Cline MCP 这类工具配置时必须写全三件套Base URL 填https://taotoken.net/apiKey 填控制台创建的密钥Model ID 填你选定的模型。三者缺一就会出现 401 或 reading choices。Codex 的auth.json同理字段名以文档为准核心信息不变。配置路径参考 https://taotoken.net/doc 密钥在 https://taotoken.net/api-keys 创建。还有一个高频坑把 Android 的file://路径直接传给模型做文件分析结果模型侧读不到。正确做法是先把文件内容读成文本或上传到你的服务端再把内容或可访问地址传给模型。file://是设备本地路径模型服务无法直接访问这不是模型的问题是路径语义的问题。排查顺序建议先确认 Android 侧不再崩cursor 判空生效再确认路径能拿到日志有绝对路径或兜底成功最后确认模型接入正常能收到响应。三步分开验证不要混在一起调。下一节给出接入入口的分流建议按你的使用场景选对应的地址。6. 按场景选接入入口模型对话、Coding Plan 与文档最后说接入入口怎么选。不同场景对应不同地址选对了能省很多事。如果你只是临时验证一个模型能不能用、想快速问一个 API 用法用模型对话页 https://taotoken.net/models 打开就能对话适合排查异常栈、核对DocumentsContract用法这类一次性问题。如果你要长期写 Android 代码、需要模型持续参与编码和重构用 Coding Plan https://taotoken.net/coding-plan 它面向长期编码和 Agent 场景适合把模型接进日常开发流程。如果你需要看接口细节、参数说明、错误码含义查文档 https://taotoken.net/doc 。如果你还没创建密钥去 https://taotoken.net/api-keys 。控制台入口是 https://taotoken.net/console 可以管理密钥和用量。回到本文场景一个实用的组合是用模型对话页快速确认「MIUI 的 ACTION_PICK 返回什么 Uri」用 Coding Plan 生成并迭代UriPathHelper工具类用文档核对DocumentsContract的 API 签名。三者配合比单纯搜索零散博客效率高。再给一个真实经验小米上的选图问题最终稳定的方案不是「找到那个能返回绝对路径的 Action」而是「不依赖绝对路径」。只要你的业务允许优先用openInputStream读流并拷贝到应用私有目录这样无论 Uri 是 content 还是 file、无论 MIUI 怎么变都不会崩。绝对路径只在必须传给第三方 SDK 时才需要而且要做好拿不到时的降级提示。代码层面把本文的safeQuery和UriPathHelper放进你的工具包所有查询媒体库的地方统一走这两个方法禁止裸调query().moveToFirst()。再加一条 lint 规则或代码评审检查项基本就能杜绝这类空指针。日志保留Log.w级别线上出现query returned null时能第一时间发现是哪个 Uri 形态导致的方便后续适配新机型。如果你在配置接入时遇到 401 或 reading choices先回第 5 节对照表逐项检查三件套再确认网络能访问https://taotoken.net/api。配置无误后让模型帮你把本文的工具类按你的包名和日志规范重写一遍直接落到项目里即可。