1. 为什么 Android 本地存储绕不开 SQLite做 Android 应用只要涉及「数据要留下来」——比如记账 App 的账单、读书 App 的书签、待办清单的条目——你迟早会碰到 SQLite。它是 Android 系统内置的轻量级关系型数据库不需要额外装服务一个.db文件就能把结构化数据管得明明白白。适合谁适合所有需要本地持久化、又不想引入 Room 这类额外框架或者想先搞懂底层原理的开发者。但真正上手时痛点往往不在「会不会写 SQL」而在两件事一是建表语句、增删改查的样板代码又长又容易写错字段类型、占位符、whereArgs顺序稍不留神就翻车二是运行时报错信息很含糊比如no such table、no such column、UNIQUE constraint failed光看 Logcat 一时半会儿定位不到根因。我的做法是把 SQLite 的骨架代码自己写扎实同时用一个统一的 AI 通道来辅助生成建表 SQL、解释报错、补全查询逻辑。这篇就围绕SQLiteOpenHelper骨架、settings.json配置片段、adb验证命令三块交付并说明怎么通过 TaoToken 统一 Key 把 AI 工具接进来让「生成 SQL」和「排查错误」这两步不再来回切窗口。2. 前置准备TaoToken 统一 Key 与工具接入TaoToken 在这里扮演的角色是「一个 Key 打通多个 AI 工具」的 API 通道。你不需要为每个编辑器、每个 CLI 工具单独配一套密钥只要把请求指向同一个地址、带上同一个 Key模型对话、代码补全、Agent 编码都能复用。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。接入前先拿到凭证进控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。Key 建议只存在本地环境变量或工具的配置文件里别硬编码进build.gradle或提交到 Git。如果你用的是支持 OpenAI 兼容协议的工具很多 AI 编程插件、CLI 都支持配置通常长这样把base_url指向 TaoToken 的 API 地址即可{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-5 }想先验证 Key 是否可用、模型是否通最直接的方式是打开模型对话页面发一条测试消息 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果对话能正常返回说明 Key 和通道都没问题再往编辑器里配。对于长期做 Android 编码、想让 AI 持续参与建表和调试的可以考虑 Coding Plan它更适合高频、长会话的编码场景 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到协议细节可以对照查。注意Key 属于敏感凭证配置时优先用环境变量注入例如在 shell 里export TAOTOKEN_API_KEYsk-xxx工具配置里引用变量名而不是明文。3. 可复制配置SQLiteOpenHelper 骨架与建表先写数据库管理器。继承SQLiteOpenHelper重写onCreate和onUpgrade构造方法接收 context、库名、CursorFactory一般传 null、版本号四个参数。getReadableDatabase()和getWritableDatabase()都会在库不存在时创建、存在时打开区别在于磁盘满等不可写场景下前者以只读打开、后者直接抛异常。public class MyDatabaseHelper extends SQLiteOpenHelper { public static final String CREATE_BOOK create table Book( id integer primary key autoincrement, author text, price real, pages integer, name text); private Context mContext; public MyDatabaseHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) { super(context, name, factory, version); mContext context; } Override public void onCreate(SQLiteDatabase db) { db.execSQL(CREATE_BOOK); Toast.makeText(mContext, Create succeeded, Toast.LENGTH_LONG).show(); } Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // 版本升级时按需迁移例如 db.execSQL(drop table if exists Book); } }在 Activity 里实例化并触发建库dbHelper new MyDatabaseHelper(this, BookStore.db, null, 1); Button createDatabase findViewById(R.id.create_database); createDatabase.setOnClickListener(v - dbHelper.getWritableDatabase());增删改查四件套核心是ContentValues组装数据、whereArgs传占位符参数// 插入 SQLiteDatabase db dbHelper.getWritableDatabase(); ContentValues values new ContentValues(); values.put(name, The da vi code); values.put(author, Dan); values.put(pages, 434); values.put(price, 13.33); db.insert(Book, null, values); values.clear(); // 更新 values.put(price, 1.2); db.update(Book, values, name?, new String[]{The da vi code}); // 删除 db.delete(Book, pages?, new String[]{20}); // 查询 Cursor cursor db.query(Book, null, null, null, null, null, null); if (cursor.moveToFirst()) { do { String name cursor.getString(cursor.getColumnIndex(name)); int pages cursor.getInt(cursor.getColumnIndex(pages)); Log.d(MainActivity, name name , pages pages); } while (cursor.moveToNext()); } cursor.close();这里最容易出错的点whereArgs的顺序必须和where里?的出现顺序严格对应getColumnIndex返回 -1 时取值会抛异常字段名拼错就会踩到。这类问题丢给 AI 通道让它逐行核对比人眼扫快得多。4. 验证请求adb 命令与成功结果代码跑起来只是第一步真正确认数据落库用adb直接看文件最靠谱。先确认设备连接adb devices进入应用私有目录需要 debug 包或 root普通 release 包访问不到/data/dataadb shell run-as com.example.myapp cd databases ls正常会看到BookStore.db以及BookStore.db-journal或-wal。用系统自带的sqlite3验证表结构和数据sqlite3 BookStore.db .tables .schema Book select * from Book;成功结果应该类似Book CREATE TABLE Book(id integer primary key autoincrement,author text,price real,pages integer,name text); 1|The da vi code|1.2|434如果.tables是空的说明onCreate没被触发或建表语句执行失败如果select报no such column就是字段名和代码里getColumnIndex用的字符串对不上。把这段报错原文贴给 AI 通道让它结合你的建表语句一起分析通常几秒就能给出定位方向。5. 本篇常见错排查no such table: Book最常见。要么onCreate没执行库已存在但表没建改版本号触发onUpgrade或卸载重装要么建表语句里表名大小写和查询时不一致。SQLite 表名默认大小写不敏感但字段名敏感别混。UNIQUE constraint failed主键或唯一索引冲突。id是autoincrement一般不会多半是你自己加了唯一约束又插了重复值。检查ContentValues里是否漏了必填字段。CursorIndexOutOfBoundsExceptiongetColumnIndex返回 -1 后直接取值。养成先判断索引再取值的习惯或者用getColumnIndexOrThrow让错误更早暴露。Cannot open database/ 只读getWritableDatabase在存储不可写时抛异常。确认设备存储空间、应用是否有写权限别在onCreate里做耗时操作。升级后数据丢失onUpgrade里直接drop table会清空数据。正确做法是按oldVersion到newVersion逐版本迁移比如加字段用alter table Book add column xxx text。排查时把 Logcat 的完整堆栈、你的建表语句、触发操作三样一起给 AI比只贴一行报错有效得多。接入文档里对请求格式有说明配置报错可以先对照 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。6. 把 AI 通道固定进你的 Android 工作流SQLite 这套东西本身不复杂难的是「写对」和「改快」。我的建议是把 TaoToken 的 Key 配到日常用的编辑器或 CLI 里建表时让 AI 根据字段需求生成create table报错时让它读堆栈定位改查询时让它补whereArgs。凭证在 API Keys 页面管理 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 需要长期编码陪伴就上 Coding Plan。这样一套 Key 走到底建表和调试这两件最耗神的事能省下不少来回切工具的时间。 Android SQLite 数据库存储实战：用 TaoToken 统一 Key 打通 AI 辅助建表与调试
1. 为什么 Android 本地存储绕不开 SQLite做 Android 应用只要涉及「数据要留下来」——比如记账 App 的账单、读书 App 的书签、待办清单的条目——你迟早会碰到 SQLite。它是 Android 系统内置的轻量级关系型数据库不需要额外装服务一个.db文件就能把结构化数据管得明明白白。适合谁适合所有需要本地持久化、又不想引入 Room 这类额外框架或者想先搞懂底层原理的开发者。但真正上手时痛点往往不在「会不会写 SQL」而在两件事一是建表语句、增删改查的样板代码又长又容易写错字段类型、占位符、whereArgs顺序稍不留神就翻车二是运行时报错信息很含糊比如no such table、no such column、UNIQUE constraint failed光看 Logcat 一时半会儿定位不到根因。我的做法是把 SQLite 的骨架代码自己写扎实同时用一个统一的 AI 通道来辅助生成建表 SQL、解释报错、补全查询逻辑。这篇就围绕SQLiteOpenHelper骨架、settings.json配置片段、adb验证命令三块交付并说明怎么通过 TaoToken 统一 Key 把 AI 工具接进来让「生成 SQL」和「排查错误」这两步不再来回切窗口。2. 前置准备TaoToken 统一 Key 与工具接入TaoToken 在这里扮演的角色是「一个 Key 打通多个 AI 工具」的 API 通道。你不需要为每个编辑器、每个 CLI 工具单独配一套密钥只要把请求指向同一个地址、带上同一个 Key模型对话、代码补全、Agent 编码都能复用。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。接入前先拿到凭证进控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。Key 建议只存在本地环境变量或工具的配置文件里别硬编码进build.gradle或提交到 Git。如果你用的是支持 OpenAI 兼容协议的工具很多 AI 编程插件、CLI 都支持配置通常长这样把base_url指向 TaoToken 的 API 地址即可{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-5 }想先验证 Key 是否可用、模型是否通最直接的方式是打开模型对话页面发一条测试消息 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果对话能正常返回说明 Key 和通道都没问题再往编辑器里配。对于长期做 Android 编码、想让 AI 持续参与建表和调试的可以考虑 Coding Plan它更适合高频、长会话的编码场景 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到协议细节可以对照查。注意Key 属于敏感凭证配置时优先用环境变量注入例如在 shell 里export TAOTOKEN_API_KEYsk-xxx工具配置里引用变量名而不是明文。3. 可复制配置SQLiteOpenHelper 骨架与建表先写数据库管理器。继承SQLiteOpenHelper重写onCreate和onUpgrade构造方法接收 context、库名、CursorFactory一般传 null、版本号四个参数。getReadableDatabase()和getWritableDatabase()都会在库不存在时创建、存在时打开区别在于磁盘满等不可写场景下前者以只读打开、后者直接抛异常。public class MyDatabaseHelper extends SQLiteOpenHelper { public static final String CREATE_BOOK create table Book( id integer primary key autoincrement, author text, price real, pages integer, name text); private Context mContext; public MyDatabaseHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) { super(context, name, factory, version); mContext context; } Override public void onCreate(SQLiteDatabase db) { db.execSQL(CREATE_BOOK); Toast.makeText(mContext, Create succeeded, Toast.LENGTH_LONG).show(); } Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // 版本升级时按需迁移例如 db.execSQL(drop table if exists Book); } }在 Activity 里实例化并触发建库dbHelper new MyDatabaseHelper(this, BookStore.db, null, 1); Button createDatabase findViewById(R.id.create_database); createDatabase.setOnClickListener(v - dbHelper.getWritableDatabase());增删改查四件套核心是ContentValues组装数据、whereArgs传占位符参数// 插入 SQLiteDatabase db dbHelper.getWritableDatabase(); ContentValues values new ContentValues(); values.put(name, The da vi code); values.put(author, Dan); values.put(pages, 434); values.put(price, 13.33); db.insert(Book, null, values); values.clear(); // 更新 values.put(price, 1.2); db.update(Book, values, name?, new String[]{The da vi code}); // 删除 db.delete(Book, pages?, new String[]{20}); // 查询 Cursor cursor db.query(Book, null, null, null, null, null, null); if (cursor.moveToFirst()) { do { String name cursor.getString(cursor.getColumnIndex(name)); int pages cursor.getInt(cursor.getColumnIndex(pages)); Log.d(MainActivity, name name , pages pages); } while (cursor.moveToNext()); } cursor.close();这里最容易出错的点whereArgs的顺序必须和where里?的出现顺序严格对应getColumnIndex返回 -1 时取值会抛异常字段名拼错就会踩到。这类问题丢给 AI 通道让它逐行核对比人眼扫快得多。4. 验证请求adb 命令与成功结果代码跑起来只是第一步真正确认数据落库用adb直接看文件最靠谱。先确认设备连接adb devices进入应用私有目录需要 debug 包或 root普通 release 包访问不到/data/dataadb shell run-as com.example.myapp cd databases ls正常会看到BookStore.db以及BookStore.db-journal或-wal。用系统自带的sqlite3验证表结构和数据sqlite3 BookStore.db .tables .schema Book select * from Book;成功结果应该类似Book CREATE TABLE Book(id integer primary key autoincrement,author text,price real,pages integer,name text); 1|The da vi code|1.2|434如果.tables是空的说明onCreate没被触发或建表语句执行失败如果select报no such column就是字段名和代码里getColumnIndex用的字符串对不上。把这段报错原文贴给 AI 通道让它结合你的建表语句一起分析通常几秒就能给出定位方向。5. 本篇常见错排查no such table: Book最常见。要么onCreate没执行库已存在但表没建改版本号触发onUpgrade或卸载重装要么建表语句里表名大小写和查询时不一致。SQLite 表名默认大小写不敏感但字段名敏感别混。UNIQUE constraint failed主键或唯一索引冲突。id是autoincrement一般不会多半是你自己加了唯一约束又插了重复值。检查ContentValues里是否漏了必填字段。CursorIndexOutOfBoundsExceptiongetColumnIndex返回 -1 后直接取值。养成先判断索引再取值的习惯或者用getColumnIndexOrThrow让错误更早暴露。Cannot open database/ 只读getWritableDatabase在存储不可写时抛异常。确认设备存储空间、应用是否有写权限别在onCreate里做耗时操作。升级后数据丢失onUpgrade里直接drop table会清空数据。正确做法是按oldVersion到newVersion逐版本迁移比如加字段用alter table Book add column xxx text。排查时把 Logcat 的完整堆栈、你的建表语句、触发操作三样一起给 AI比只贴一行报错有效得多。接入文档里对请求格式有说明配置报错可以先对照 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。6. 把 AI 通道固定进你的 Android 工作流SQLite 这套东西本身不复杂难的是「写对」和「改快」。我的建议是把 TaoToken 的 Key 配到日常用的编辑器或 CLI 里建表时让 AI 根据字段需求生成create table报错时让它读堆栈定位改查询时让它补whereArgs。凭证在 API Keys 页面管理 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 需要长期编码陪伴就上 Coding Plan。这样一套 Key 走到底建表和调试这两件最耗神的事能省下不少来回切工具的时间。