1. 为什么外部数据库导入后表是空的Android Studio 里导入外部数据库这件事坑不在代码而在数据库文件本身。我见过太多人照着教程把nations.db丢进 assets代码跑通、日志没报错结果cursor.getCount()返回 0表是空的。问题基本都出在文件类型上Sqlite expert pro 默认导出的可能是.db或.sql后缀而 Android 的SQLiteDatabase.openOrCreateDatabase只认真正的 SQLite 格式文件。后缀名不对系统会当成空库新建一个你原来的表自然就没了。这篇要解决的就是这条完整链路用 Sqlite expert pro 建一个标准 SQLite 库放进 Android 项目用 IO 流写入应用私有目录再通过 TaoToken 统一 Key 通道接入 AI 工具辅助排查导入过程中的报错。适合正在做本地开发调试、需要预置数据到 App 里的 Android 开发者。读完之后你应该能独立完成外部库导入并且用日志验证数据确实可读。核心检索词先摆出来Android Studio 导入外部数据库、Sqlite expert pro 建库、assets 目录拷贝、SQLiteDatabase 打开、TaoToken 接入 AI 调试。这几个词贯穿全文你按顺序操作就行。先说结论数据库文件必须是 SQLite 类型后缀建议.sqlite或.db但内容格式必须是 SQLite 二进制格式。Sqlite expert pro 里导出时选 SQLite 3 格式别选 SQL 脚本。这是后面所有步骤的前提。2. 用 Sqlite expert pro 建库并放进项目2.1 建库时的关键设置打开 Sqlite expert pro新建数据库时文件名我习惯用nations.sqlite明确告诉自己和 Android 这是 SQLite 格式。建表语句直接在 SQL 编辑器里跑CREATE TABLE china_nations ( id INTEGER PRIMARY KEY AUTOINCREMENT, nation TEXT NOT NULL ); INSERT INTO china_nations (nation) VALUES (汉族); INSERT INTO china_nations (nation) VALUES (蒙古族); INSERT INTO china_nations (nation) VALUES (回族); INSERT INTO china_nations (nation) VALUES (藏族);建完之后别急着导出。先在 Sqlite expert pro 里执行SELECT COUNT(*) FROM china_nations;确认返回 4。如果这里就是 0说明插入没成功后面 Android 里更不可能有数据。导出时选 Export → Database to SQLite file格式选 SQLite 3。如果你导出的是.sql文本文件那里面是 SQL 语句不是数据库二进制Android 打不开。这一点是很多人踩过的坑我试过把.sql直接改名成.db结果打开还是空表因为文件内容根本没变。2.2 放进 assets 目录在 Android Studio 项目里右键app模块 → New → Folder → Assets Folder创建src/main/assets。把nations.sqlite拖进去。目录结构长这样app/ src/ main/ assets/ nations.sqlite java/ com/example/test2/ MainActivity.java NationOpenDB.java Nations.java注意assets是 Android Studio 识别的标准目录不用在build.gradle里额外配置。如果你用的是res/raw那要用R.raw.nations引用路径写法不同本文统一用 assets。2.3 确认包名和路径NationOpenDB类里有两个常量必须和你的项目一致public static final String DB_NAME nations.sqlite; public static final String PACKAGE_NAME com.example.test2;PACKAGE_NAME就是app/build.gradle里的applicationId或者AndroidManifest.xml里的package。写错了会导致DB_PATH指向不存在的目录mkdirs()建出来的目录和实际应用私有目录对不上数据库文件写到了别的地方查询自然为空。3. 可复制的导入配置与 settings.json 骨架3.1 IO 流封装类完整代码下面这个类可以直接复制改两个常量即可package com.example.test2; import android.content.Context; import android.database.sqlite.SQLiteDatabase; import android.os.Environment; import android.util.Log; import java.io.File; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; public class NationOpenDB { private final int BUFFER_SIZE 400000; public static final String DB_NAME nations.sqlite; public static final String PACKAGE_NAME com.example.test2; public static final String DB_PATH /data Environment.getDataDirectory().getAbsolutePath() / PACKAGE_NAME /databases; private Context context; public NationOpenDB(Context context) { this.context context; } public SQLiteDatabase openDatabase() { try { File myDataPath new File(DB_PATH); if (!myDataPath.exists()) { myDataPath.mkdirs(); } String dbFile myDataPath / DB_NAME; if (!(new File(dbFile).exists())) { InputStream is context.getAssets().open(DB_NAME); FileOutputStream fos new FileOutputStream(dbFile); byte[] buffer new byte[BUFFER_SIZE]; int count; while ((count is.read(buffer)) ! -1) { fos.write(buffer, 0, count); } fos.flush(); fos.close(); is.close(); } return SQLiteDatabase.openOrCreateDatabase(dbFile, null); } catch (FileNotFoundException e) { Log.e(test2, File not found!); e.printStackTrace(); } catch (IOException e) { Log.e(test2, IO exception); e.printStackTrace(); } return null; } }关键点DB_NAME用.sqlite后缀PACKAGE_NAME和你的applicationId完全一致。BUFFER_SIZE设 400000 是为了大文件拷贝时减少循环次数小库用默认也行。3.2 实体类与查询验证实体类保持简单package com.example.test2; public class Nations { public Integer id; public String nation; public Integer getId() { return id; } public void setId(Integer id) { this.id id; } public String getNation() { return nation; } public void setNation(String nation) { this.nation nation; } }在MainActivity.onCreate里查询NationOpenDB nation new NationOpenDB(this); SQLiteDatabase sqLiteDatabase nation.openDatabase(); if (sqLiteDatabase null) { Log.e(test2, 数据库打开失败); return; } Cursor cursor sqLiteDatabase.rawQuery(select * from china_nations, null); Log.e(test2, cursor count: cursor.getCount()); while (cursor.moveToNext()) { int id cursor.getInt(cursor.getColumnIndex(id)); String name cursor.getString(cursor.getColumnIndex(nation)); Log.e(test2, id name); } cursor.close();3.3 TaoToken 接入 AI 调试的 settings.json 骨架导入报错时与其自己翻日志不如把错误信息丢给 AI 工具分析。TaoToken 提供统一的 Key/API 通道你只需要在工具的配置文件里填一次。以常见的 AI 编码工具为例settings.json骨架如下{ aiProvider: { baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken Key, model: claude-sonnet-4-20250514 }, debug: { logLevel: verbose, attachAndroidLog: true } }baseUrl固定用https://taotoken.net/api不要加多余路径。apiKey在 TaoToken 控制台的 API Keys 页面生成生成后复制粘贴别手动改字符。模型名按你实际订阅的填不确定就用默认。这个配置的作用是当openDatabase()抛异常或者cursor.getCount()为 0 时你可以把 Logcat 里的堆栈直接贴给 AI让它帮你判断是路径问题、文件格式问题还是权限问题。TaoToken 在这里的角色是统一通道省去你为每个工具单独配 Key 的麻烦。4. 验证请求与成功结果4.1 运行前检查清单在点 Run 之前确认三件事第一assets/nations.sqlite确实存在且在 Android Studio 的 Project 视图里能看到。如果看不到说明 Assets Folder 没建对检查src/main/assets路径。第二PACKAGE_NAME和applicationId一致。打开app/build.gradle看defaultConfig里的applicationId复制过来。第三数据库文件是 SQLite 格式。用 Sqlite expert pro 打开nations.sqlite能正常看到china_nations表和 4 条数据说明格式没问题。4.2 预期 Logcat 输出运行 App在 Logcat 里过滤test2标签应该看到E/test2: cursor count: 4 E/test2: 1 汉族 E/test2: 2 蒙古族 E/test2: 3 回族 E/test2: 4 藏族cursor count: 4是核心验证点。如果这里是 0说明数据库打开了但表是空的回到第 2 节检查导出格式。如果openDatabase()返回 null看 Logcat 里是 File not found 还是 IO exception前者是 assets 路径问题后者是读写权限或文件损坏。4.3 用 TaoToken 辅助验证如果你想进一步确认数据库内容可以把nations.sqlite的十六进制头部贴给 AI 工具。SQLite 文件开头是SQLite format 3的 ASCII 码用 TaoToken 通道接入的模型对话功能直接问这个文件头是不是 SQLite 格式几秒就能得到判断。这比你自己查文档快。模型对话入口在 TaoToken 控制台选好模型后把文件头贴进去即可。注意不要贴完整的数据库文件只贴前 16 字节的十六进制就够判断格式了。5. 本篇常见错排查5.1 表是空的cursor count 为 0这是最高频的问题。原因几乎都是数据库文件不是 SQLite 格式。Sqlite expert pro 导出时如果选了 SQL script得到的是.sql文本文件里面是CREATE TABLE语句不是二进制数据库。Android 的openOrCreateDatabase遇到非 SQLite 文件会新建一个空库所以表是空的。解决办法重新导出格式选 SQLite 3后缀用.sqlite。导出后用 Sqlite expert pro 再打开一次确认能查到数据。5.2 File not foundassets 里找不到文件检查assets目录位置。必须是app/src/main/assets不是app/assets也不是src/assets。另外文件名大小写敏感Nations.sqlite和nations.sqlite是两个文件。DB_NAME常量要和实际文件名完全一致。如果你用的是res/raw那open方法要改成context.getResources().openRawResource(R.raw.nations)且文件名不能有大写字母和特殊字符。5.3 IO exception写入失败通常是DB_PATH目录创建失败。Environment.getDataDirectory().getAbsolutePath()返回/data加上包名和/databases得到/data/com.example.test2/databases。这个路径在未 root 的真机上普通应用无权直接访问但context.getAssets()拷贝到应用私有目录是允许的因为应用对自己的/data/data/包名/有权限。注意Environment.getDataDirectory()返回的是/data而应用私有目录实际是/data/data/包名/。上面代码里DB_PATH拼出来是/data/com.example.test2/databases少了data这一层。正确写法应该是public static final String DB_PATH context.getFilesDir().getParent() /databases;或者用context.getDatabasePath(DB_NAME).getParent()。我建议直接用后者最稳妥String dbFile context.getDatabasePath(DB_NAME).getAbsolutePath();这样不用手动拼路径也不会因为包名写错导致目录不对。5.4 查询报 no such table数据库打开了但表名不对。Sqlite expert pro 里建表时如果用了引号或者大小写不一致Android 里查询的表名要完全匹配。china_nations和China_Nations在 SQLite 里默认不区分大小写但如果你建表时用了双引号包裹可能产生差异。统一用小写加下划线最安全。另外确认查询的是china_nations而不是其他表名。用SELECT name FROM sqlite_master WHERE typetable;先列出所有表确认表名。5.5 TaoToken 配置报 401apiKey填错或者过期。去 TaoToken 控制台的 API Keys 页面重新生成一个复制完整字符串。注意不要有多余空格baseUrl不要加/v1之类的后缀就用https://taotoken.net/api。如果还是 401检查 Key 是否有对应模型的权限。6. 接入文档与后续调试通道导入流程跑通之后后续调试还会遇到各种数据库问题版本升级、表结构变更、多表关联查询报错。这时候有一个稳定的 AI 辅助通道会省很多时间。TaoToken 的接入文档里有完整的配置说明和示例包括不同工具的settings.json写法、模型选择建议、错误码对照。如果你主要做长期编码和 Agent 类任务可以看 Coding Plan 的配置方式它适合需要持续对话、多轮调试的场景。如果只是偶尔验证模型输出用模型对话入口就够了。API Keys 管理在控制台生成和吊销都在那里操作。回到本篇的核心Android Studio 导入外部数据库关键就三步——Sqlite expert pro 导出 SQLite 格式、assets 目录放对、DB_PATH用getDatabasePath拿。验证看cursor count是否等于你的数据条数。报错了就把 Logcat 贴给 AI 工具通过 TaoToken 统一通道接入不用来回切换配置。这套流程我跑过多次只要文件格式对基本一次过。
