1. Android 里 Cursor 到底是什么为什么你总在它身上踩坑如果你写过 Android 本地数据存储大概率绕不开 SQLite而只要碰 SQLite 查询就一定会遇到android.database.Cursor。简单说Cursor 就是查询结果集的游标它指向结果表中的某一行你可以把它理解成一个「带指针的行集合」。SQLiteDatabase.query()、rawQuery()返回的都是 Cursor它本身不存全部数据而是按需从底层读取所以它既高效又容易用错。它适合谁适合所有需要频繁读取 SQLite 查询结果的移动端开发者尤其是做通讯录、聊天记录、离线缓存、本地日志这类场景的同学。Cursor 能做什么遍历结果、按列名或下标取值、判断是否为空、统计行数、定位任意行。听起来简单但空指针、下标越界、忘记 close 导致内存泄漏几乎每个新手都栽过。这篇我会从概念讲到实战先给一份可直接复制的遍历与资源释放骨架再列一份常见报错排查清单最后演示怎么用 TaoToken 统一 Key 通道把 AI 编程工具接进来让它在写 Cursor 相关代码时帮你补全、查错、解释报错。全程可跟做代码能直接跑。2. 前置准备用 TaoToken 统一 Key 打通 AI 辅助开发链路在动手写 Cursor 代码之前先把「AI 辅助」这条链路搭好。我习惯用 TaoToken 作为统一入口它把模型调用收敛成一个 Key省得每个工具单独配一遍。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你需要做的只有三步注册账号、在控制台创建一个 API Key、把 Key 填进你常用的 AI 编程工具。控制台地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建 Key 的页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你用的是 Claude Code 这类命令行编码工具接入说明在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 专门的 ClaudeCodeAnthropic 配置页在 https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentClaudeCodeAnthropicutm_campaignrewrite 。注意Key 只创建一次就够后续所有工具复用同一个别到处复制粘贴导致泄露。填进工具后先别急着写业务下一步我们会用一次真实请求验证链路是否生效。3. 可复制配置Cursor 遍历与资源释放代码骨架先看最核心的查询与遍历。假设有一张people表字段是name、number。下面这段是标准写法注意try/finally保证 Cursor 一定被关闭。public ListPerson queryAllPeople(SQLiteDatabase db) { ListPerson result new ArrayList(); Cursor cursor null; try { cursor db.query(people, null, null, null, null, null, null); if (cursor null) { return result; } int nameIndex cursor.getColumnIndex(name); int numberIndex cursor.getColumnIndex(number); // 列不存在时 getColumnIndex 返回 -1必须判断 if (nameIndex -1 || numberIndex -1) { return result; } while (cursor.moveToNext()) { String name cursor.getString(nameIndex); String number cursor.getString(numberIndex); result.add(new Person(name, number)); } } finally { if (cursor ! null) { cursor.close(); } } return result; }几个关键点moveToNext()从「第一行之前」开始第一次调用就定位到第一行所以while循环天然覆盖全部数据不需要先moveToFirst()。列下标一定要在循环外取一次循环内反复getColumnIndex是性能浪费。如果你更喜欢for循环可以这样写for (cursor.moveToFirst(); !cursor.isAfterLast(); cursor.moveToNext()) { String name cursor.getString(nameIndex); String number cursor.getString(numberIndex); result.add(new Person(name, number)); }isAfterLast()判断是否已越过最后一行配合moveToFirst()使用。两种写法等价选你顺手的。关于startManagingCursor()这是老 API 的做法把 Cursor 生命周期交给 Activity 托管配合stopManagingCursor()使用。但在现代 Android 开发里它已经废弃推荐用try/finally或try-with-resourcesCursor 实现了Closeable手动管理。下面是对应的 Kotlin 写法fun queryAllPeople(db: SQLiteDatabase): ListPerson { val result mutableListOfPerson() db.query(people, null, null, null, null, null, null)?.use { cursor - val nameIndex cursor.getColumnIndex(name) val numberIndex cursor.getColumnIndex(number) if (nameIndex -1 || numberIndex -1) returnuse while (cursor.moveToNext()) { result.add( Person( cursor.getString(nameIndex), cursor.getString(numberIndex) ) ) } } return result }use会自动关闭 Cursor等价于 Java 的try-with-resources这是目前最省心的写法。4. 验证请求确认 AI 调用链路真的生效配置完 Key 之后别直接开写业务先做一次最小验证。打开你接入的模型对话入口 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发一句请用一句话解释 Android Cursor 的 moveToNext() 和 moveToFirst() 的区别。如果几秒内返回了合理回答说明 Key 和链路都通了。这一步很关键因为很多「AI 不生效」的问题其实是 Key 没填对或额度没到账先排除掉再写代码。验证通过后回到你的 IDE让 AI 帮你补全上面那段 Cursor 遍历代码。你可以直接问帮我写一个 Android SQLite 查询方法用 Cursor 遍历结果要求 try/finally 关闭游标并判断列下标是否为 -1。对比它生成的代码和你手写的骨架重点看它有没有漏掉close()、有没有在循环内取列下标。这一步既是验证链路也是让 AI 熟悉你项目风格的过程。如果你长期做 Android 编码、想让 AI 持续参与补全和重构可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 适合把 AI 当成日常结对伙伴的场景。5. 本篇常见错排查空指针与越界报错清单写 Cursor 代码时报错基本集中在下面几类我按出现频率排了序。第一类NullPointerExceptiononcursor.getString()。原因通常是query()返回了 null或者你忘了判空。query()在表不存在等异常情况下可能返回 null所以拿到 Cursor 第一件事就是判空。另外getString()对 NULL 列返回 null如果你直接拿去做字符串拼接也会 NPE取值后加一层判空更稳。第二类IllegalArgumentException: column xxx does not exist。这是getColumnIndexOrThrow()抛的说明你写的列名和表结构对不上。用getColumnIndex()则返回 -1不抛异常但后续getString(-1)会抛CursorIndexOutOfBoundsException。所以取完下标一定要判断! -1。第三类CursorIndexOutOfBoundsException: Index -1 requested。就是上面说的列下标为 -1 还去取值。排查方法打印cursor.getColumnNames()确认实际列名注意大小写和拼写。第四类StaleDataException: Attempted to access a cursor after it has been closed。你在 Cursor 关闭后还去读它。常见于把 Cursor 存成成员变量、在异步回调里继续用。解决办法是数据取出后立刻转成 List 或对象别把 Cursor 往外传。第五类内存泄漏。忘记close()Cursor 持有的资源不释放长时间运行会 OOM。用try/finally或 Kotlin 的use就能根治。提示排查时先看异常类型NullPointerException查判空IllegalArgumentException查列名CursorIndexOutOfBoundsException查下标StaleDataException查生命周期。四类覆盖九成问题。6. 把 Cursor 用对再把 AI 用顺Cursor 本身不复杂难的是细节判空、列下标、关闭时机这三件事做对基本不会出问题。我试过在几十张表的项目里统一用use包裹查询之后再没出现过泄漏和越界。AI 辅助这条线也一样Key 配好、链路验证过剩下的就是让它帮你查报错、补骨架。遇到CursorIndexOutOfBoundsException这类报错直接把异常栈贴给模型对话入口 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 让它结合你的表结构分析比翻文档快得多。需要新建 Key 或查看额度去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。把这两条链路都跑通Android 本地数据这块基本就稳了。
1. Android 里 Cursor 到底是什么为什么你总在它身上踩坑如果你写过 Android 本地数据存储大概率绕不开 SQLite而只要碰 SQLite 查询就一定会遇到android.database.Cursor。简单说Cursor 就是查询结果集的游标它指向结果表中的某一行你可以把它理解成一个「带指针的行集合」。SQLiteDatabase.query()、rawQuery()返回的都是 Cursor它本身不存全部数据而是按需从底层读取所以它既高效又容易用错。它适合谁适合所有需要频繁读取 SQLite 查询结果的移动端开发者尤其是做通讯录、聊天记录、离线缓存、本地日志这类场景的同学。Cursor 能做什么遍历结果、按列名或下标取值、判断是否为空、统计行数、定位任意行。听起来简单但空指针、下标越界、忘记 close 导致内存泄漏几乎每个新手都栽过。这篇我会从概念讲到实战先给一份可直接复制的遍历与资源释放骨架再列一份常见报错排查清单最后演示怎么用 TaoToken 统一 Key 通道把 AI 编程工具接进来让它在写 Cursor 相关代码时帮你补全、查错、解释报错。全程可跟做代码能直接跑。2. 前置准备用 TaoToken 统一 Key 打通 AI 辅助开发链路在动手写 Cursor 代码之前先把「AI 辅助」这条链路搭好。我习惯用 TaoToken 作为统一入口它把模型调用收敛成一个 Key省得每个工具单独配一遍。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你需要做的只有三步注册账号、在控制台创建一个 API Key、把 Key 填进你常用的 AI 编程工具。控制台地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建 Key 的页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你用的是 Claude Code 这类命令行编码工具接入说明在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 专门的 ClaudeCodeAnthropic 配置页在 https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentClaudeCodeAnthropicutm_campaignrewrite 。注意Key 只创建一次就够后续所有工具复用同一个别到处复制粘贴导致泄露。填进工具后先别急着写业务下一步我们会用一次真实请求验证链路是否生效。3. 可复制配置Cursor 遍历与资源释放代码骨架先看最核心的查询与遍历。假设有一张people表字段是name、number。下面这段是标准写法注意try/finally保证 Cursor 一定被关闭。public ListPerson queryAllPeople(SQLiteDatabase db) { ListPerson result new ArrayList(); Cursor cursor null; try { cursor db.query(people, null, null, null, null, null, null); if (cursor null) { return result; } int nameIndex cursor.getColumnIndex(name); int numberIndex cursor.getColumnIndex(number); // 列不存在时 getColumnIndex 返回 -1必须判断 if (nameIndex -1 || numberIndex -1) { return result; } while (cursor.moveToNext()) { String name cursor.getString(nameIndex); String number cursor.getString(numberIndex); result.add(new Person(name, number)); } } finally { if (cursor ! null) { cursor.close(); } } return result; }几个关键点moveToNext()从「第一行之前」开始第一次调用就定位到第一行所以while循环天然覆盖全部数据不需要先moveToFirst()。列下标一定要在循环外取一次循环内反复getColumnIndex是性能浪费。如果你更喜欢for循环可以这样写for (cursor.moveToFirst(); !cursor.isAfterLast(); cursor.moveToNext()) { String name cursor.getString(nameIndex); String number cursor.getString(numberIndex); result.add(new Person(name, number)); }isAfterLast()判断是否已越过最后一行配合moveToFirst()使用。两种写法等价选你顺手的。关于startManagingCursor()这是老 API 的做法把 Cursor 生命周期交给 Activity 托管配合stopManagingCursor()使用。但在现代 Android 开发里它已经废弃推荐用try/finally或try-with-resourcesCursor 实现了Closeable手动管理。下面是对应的 Kotlin 写法fun queryAllPeople(db: SQLiteDatabase): ListPerson { val result mutableListOfPerson() db.query(people, null, null, null, null, null, null)?.use { cursor - val nameIndex cursor.getColumnIndex(name) val numberIndex cursor.getColumnIndex(number) if (nameIndex -1 || numberIndex -1) returnuse while (cursor.moveToNext()) { result.add( Person( cursor.getString(nameIndex), cursor.getString(numberIndex) ) ) } } return result }use会自动关闭 Cursor等价于 Java 的try-with-resources这是目前最省心的写法。4. 验证请求确认 AI 调用链路真的生效配置完 Key 之后别直接开写业务先做一次最小验证。打开你接入的模型对话入口 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发一句请用一句话解释 Android Cursor 的 moveToNext() 和 moveToFirst() 的区别。如果几秒内返回了合理回答说明 Key 和链路都通了。这一步很关键因为很多「AI 不生效」的问题其实是 Key 没填对或额度没到账先排除掉再写代码。验证通过后回到你的 IDE让 AI 帮你补全上面那段 Cursor 遍历代码。你可以直接问帮我写一个 Android SQLite 查询方法用 Cursor 遍历结果要求 try/finally 关闭游标并判断列下标是否为 -1。对比它生成的代码和你手写的骨架重点看它有没有漏掉close()、有没有在循环内取列下标。这一步既是验证链路也是让 AI 熟悉你项目风格的过程。如果你长期做 Android 编码、想让 AI 持续参与补全和重构可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 适合把 AI 当成日常结对伙伴的场景。5. 本篇常见错排查空指针与越界报错清单写 Cursor 代码时报错基本集中在下面几类我按出现频率排了序。第一类NullPointerExceptiononcursor.getString()。原因通常是query()返回了 null或者你忘了判空。query()在表不存在等异常情况下可能返回 null所以拿到 Cursor 第一件事就是判空。另外getString()对 NULL 列返回 null如果你直接拿去做字符串拼接也会 NPE取值后加一层判空更稳。第二类IllegalArgumentException: column xxx does not exist。这是getColumnIndexOrThrow()抛的说明你写的列名和表结构对不上。用getColumnIndex()则返回 -1不抛异常但后续getString(-1)会抛CursorIndexOutOfBoundsException。所以取完下标一定要判断! -1。第三类CursorIndexOutOfBoundsException: Index -1 requested。就是上面说的列下标为 -1 还去取值。排查方法打印cursor.getColumnNames()确认实际列名注意大小写和拼写。第四类StaleDataException: Attempted to access a cursor after it has been closed。你在 Cursor 关闭后还去读它。常见于把 Cursor 存成成员变量、在异步回调里继续用。解决办法是数据取出后立刻转成 List 或对象别把 Cursor 往外传。第五类内存泄漏。忘记close()Cursor 持有的资源不释放长时间运行会 OOM。用try/finally或 Kotlin 的use就能根治。提示排查时先看异常类型NullPointerException查判空IllegalArgumentException查列名CursorIndexOutOfBoundsException查下标StaleDataException查生命周期。四类覆盖九成问题。6. 把 Cursor 用对再把 AI 用顺Cursor 本身不复杂难的是细节判空、列下标、关闭时机这三件事做对基本不会出问题。我试过在几十张表的项目里统一用use包裹查询之后再没出现过泄漏和越界。AI 辅助这条线也一样Key 配好、链路验证过剩下的就是让它帮你查报错、补骨架。遇到CursorIndexOutOfBoundsException这类报错直接把异常栈贴给模型对话入口 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 让它结合你的表结构分析比翻文档快得多。需要新建 Key 或查看额度去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。把这两条链路都跑通Android 本地数据这块基本就稳了。
