使用cblite将JSON每行数据导入为Couchbase Lite独立文档失败及Kotlin查询空指针问题求助

我来帮你一步步梳理并解决这个问题，核心其实是两个关键点：搞定cblite的正确导入姿势，以及修复查询时的NullPointerException。

一、先解决JSON文件的正确导入问题 #

你提到的整个文件被当成单个文档导入，大概率是因为导入命令的用法不对。根据你给出的cblite参数说明，.json后缀文件要求每行是独立JSON对象，你的文件格式是对的，只要调整命令就能解决。

正确的导入命令格式 #

你需要使用cblite import命令，明确指定目标为你的.cblite2数据库，源为多行JSON文件。具体命令如下：

# macOS/Linux环境
cblite import /path/to/your/target.db.cblite2 --json /path/to/your/data.json

# Windows环境
cblite import C:\path\to\target.db.cblite2 --json C:\path\to\data.json

几个关键注意点：

• 目标必须是.cblite2数据库路径（如果数据库不存在，cblite会自动创建）
• 一定要加--json参数，它会告诉cblite按行解析每个JSON对象为独立文档
• 确保你的JSON文件每行都是合法完整的JSON对象（你的示例格式完全符合要求，比如每行都是{"_id":13,...}的结构）

验证导入结果 #

导入完成后，用cblite cat命令检查数据库内容，确认是否生成了多个独立文档：

cblite cat /path/to/target.db.cblite2

如果输出是多个独立的JSON文档，而不是一个包含所有对象的大文档，就说明导入成功了。

二、修复查询时的NullPointerException #

你遇到的查询问题，根源可能是导入错误导致文档结构异常，或者代码里的小细节没处理好。

1. 先确认文档结构 #

如果导入后还是所有键重复100次，那说明每个键的值变成了数组（比如"_id": [13,14,...]），这时你用getString("id")自然会报错——因为它是数组类型，不是字符串。所以第一步必须确保导入正确，每个JSON对象都是独立文档，每个键对应单个值。

2. 优化查询代码 #

假设导入正确，每个文档都是独立的，你可以调整代码避免NullPointerException：

• 优先使用getNullable*()方法（Couchbase Lite Kotlin SDK支持），或者先判断字段是否存在
• 注意区分文档元数据ID（Meta.id）和你自定义的id字段，建议给元数据ID起别名避免冲突

修改后的代码示例：

val query = QueryBuilder
    .select(
        SelectResult.expression(Meta.id).`as`("doc_id"), // 给元数据ID起别名，避免和自定义id冲突
        SelectResult.property("owner"),
        SelectResult.property("secret"),
        SelectResult.property("server"),
        SelectResult.property("farm"),
        SelectResult.property("title"),
        SelectResult.property("ispublic"),
        SelectResult.property("isfriend"),
        SelectResult.property("isfamily"),
        SelectResult.property("url_s"),
        SelectResult.property("height_s"),
        SelectResult.property("width_s"),
    )
    .from(DataSource.database(database))

val result = query.execute().allResults()
for (rs in result) {
    // 用getNullable*方法处理空值，避免NullPointerException
    val id = rs.getNullableString("id") ?: continue // 如果自定义id为空，跳过这条数据
    val owner = rs.getNullableString("owner") ?: ""
    val secret = rs.getNullableString("secret") ?: ""
    val server = rs.getNullableString("server") ?: ""
    val farm = rs.getNullableInt("farm") ?: 0
    val title = rs.getNullableString("title") ?: ""
    val ispublic = rs.getNullableInt("ispublic") ?: 0
    val isfriend = rs.getNullableInt("isfriend") ?: 0
    val isfamily = rs.getNullableInt("isfamily") ?: 0
    val url_s = rs.getNullableString("url_s") ?: ""
    val height_s = rs.getNullableInt("height_s") ?: 0
    val width_s = rs.getNullableInt("width_s") ?: 0

    photoList.add(
        Photo(
            id, owner, secret, server, farm, title,
            ispublic, isfriend, isfamily, url_s, height_s, width_s
        )
    )
}

另外要确保你的Photo类构造参数类型和数据库字段类型匹配（比如farm是Int类型，你的JSON里是数字，没问题）。

三、Kotlin中使用N1QL的小提示 #

Couchbase Lite支持N1QL查询，在Kotlin里可以用Query.fromN1QL()简化代码，比如：

val n1qlQuery = Query.fromN1QL(DataSource.database(database), """
    SELECT META().id AS doc_id, owner, secret, server, farm, title, 
           ispublic, isfriend, isfamily, url_s, height_s, width_s
    FROM your_database_name
""")
val result = n1qlQuery.execute().allResults()
// 后续处理和之前类似

注意：

• META().id对应文档的元数据ID
• FROM后面的是你创建数据库时指定的名称
• 可以直接添加过滤条件，比如WHERE owner = '126542062@N08'来筛选数据

你可以从简单的N1QL语句开始尝试，熟悉语法后再写复杂查询。

总结 #

1. 先用正确的cblite import命令导入多行JSON，确保每个JSON对象成为独立文档
2. 验证数据库文档结构是否符合预期
3. 调整查询代码，用getNullable*处理空值，区分元数据ID和自定义字段
4. 尝试N1QL查询简化代码逻辑

内容的提问来源于stack exchange，提问作者Saher Al-Sous