Android ListView 配 TaoToken：simpleCursorAdapter 数据绑定与 settings.json 骨架

1. Android 老项目里 ListView 绑定 SQLite 游标为什么总是不刷新如果你手上有一个 Android 老项目界面还是 ListView数据来自本地 SQLite那你大概率写过SimpleCursorAdapter。它是什么一句话把Cursor里的列直接映射到 item 布局里的控件省掉手动遍历组装 List 的中间层。适合谁适合维护存量项目、做课程设计、或者接手别人代码时快速看懂数据流的人。但它的坑也很集中数据改了界面不动、Cursor没关导致内存泄漏、_id列名写错直接崩、swapCursor和changeCursor用混。我试过在一个老项目里排查「新增一条记录后列表还是旧的」最后发现是查询返回了新 Cursor但 Adapter 还抱着旧 Cursor 不放而且旧 Cursor 从头到尾没关。这篇就围绕这个场景把 Adapter 构造、Cursor 生命周期、配置骨架讲清楚并给出一份可复制的settings.json片段以及一个「Cursor 关闭验证」动作帮你确认资源到底有没有释放。文中会用到 TaoToken 的模型对话与 Coding Plan 能力来辅助排查和生成骨架地址统一走官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 入口是 https://taotoken.net/api 。2. 前置准备TaoToken 在这类排查里能帮上什么SimpleCursorAdapter的问题往往不是「不会写」而是「看不出哪里错了」。比如 Cursor 的列名、Adapter 的from/to数组长度是否对齐、notifyDataSetChanged为什么无效这些靠肉眼翻代码很慢。TaoToken 提供模型对话和 Coding Plan 两条路径前者适合把报错日志和代码片段贴进去问「这个 Cursor 为什么没刷新」后者适合长期在 Android 老项目里做批量改造、生成 Adapter 骨架和配置片段。你需要先拿到 API Key。进入控制台创建密钥地址是 https://taotoken.net/console 密钥管理页在 https://taotoken.net/api-keys 。拿到之后模型对话入口在 https://taotoken.net/model-chat 接入文档在 https://taotoken.net/doc 。如果你打算长期做编码类任务比如批量重构多个 Activity 里的 Adapter 写法可以看 Coding Plan https://taotoken.net/coding-plan 。注意Key 只放在本地环境变量或项目的local.properties里不要提交到 Git。老项目尤其容易把密钥写进BuildConfig然后一起打包这个习惯要改。3. 可复制配置settings.json 骨架与 Adapter 构造先给一份settings.json骨架用于把 TaoToken 的接入信息集中管理避免散落在代码里。字段含义我在表格里对照说明。{ taotoken: { api_base: https://taotoken.net/api, api_key_env: TAOTOKEN_API_KEY, model: claude-code, timeout_ms: 60000, retry: { max_attempts: 3, backoff_ms: 800 } }, android: { min_sdk: 21, target_sdk: 33, cursor_debug: true } }字段作用建议值api_base接口根地址https://taotoken.net/apiapi_key_env读取密钥的环境变量名TAOTOKEN_API_KEYmodel默认模型标识按控制台可用模型填timeout_ms单次请求超时60000cursor_debug是否打印 Cursor 状态排查期 true配置就绪后回到 Adapter 本身。SimpleCursorAdapter的构造有五个关键参数上下文、item 布局、Cursor、from 列名数组、to 控件 id 数组。最容易错的是from和to必须一一对应且 Cursor 里必须存在_id列否则会抛IllegalArgumentException。public class PersonDao { private final DBHelper helper; public PersonDao(Context context) { this.helper new DBHelper(context); } public Cursor queryAllCursor() { SQLiteDatabase db helper.getReadableDatabase(); // 关键把主键别名成 _idSimpleCursorAdapter 依赖它 return db.query( person, new String[]{id AS _id, name, balance}, null, null, null, null, null); } }SimpleCursorAdapter adapter new SimpleCursorAdapter( this, R.layout.item, cursor, new String[]{_id, name, balance}, new int[]{R.id.idTV, R.id.nameTV, R.id.balanceTV}, 0); personLV.setAdapter(adapter);注意最后一个参数flags传0表示不使用自动重查。老代码里常见SimpleCursorAdapter.FLAG_AUTO_REQUERY这个常量在新版本已废弃会触发主线程查询能不用就不用。4. 验证请求与成功结果Cursor 关闭验证动作写完 Adapter 只是第一步真正决定「数据刷不刷新」的是 Cursor 的替换方式。查询返回新 Cursor 后不要直接changeCursor然后忘了旧的推荐用swapCursor它会把旧 Cursor 返回给你方便显式关闭。Cursor newCursor dao.queryAllCursor(); Cursor oldCursor adapter.swapCursor(newCursor); if (oldCursor ! null !oldCursor.isClosed()) { oldCursor.close(); }验证是否真的关闭可以加一个调试动作在onDestroy或数据刷新后打印 Cursor 状态。Override protected void onDestroy() { super.onDestroy(); Cursor c adapter.getCursor(); if (c ! null !c.isClosed()) { c.close(); } Log.d(CursorCheck, cursor closed (c null || c.isClosed())); }成功的结果是新增一条 person 记录后重新查询得到新 CursorswapCursor替换列表立即显示新数据日志输出cursor closed true。如果列表不动先看swapCursor的返回值是不是 null再看新 Cursor 的getCount()是否大于 0。你也可以把这段日志和代码贴到模型对话里让它帮你判断是 Cursor 问题还是 Adapter 通知问题 https://taotoken.net/model-chat 。如果是长期维护多个老页面用 Coding Plan 批量生成统一的 Cursor 管理模板更省事 https://taotoken.net/coding-plan 。5. 本篇常见错排查数据不刷新与崩溃对照下面这些是我在 Android 老项目里踩过的坑按现象归类。现象一新增数据后列表不变。多数是复用了旧 Cursor或者调用了notifyDataSetChanged但 Cursor 内容没变。SimpleCursorAdapter依赖 Cursor 本身的变化正确做法是重新查询并swapCursor。现象二启动即崩报column _id does not exist。查询语句里主键没别名成_id。SQLite 表主键叫id但 Adapter 只认_id必须id AS _id。现象三from和to长度不一致。列名数组三个控件 id 数组两个直接抛异常。逐个数一遍。现象四Cursor 泄漏页面退出后内存不降。onDestroy里没关 Cursor或者swapCursor返回的旧 Cursor 被丢弃。用第 4 节的验证动作确认。现象五主线程查询卡顿。老代码常在onCreate里直接db.query数据量大时 ANR。可以先用模型对话确认改造方向再决定是否引入异步查询。提示排查时把cursor_debug设为 true配合Log.d输出 Cursor 的getCount()和isClosed()比盲猜快得多。6. 语义一致收尾把配置和验证动作固定下来回到最开始的问题SimpleCursorAdapter本身不复杂复杂的是 Cursor 的生命周期管理和刷新时机。把settings.json骨架固定下来把swapCursor加旧 Cursor 关闭写成模板把onDestroy的关闭验证当成习惯动作数据不刷新的问题基本能定位到具体环节。接入相关的 Key 和文档走这里API Keys 在 https://taotoken.net/api-keys 接入文档在 https://taotoken.net/doc 。需要验证模型输出是否符合预期时用模型对话 https://taotoken.net/model-chat 长期做 Android 老项目改造就用 Coding Plan https://taotoken.net/coding-plan 。官网入口统一是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 根地址是 https://taotoken.net/api 。