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 found：assets 里找不到文件
检查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 type='table';先列出所有表，确认表名。
5.5 TaoToken 配置报 401
apiKey填错或者过期。去 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 统一通道接入，不用来回切换配置。这套流程我跑过多次，只要文件格式对，基本一次过。
