如何在 Android Studio 中配置 TaoToken 并调试 SQLite 数据库（上）

1. 为什么要在 Android Studio 里同时搞定 SQLite 和 AI 工具链如果你正在用 Android Studio 写本地数据存储大概率会经历这么一段SQLiteOpenHelper继承好了onCreate()里表也建了getWritableDatabase()也拿到了但一跑起来就报no such table或者插入数据后查出来是空的。与此同时你可能还在用 AI 辅助写代码一会儿要配一个 Key一会儿要换一个模型几个工具各管各的配置改一次环境就要翻半天文档。这篇就聚焦一件事在 Android Studio 这个开发场景里把 SQLite 数据库调试跑通同时用 TaoToken 把 AI 辅助能力的 Key 和 API 通道统一管理起来。所谓统一管理就是你不用在多个插件、多个配置文件里各填一套凭证而是让 Android Studio 侧的 AI 工具链都指向同一个入口改一处就全局生效。适合谁看刚接触 Android 本地存储、对SQLiteOpenHelper/SQLiteDatabase/Cursor三个类还不太熟的开发者以及已经在用 AI 辅助编码、但配置散落各处、想收拢成一套的开发者。上篇先把环境配置和建库建表验证讲透Cursor 查询和更细的调试留到下篇。核心检索词先摆出来Android Studio 配置、SQLite 数据库调试、TaoToken 统一 Key、settings.json、config.toml。下面按可跟做的顺序来。2. TaoToken 前置准备拿到统一 Key 和 API 通道在动 Android Studio 之前先把 TaoToken 这一侧的凭证准备好。它的作用是给你一个统一的 API 通道Android Studio 里的 AI 辅助工具、命令行工具都走这个通道Key 也只维护一份。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进入控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。第二步在控制台里创建 API Key。入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。点新建复制出来的 Key 形如sk-xxxxxxxx只显示一次先存到安全的地方。第三步记住 API 基础地址https://taotoken.net/api 。注意这个地址后面不加任何查询参数配置里填的就是它。如果你用的是兼容 Anthropic 协议的工具走的是 https://taotoken.net/api 下的对应路径具体以接入文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。注意Key 不要硬编码进build.gradle或提交到 Git。Android 项目里建议放在本地local.properties或环境变量再通过BuildConfig注入。下面配置骨架里我会用占位符表示。到这里你手里应该有三样东西一个 Key、一个 API 基础地址、一个控制台入口。接下来把它们落到 Android Studio 的配置文件里。3. 可复制配置settings.json 与 config.toml 骨架Android Studio 本身不直接读这两个文件但它的 AI 辅助插件、以及你在项目里调用的命令行工具会读。所以这一节给的是「项目级」的配置骨架放在项目根目录或用户目录下按你实际用的工具选择。先看settings.json适合走 JSON 配置的工具{ ai.provider: taotoken, ai.baseUrl: https://taotoken.net/api, ai.apiKey: ${TAOTOKEN_API_KEY}, ai.model: claude-sonnet-4-20250514, ai.timeoutMs: 60000, ai.maxRetries: 2 }这里apiKey用${TAOTOKEN_API_KEY}引用环境变量避免明文。baseUrl就是上一步的 API 地址。model按你实际要用的填验证阶段先用一个稳定的模型即可。再看config.toml适合 TOML 风格的工具[provider] name taotoken base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY timeout_ms 60000 [model] default claude-sonnet-4-20250514 max_tokens 4096 [retry] max_attempts 2 backoff_ms 500两个文件的共同点Key 都从环境变量TAOTOKEN_API_KEY读地址都指向https://taotoken.net/api。这样你在 Android Studio 的 Terminal 里设置一次环境变量所有读这两个配置的工具都能用。设置环境变量的方式macOS/Linux 在~/.zshrc或~/.bashrc里加一行export TAOTOKEN_API_KEYsk-你的KeyWindows 在系统环境变量里新建TAOTOKEN_API_KEY或者在 PowerShell 里临时设置$env:TAOTOKEN_API_KEYsk-你的Key设完重启 Android Studio 的 Terminal让环境变量生效。这一步不做后面请求会报 401。4. SQLite 建库建表与验证请求配置就绪后回到 SQLite 这条主线。先明确三个类各自干什么SQLiteOpenHelper管数据库的创建和版本升级SQLiteDatabase执行 SQLCursor装查询结果。上篇重点在前两个。新建一个DBHelper继承SQLiteOpenHelperpublic class DBHelper extends SQLiteOpenHelper { private static final String DB_NAME demo.db; private static final int DB_VERSION 1; public DBHelper(Context context) { super(context, DB_NAME, null, DB_VERSION); } Override public void onCreate(SQLiteDatabase db) { db.execSQL(CREATE TABLE IF NOT EXISTS user ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, age INTEGER)); } Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { db.execSQL(DROP TABLE IF EXISTS user); onCreate(db); } }注意super(context, DB_NAME, null, DB_VERSION)里第三个参数传null表示用默认游标工厂第四个是版本号。onCreate只在数据库第一次创建时调用所以建表语句写这里。在 Activity 里拿到可写数据库并插入一条数据DBHelper helper new DBHelper(this); SQLiteDatabase db helper.getWritableDatabase(); db.execSQL(INSERT INTO user (name, age) VALUES (?, ?), new Object[]{Tom, 20});getWritableDatabase()会触发数据库创建如果demo.db不存在就新建然后回调onCreate。插入用execSQL带占位符避免拼接字符串。验证是否成功用 Android Studio 自带的 Database Inspector菜单 View → Tool Windows → App Inspection → Database Inspector。运行 App 后在 Inspector 里展开demo.db→user表应该能看到刚插入的 Tom 这条记录。如果表是空的先确认插入代码真的执行了再看下面排障部分。如果你还想顺手验证 AI 通道是否通可以在 Terminal 里发一个请求curl https://taotoken.net/api/v1/messages \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:64,messages:[{role:user,content:ping}]}返回里有正常内容说明 Key 和通道没问题。想直接在网页里对话验证用模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。5. 本篇常见错排查报错一no such table: user。最常见的原因是数据库已经存在但表没建。onCreate只在数据库文件第一次创建时调用如果你之前跑过一次、demo.db已存在改完建表语句再跑不会重新执行onCreate。解决办法卸载 App 或清除应用数据让数据库重建或者把DB_VERSION加 1在onUpgrade里处理。报错二attempt to write a readonly database。检查你用的是getWritableDatabase()还是getReadableDatabase()。写操作必须用前者。另外确认设备存储没满。报错三请求返回 401。说明TAOTOKEN_API_KEY没读到。先在 Terminal 里echo $TAOTOKEN_API_KEY确认有值没有就重新设置环境变量并重启 Android Studio。注意 Key 前后不要带空格。报错四baseUrl填错导致连接失败。确认填的是https://taotoken.net/api不要多加/v1或斜杠。不同工具对路径拼接方式不同多写反而会 404。报错五Database Inspector 里看不到数据库。确认 App 是 debug 版本且正在运行Inspector 只对 debuggable 的进程生效。另外数据库要真的被创建过如果getWritableDatabase()从没调用文件不会生成。报错六onUpgrade里直接 DROP 导致数据丢失。这是开发期图省事的写法上线前要改成增量迁移比如按oldVersion逐版本ALTER TABLE。上篇先跑通流程迁移策略下篇细说。排查顺序建议先看 Logcat 的完整堆栈定位是 SQL 层还是网络层SQL 层问题优先怀疑数据库是否重建网络层问题优先怀疑环境变量和地址。6. 下一步把 AI 辅助接进日常编码上篇到这里你已经完成了三件事TaoToken 的 Key 和 API 通道准备好、settings.json/config.toml骨架落地、SQLite 建库建表并用 Database Inspector 验证通过。下篇会补上Cursor的查询封装、事务处理以及怎么在 Android Studio 里用 AI 辅助生成这些样板代码。如果你打算长期在 Android Studio 里用 AI 辅助编码、甚至跑 Agent 类任务建议直接看 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 管理还是回到 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。一个实用小技巧把DBHelper的建表语句和settings.json一起放进项目的docs/目录做版本记录每次改表结构或换模型都留一行注释下次排查时能直接对上时间线。