Kotlin中Sugar ORM无法保存数据问题求助

我有一个继承自SugarRecord的类，已在Manifest中配置好Sugar元数据，但在MainActivity.kt中创建Advertiser类的新实例并尝试保存时，抛出了空指针异常，堆栈跟踪片段如下：

FATAL EXCEPTION: main
Process: ge.ketili.team.blocksms, PID: 22305
java.lang.RuntimeException: Unable to start activity ComponentInfo{ge.ketili.team.blocksms/ge.ketili.team.blocksms.MainActivity}: java.lang.NullPointerException: Attempt to invoke virtual method 'com.orm.Database c...

可能的原因及解决步骤 #

1. 确认Sugar ORM的全局初始化是否完成 #

SugarRecord依赖Application级别的初始化，你需要创建自定义Application类并完成初始化操作：

class BlockSMSApp : Application() {
    override fun onCreate() {
        super.onCreate()
        // 初始化Sugar上下文
        SugarContext.init(this)
    }

    override fun onTerminate() {
        super.onTerminate()
        // 销毁时清理资源
        SugarContext.terminate()
    }
}

同时要在Manifest中指定这个自定义Application：

<application
    android:name=".BlockSMSApp"
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    ...>
    <!-- 其他配置项 -->
</application>

2. 检查Manifest中的Sugar元数据配置是否正确 #

确保元数据的键名和值都符合要求，尤其是包名和数据库配置：

<meta-data
    android:name="DATABASE"
    android:value="blocksms.db" />
<meta-data
    android:name="VERSION"
    android:value="1" />
<meta-data
    android:name="QUERY_LOG"
    android:value="true" />
<!-- 这里要填你实体类所在的根包名 -->
<meta-data
    android:name="DOMAIN_PACKAGE_NAME"
    android:value="ge.ketili.team.blocksms" />

注意DOMAIN_PACKAGE_NAME必须指向Advertiser类所在的包路径，否则Sugar无法扫描到你的实体类。

3. 确保Advertiser类的实现符合Sugar要求 #

Sugar实体类必须有无参构造函数（Kotlin中如果主构造函数带参数，需要显式声明无参构造），且正确继承SugarRecord：

class Advertiser : SugarRecord<Advertiser>() {
    // 必须保留无参构造函数
    constructor() : super()

    // 带参数的业务构造函数
    constructor(name: String, phone: String) : super() {
        this.name = name
        this.phone = phone
    }

    var name: String? = null
    var phone: String? = null
}

如果使用Kotlin data class，也可以通过默认参数实现无参构造：

data class Advertiser(
    var name: String? = null,
    var phone: String? = null
) : SugarRecord<Advertiser>()

4. 保存实例时确保上下文有效 #

在MainActivity中保存实例时，优先使用SugarRecord自带的无参save()方法（内部会自动获取上下文），或者明确传入当前Activity的上下文：

// 推荐的保存方式
val advertiser = Advertiser("Test Advertiser", "123456789")
advertiser.save()

// 或者显式传入上下文
advertiser.save(this)

5. 清理缓存并重新构建项目 #

有时候旧的缓存会导致初始化异常，可以尝试：

• 清除应用的本地数据
• 在Android Studio中执行Clean Project + Rebuild Project
• 卸载应用后重新安装

如果以上方法都无法解决问题，建议补充完整的堆栈跟踪信息、Advertiser类的完整代码以及Manifest中的全部Sugar配置，这样能更精准地定位问题。

内容的提问来源于stack exchange，提问作者godot