企业官网建设流程全解析

1. 从相册选图后路径为 null 的真实场景

Android 获取本地图片路径失败，cursor.getString(column_index)返回 null，这个报错在相册选图、二维码解析、头像上传这类需求里出现频率极高。你大概率写过类似代码：Intent.ACTION_GET_CONTENT拉起相册，onActivityResult里拿到data.getData()，再用MediaStore.Images.Media.DATA去查_data列，结果getString直接给你一个 null，或者更早一步getColumnIndexOrThrow就抛IllegalArgumentException。

这个问题的本质不是代码写错了，而是 Android 4.4（API 19）之后存储访问模型变了。早期相册返回的 Uri 是content://media/external/images/media/164，这种 Uri 背后确实对应 MediaStore 里的一行记录，_data列存着文件绝对路径，所以你能查到。4.4 之后系统相册（尤其是 DocumentsUI）返回的 Uri 变成了content://com.android.providers.media.documents/document/image:3951，这是 DocumentsProvider 的 Uri，它压根不在MediaStore.Images.Media这张表里，你拿MediaStore.Images.Media.DATA去查，列不存在，索引为 -1，getString(-1)自然返回 null。

再往后到 Android 10（API 29）分区存储强制开启，_data列本身都被弱化了，即便你查到了路径，应用也未必有权限直接读那个绝对路径。所以「拿路径」这个思路本身就需要调整：现代 Android 更推荐直接拿InputStream或Uri去用，而不是执着于绝对路径。

这篇内容适合正在做相册选图、图片上传、二维码识别，被getString(column_index)返回 null 卡住的 Android 开发者。我会把可复制的 Cursor 查询骨架、列名映射、日志验证、空值兜底都给你，并且顺带说清楚为什么换ACTION_PICK能缓解一部分问题，以及分区存储下更稳的做法。

2. 接入前的准备：用 TaoToken 统一管理模型调用

排查这类问题时，我经常需要让模型帮我读一段 Cursor 查询日志、比对不同 Android 版本返回的 Uri 结构，或者生成一段兼容多版本的取路径代码。这时候一个稳定的模型调用入口能省不少事。TaoToken 是一个聚合多家大模型能力的 API 平台，你可以把它理解成一个统一的「模型网关」：同一套 API Key，既能调对话模型，也能接 Coding Plan 做长期编码辅助。

对 Android 开发者来说，它的价值在于：排查getString返回 null 这种跨版本兼容问题时，你可以把报错日志、Uri 字符串、Cursor 列名直接丢给模型对话做分析；写兼容代码时，用 Coding Plan 让它持续帮你补全多版本分支。官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api ，注意 API 地址不带 UTM 参数。

你需要先拿到 API Key，再去接入文档看具体调用格式。拿 Key 的入口是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。如果你只是想先验证模型能不能正确分析你的 Cursor 日志，可以直接用模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 试一段。长期做 Android 编码、需要 Agent 持续跟进的，可以看 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。

这里要强调一点：TaoToken 是正常的模型 API 聚合服务，不是任何形式的网络中转工具，我们只把它用在代码分析和模型调用上。下面进入正题，先把 Cursor 查询的骨架搭起来。

3. 可复制的 Cursor 查询与列名映射配置

3.1 先判断 Uri 类型，别急着查 _data

拿到data.getData()之后，第一步不是查库，而是判断这个 Uri 到底属于哪种 Provider。核心判断逻辑是看 authority：

Uri uri = data.getData(); if (uri == null) { // 用户没选图直接返回 return; } String authority = uri.getAuthority(); Log.d("PickImage", "uri=" + uri + ", authority=" + authority);

打印出来你会看到几种典型值：media（MediaStore 自己的）、com.android.providers.media.documents（DocumentsUI）、com.android.externalstorage.documents、com.google.android.apps.photos.content（Google 相册）等。只有 authority 是media的时候，用MediaStore.Images.Media.DATA查_data才可能拿到路径。其他情况查了也是 null。

3.2 兼容多版本的查询骨架

下面这段是可以直接复制进项目的查询骨架，核心思路是：先尝试从 MediaStore 查_data，查不到就退回到用ContentResolver.openInputStream直接读流，不再依赖绝对路径。

public static String getImagePath(Context context, Uri uri) { if (uri == null) return null; String path = null; String authority = uri.getAuthority(); Log.d("PickImage", "authority=" + authority + ", uri=" + uri); // 只有 media 类型的 Uri 才走 MediaStore 查询 if ("media".equals(authority)) { String[] projection = {MediaStore.Images.Media.DATA}; Cursor cursor = null; try { cursor = context.getContentResolver().query(uri, projection, null, null, null); if (cursor != null && cursor.moveToFirst()) { int columnIndex = cursor.getColumnIndex(MediaStore.Images.Media.DATA); Log.d("PickImage", "columnIndex=" + columnIndex); if (columnIndex >= 0) { path = cursor.getString(columnIndex); } } } catch (Exception e) { Log.e("PickImage", "query failed", e); } finally { if (cursor != null) cursor.close(); } } // 查不到路径时，退回到流式读取，保证功能可用 if (TextUtils.isEmpty(path)) { Log.w("PickImage", "path is null, fallback to stream"); path = copyUriToCache(context, uri); } return path; }

关键点在于columnIndex >= 0这个判断。很多人直接用getColumnIndexOrThrow，列不存在时直接抛异常；换成getColumnIndex再判负，至少不会崩，还能走兜底逻辑。

3.3 空值兜底：把 Uri 内容落到应用私有目录

既然绝对路径不可靠，最稳的兜底就是把 Uri 指向的内容复制到应用自己的 cache 目录，拿到一个你完全可控的路径：

private static String copyUriToCache(Context context, Uri uri) { File cacheDir = new File(context.getCacheDir(), "picked_images"); if (!cacheDir.exists()) cacheDir.mkdirs(); File outFile = new File(cacheDir, "img_" + System.currentTimeMillis() + ".jpg"); InputStream in = null; OutputStream out = null; try { in = context.getContentResolver().openInputStream(uri); if (in == null) return null; out = new FileOutputStream(outFile); byte[] buffer = new byte[8192]; int len; while ((len = in.read(buffer)) != -1) { out.write(buffer, 0, len); } out.flush(); return outFile.getAbsolutePath(); } catch (Exception e) { Log.e("PickImage", "copy failed", e); return null; } finally { try { if (in != null) in.close(); } catch (IOException ignored) {} try { if (out != null) out.close(); } catch (IOException ignored) {} } }

这样无论相册返回什么 Uri，你最终都能拿到一个真实存在的文件路径，二维码解析、上传都能继续。

3.4 列名映射对照表

不同 Provider 对应的列名不一样，下面这张表帮你快速对照：

看到没，只有第一行能查_data。你之前getString返回 null，八成是因为 Uri 落在了下面几行，却还在用MediaStore.Images.Media.DATA去查。

4. 验证请求与成功结果

4.1 用日志确认列索引

在查询前后各打一条日志，把columnIndex和cursor.getCount()都打出来：

cursor = context.getContentResolver().query(uri, projection, null, null, null); if (cursor != null) { Log.d("PickImage", "count=" + cursor.getCount() + ", columns=" + Arrays.toString(cursor.getColumnNames())); }

如果columns里根本没有_data，那getColumnIndex一定返回 -1，getString(-1)就是 null。这一步能直接坐实问题根因，比猜快得多。

4.2 成功结果长什么样

修复后，日志应该呈现这样的形态：authority 是media时，columnIndex是 0，path是类似/storage/emulated/0/DCIM/Camera/IMG_20240101_120000.jpg的真实路径；authority 是 documents 时，columnIndex是 -1，日志出现path is null, fallback to stream，随后返回/data/user/0/你的包名/cache/picked_images/img_xxx.jpg。两种结果都算成功，因为最终你都有了一个可读的文件路径。

4.3 用模型辅助分析日志

如果你把上面这段日志贴给模型，让它判断「为什么 columnIndex 是 -1」，用 TaoToken 的模型对话就能快速得到结论。接入方式很简单，在代码里用标准 HTTP 请求调 https://taotoken.net/api 即可，具体请求体格式看接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。对于需要反复调试 Cursor 查询的场景，Coding Plan 能让你在一个会话里持续迭代代码，不用每次重新描述上下文。

5. 本篇常见错误排查

5.1 getColumnIndexOrThrow 直接崩溃

报错IllegalArgumentException: column '_data' does not exist。原因就是 Uri 不是 media 类型，表里没这列。改法：换成getColumnIndex并判负，或者先判断 authority。

5.2 权限声明了还是拿不到

Android 13（API 33）之后读图片要用READ_MEDIA_IMAGES，不再是READ_EXTERNAL_STORAGE。如果你在 AndroidManifest 里只写了旧权限，查询会返回空 Cursor 或直接抛 SecurityException。检查你的 targetSdkVersion 和对应权限：

<!-- API 33+ --> <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /> <!-- API 32 及以下 --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

5.3 分区存储下 _data 失效

Android 10 起即使查到了_data，直接new File(path)去读也可能失败，因为应用没有该路径的读权限。这时候别硬读路径，直接用openInputStream(uri)。这也是为什么第 3 节的骨架把流式读取作为兜底。

5.4 ACTION_GET_CONTENT 换成 ACTION_PICK 的边界

把Intent.ACTION_GET_CONTENT换成Intent.ACTION_PICK确实能让部分机型返回 media 类型的 Uri，从而查到_data。但这不是万能药：Google 相册、部分厂商文件管理器返回的仍是 documents 类型 Uri。所以换 Intent 只能算缓解，不能替代兜底逻辑。我试过在几台机器上对比，换ACTION_PICK后 media 类型占比确实上升，但仍有相当比例走 documents，所以第 3 节的流式兜底必须保留。

5.5 Cursor 忘记关闭导致泄漏

查询完一定要在 finally 里cursor.close()。多次选图不关 Cursor，轻则内存上涨，重则CursorWindowAllocationException。上面骨架里已经用 try-finally 包住了。

6. 继续把兼容逻辑做扎实

排查到这一步，你应该已经清楚cursor.getString(column_index)返回 null 的根因不在 getString 本身，而在 Uri 类型和列名不匹配。把第 3 节的查询骨架 + 流式兜底接进项目，基本能覆盖从 Android 4.4 到 14 的相册选图场景。

后续如果你想让模型帮你把这段逻辑重构成 Kotlin 协程版本，或者生成一套单元测试覆盖不同 authority 分支，可以走 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 做长期编码辅助；只是临时验证某段 Cursor 日志，用模型对话 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 就够。API Key 在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 拿，接入细节看文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。控制台在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，Claude Code 相关接入看 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claudecode_anthropic&utm_campaign=rewrite 。

最后留一个我踩过的坑：别在onActivityResult里做耗时查询，尤其是大图复制到 cache 的操作，放到子线程或协程里，否则主线程卡顿甚至 ANR。把查询和复制都挪到 IO 线程，UI 只负责拿最终路径，这样体验会稳很多。