Kotlin中使用@Parcelize 注解引发的序列化属性值丢失问题

Kotlin@Parcelize注解导致的序列化问题及解决,
最新推荐文章于 2025-10-26 13:20:02 发布
原创 最新推荐文章于 2025-10-26 13:20:02 发布 · 1k 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#kotlin #java #Parcelize #parcelable

在Kotlin中使用@Parcelize注解时，如果类的属性在扩展构造方法中定义，可能会遇到序列化警告，提示属性不会被序列化到Parcel。这是因为@Parcelize只处理默认构造方法的变量。解决方法包括将所有变量移至默认构造函数，或者自定义序列化逻辑。

问题

Kotlin中使用@Parcelize 注解引发的序列化属性值丢失问题。

警告信息：

Property would not be serialized into a 'Parcel'

在这里插入图片描述

原因：

@Parcelize 注解动态生成的方法在序列化该类对象时，只会处理默认构造方法中的变量，并不会通过扩展构造方法序列化存取对象。

解决方法：

  • 方法一：将变量都放在默认构造方法中。

  • 方法二：针对扩展构造方法中的变量，自己去实现序列化。

    参考：https://blog.youkuaiyun.com/Iceti9er/article/details/121661564

使用Kotlin Parcelize实现对象序列化
2301_79326930的博客
08-21 648
Kotlin Parcelize是一个Kotlin的注解，用于自动生成Parcelable接口的实现。Parcelable是Android平台提供的一种机制，用于在不同组件之间传递对象。通过实现Parcelable接口，我们可以将对象写入Parcel（一种用于高效传输数据的容器），并从Parcel中读取对象的数据。使用Kotlin Parcelize可以简化实现Parcelable接口的过程，避免手动编写大量的重复代码。有时候，我们可能需要自定义对象的序列化和反序列化过程。
Kotlin 序列化库介绍以及实践分享
AI天才研究院
10-11 1273
作者：禅与计算机程序设计艺术 1.背景介绍 Kotlin Serialization 简介 Kotlin 是一个多范型编程语言，同时拥有静态类型检测和动态类型支持，具有安全、易用性强等优点。而它的一个重要特性就是可以编译成
Kotlin 一个好用的新功能：Parcelize
weixin_34212189的博客
12-15 770
在开发中，如果有需要用到序列化和反序列化的操作，就会用到 Serializable 或者 Parcelable，它们各有优缺点，会适用于不同的场景。 Serializable 的优点是实现简单，你只需要实现一个 Serializable 接口，并不需要任何额外的代码，但是它的序列化和反序列化，实际上是使用反射做的，所以效率会略低，并且它会在序列化的过程中，会创建很多临时变量，所以更容易触发 GC...
你真的会用Kotlin注解吗？这7种错误用法90%开发者都踩过坑
最新发布
FuncIsle的博客
10-26 394
掌握Kotlin注解用法，避开常见误区提升开发效率。本文详解7种典型错误及正确实践，覆盖编译期处理、运行时反射等场景，助你精准掌握注解在Android与服务端开发中的高效应用，值得收藏。
kotlin 注解 @Parcelize 使用示例和步骤详解
chinaherolts2008的博客
07-18 542
Parcelable 接口是 Android 中用于在组件之间传递对象的一种方式,在 Kotlin 中,@Parcelize 注解用于简化实现 Android Parcelable 接口的过程,本文给大家分享kotlin 注解 @Parcelize 使用示例,感兴趣的朋友一起看看吧。检查你的 Kotlin 版本，@Parcelize 在较新的 Kotlin 版本中已经被移到 kotlinx.parcelize 包下，而不是旧的 kotlin.android.parcel 包。
kotlin使用@Parcelize报错
ぃ随风逍遥う的博客
09-23 956
在app/build.gradle plugins 里添加 id ‘kotlin-parcelize’AGP版本 1.8.0。
Kotlin用@Parcelize实现序列化Parcelable
Gyso的博客
06-04 2492
文章目录简介使用总结 简介 在Android项目中经常要对Bean进行Parcelable序列化，也有很多序列化工具。Android中提倡通过实现Parcelable来对对象序列化，但是如果是使用Java开发实现起来就比较繁琐，而Kotlin提供了@Parcelize，可以轻松实现对Bean的序列化及反序列话。先看看官方对@Parcelize的解析： /** * Instructs the Kotlin compiler to generate `writeToParcel()`, `describeCo
教你如何完全解析Kotlin中的注解
Mikyou的专栏
04-24 6729
简述: 从这篇文章将继续开始探索Kotlin中的一些高级的内容，之前有着重探讨了Kotlin的泛型以及泛型型变等内容。现在我们一起来看下Kotlin中的注解。Kotlin中的注解是100%与Java注解兼容的，有很多相同的地方，但是也有一些不同的地方。一起来瞅瞅吧~ 一、注解的本质 注解实际上就是一种代码标签，它作用的对象是代码。它可以给特定的注解代码标注一些额外的信息。然而这些信息可以选择不同保...
【注解】@JsonIgnoreProperties 指示在序列化和反序列化过程中要忽略的属性。
代码的魅力，根本走不出来
01-16 1736
是 Jackson 库中的注解，用于指示在序列化和反序列化过程中要忽略的属性。具体来说，可以用在和上。
Kotlin中Json的序列化与反序列化 -- Gson、Moshi
乐翁龙
06-01 5555
文章目录Kotlin中Json的序列化和反序列化 -- Gson、Moshi实体类集成方式GsonMoshi非空类型序列化反序列化结论可空类型序列化反序列化结论总结 Kotlin中Json的序列化和反序列化 – Gson、Moshi 在App的开发中避免不了需要和Json格式的数据打交道，这节我们来看下Json相关的序列化和反序列化的内容。同时注意我们使用Kotlin来进行示例，来进一步理解下Kotlin的空安全设计。 实体类 这里我们准备两个实体类，Car和Driver。购买汽车会随机赠送一个驾驶员： d
Kotlin专题「二十四」：注解
https://juejin.cn/user/1654096907477549/posts
01-19 1051
前言：知人者智，自知者明；胜人者力，自胜者强。   ——《道德经》 一、概述 Java 中的泛型   在 Java 中，其实所谓的泛型就是类型的参数化。如果方法有入参，那么这些入参面前往往会有类型，这个类型就是修饰参数所用。假如我们在创建类型的时候，也为其指定了参数，这个参数又是个类型，这种我们就称为泛型。 public void addList(Collection<T> list) {//T表示可传入任何类型表示 //TODO } 使用泛型能够像传递参数..
Kotlin中通过@Parcelize注解实现Parcelable序列化
Mr.Dong的博客
02-09 1972
1.引入 plugins { id 'com.android.application' id 'kotlin-android' id 'kotlin-android-extensions' id 'kotlin-kapt' } android { ... androidExtensions { experimental = true } ... ... compileOptions { sourceC
kotlin 注解 @Parcelize 使用
阿饱同学
06-18 2094
在 Kotlin 中，@Parcelize注解用于简化实现 AndroidParcelable接口的过程。Parcelable接口是 Android 中用于在组件之间传递对象的一种方式。通常，实现Parcelable接口需要编写大量样板代码，但使用@Parcelize注解可以大大简化这个过程。以下是使用@Parcelize。
Android kotlin序列化之@Parcelize详解与使用
热门推荐
06-09 1万+
如果在使用过程中，通过注解发生了数据异常，需要检查对象是否序列化了，如果通过构造器的，查看方法体是否参与了，如果是很简单的数据建议构造器，如果是复杂的数据，建议抛弃构造器如果采用了注解，就不能使用类中定义类这种用法，否则对象获取为null。那用什么？接下来我会介绍抛弃注解，直接使用手写。
kotlin Parcelize 序列化 报错
Joker_1228的博客
10-28 2281
根据报错提示 在 CdUser 的参数的类型前面加上 @RawValue 注解就可以了。这时候对CdUser 类进行序列化的时候 会报上述错误。
Kotlin Parcelable @Parcelize 知识总结
louisgeek的专栏
02-16 2301
Kotlin 1.4.20 及以后 //独立插件 apply plugin: 'kotlin-parcelize' Kotlin 1.3.60 及以后 //扩展插件 包括 @Parcelize 和 kotlinx.android.synthetic(替代findViewById) apply plugin: 'kotlin-android-extensions' //如果只想启用扩展插件里的 parcelize 功能 androidExtensions { features = ["p.
Kotlin Parcelable 相关 @Parcelize 记录
Keep Learning , Keep Improving !
01-11 566
Kotlin 1.4.20 及以后 //独立插件 apply plugin: 'kotlin-parcelize' Kotlin 1.3.60 及以后 //扩展插件 包括 @Parcelize 和 kotlinx.android.synthetic(替代findViewById) apply plugin: 'kotlin-android-extensions' //如果只想启用扩展插件里的 parcelize 功能 androidExtensions { features = ["p.
Kotlin @Parcelize 配置方法
qq_36113746的博客
11-02 597
Kotlin @Parcelize 配置方法
kotlin使用Parcelize注解简化Parcelable的书写
simplepeng的博客
12-05 7448
kotlin使用Parcelize注解简化Parcelable的书写Parcelize注解kotlin在1.1.4版本增加了对parcelable的支持Android扩展插件现在包含一个实现了Parcelable的自动生成器。在主构造函数中声明序列化的属性并添加一个@Parcelize注解，生成器就会自动创建writeToParcel（）/ createFromParcel（）方法需求环境Kotli
使用 @Convert 注解处理复杂类型时如何避免空指针异常？
07-22
<think>我们正在处理的是在Kotlin中使用ObjectBox时，通过@Convert注解处理复杂类型以避免空指针异常的问题。根据引用内容，我们知道Kotlin对空安全有严格的要求，而ObjectBox作为数据库框架，在存储和检索数据时可能会遇到空值问题，特别是当我们使用转换器将复杂类型（如自定义类）转换为数据库可存储的类型（如String）时。 解决方案的核心点： 1. 使用@Convert注解时，确保转换器能够正确处理null值。 2. 在Kotlin中，由于非空类型的限制，我们需要确保从数据库读取的数据即使为null也能安全处理。 步骤： 1. 定义复杂类型时，考虑其可空性： - 如果数据库字段可能为null，则实体类中的相应属性应声明为可空类型（如String?）。 - 或者，在转换器中处理null，将其转换为一个默认的非空值（例如空字符串或空对象）。 2. 编写转换器（Converter）时，确保在转换方法中处理null情况： - 在将复杂类型转换为数据库存储的类型（如String）时，如果复杂类型为null，可以返回null或者一个代表空的值（如空字符串）。 - 在将数据库存储的类型转换回复杂类型时，如果数据库值为null，可以返回null或者一个默认的复杂类型实例。 3. 在实体类中，根据转换器的行为决定属性的可空性： - 如果转换器能够保证从不返回null（即数据库值为null时，转换器返回一个非空的默认对象），那么属性可以声明为非空类型。 - 否则，属性应声明为可空类型。 4. 使用安全调用操作符（?.）或Elvis运算符（?:）来访问可空属性，以避免空指针异常。 示例： 假设我们有一个复杂类型`UserProfile`，需要存储在ObjectBox中。我们将使用一个转换器将其转换为String存储。 步骤1：定义复杂类型（注意，这个类本身可以是非空的，但作为实体属性时，根据转换器行为决定是否可空） ```kotlin data class UserProfile(val name: String, val age: Int) ``` 步骤2：编写转换器，处理null情况： ```kotlin class UserProfileConverter : PropertyConverter<UserProfile?, String?> { // 将UserProfile对象转换为String（用于存储到数据库） override fun convertToDatabaseValue(entityProperty: UserProfile?): String? { // 如果entityProperty为null，则返回null return entityProperty?.let { // 这里使用JSON序列化作为示例 Gson().toJson(it) } } // 将数据库中的String转换为UserProfile对象 override fun convertToEntityProperty(databaseValue: String?): UserProfile? { // 如果databaseValue为null或空，则返回null return databaseValue?.let { try { Gson().fromJson(it, UserProfile::class.java) } catch (e: Exception) { null // 解析失败返回null } } } } ``` 注意：上面的转换器允许数据库值为null，并且转换后的实体属性也为null。因此，在实体类中，我们需要将属性声明为可空类型。 步骤3：在实体类中使用转换器，并声明属性为可空： ```kotlin @Entity data class User( @Id var id: Long = 0, // 使用转换器，并声明属性为可空 @Convert(converter = UserProfileConverter::class, dbType = String::class) var profile: UserProfile? = null ) ``` 这样，当从数据库中读取数据时，如果数据库中的字符串为null，则profile属性就会为null，而不会尝试将一个null值赋给非空类型，从而避免了空指针异常。 但是，如果我们希望profile属性不能为null，我们可以在转换器中进行处理，确保即使数据库值为null，我们也返回一个默认的UserProfile对象： 修改转换器： ```kotlin class UserProfileNonNullConverter : PropertyConverter<UserProfile, String?> { // 转换到数据库：非空的UserProfile转换为字符串 override fun convertToDatabaseValue(entityProperty: UserProfile): String? { return Gson().toJson(entityProperty) } // 转换到实体：数据库值（可能为null）转换为非空的UserProfile override fun convertToEntityProperty(databaseValue: String?): UserProfile { return databaseValue?.let { try { Gson().fromJson(it, UserProfile::class.java) } catch (e: Exception) { UserProfile("", 0) // 默认值 } } ?: UserProfile("", 0) // 当databaseValue为null时，返回默认值 } } ``` 然后在实体类中，我们可以将profile声明为非空类型： ```kotlin @Entity data class User( @Id var id: Long = 0, @Convert(converter = UserProfileNonNullConverter::class, dbType = String::class) var profile: UserProfile = UserProfile("", 0) // 初始值，但注意：ObjectBox在从数据库读取时会使用转换器，所以这个初始值只在创建新对象时使用 ) ``` 这样，无论数据库中的值如何，profile属性都不会为null。 注意事项： - 在转换器中处理异常：如果数据库中的字符串格式不正确，转换器应该能够处理异常并返回一个合理的默认值，而不是抛出异常（除非你希望它抛出异常，但这样可能会导致应用崩溃）。 - 性能：序列化和反序列化可能比较耗时，尤其是当数据量较大时。确保转换器的高效性。 - 测试：编写单元测试来测试转换器的各种情况，包括null、空字符串、无效字符串等。 引用内容中提到的[^3]提醒我们谨慎使用!!运算符，因此我们在处理从数据库中读取的数据时，应避免使用!!，而是通过转换器确保非空，或者使用安全调用。 总结：通过合理设计转换器，我们可以确保在使用@Convert注解时避免空指针异常。关键在于转换器对null和异常情况的处理，以及实体类中属性的可空性声明。 相关问题： 1. 在 Kotlin 中，如何为 ObjectBox 实体设计一个安全的枚举类型转换器？ 2. ObjectBox 的 @Convert 注解支持哪些数据库类型？ 3. 如何处理 ObjectBox 转换器中的异常？ 4. 在 Kotlin 中使用 ObjectBox 时，如何优化自定义类型转换的性能？</think>### 在 Kotlin 中使用 ObjectBox 的 `@Convert` 注解安全处理复杂类型 通过 `@Convert` 注解处理复杂类型时，避免空指针异常的关键在于正确处理 Kotlin 的空安全特性和转换器逻辑。以下是完整解决方案： #### 1. **定义安全的数据类（使用空安全设计）** ```kotlin // 使用非空属性 + 默认值 data class Settings( val theme: String = "light", val notifications: Boolean = true ) // 或明确声明可空类型 data class Settings( val theme: String?, val notifications: Boolean? ) ``` #### 2. **实现安全的转换器（处理 null 值）** ```kotlin class SettingsConverter : PropertyConverter<Settings, String> { // 处理数据库 null 值 → 返回默认对象 override fun convertToEntityProperty(databaseValue: String?): Settings { return databaseValue?.let { try { Json.decodeFromString(it) } catch (e: Exception) { Settings() // 解析失败返回默认值 } } ?: Settings() // 数据库值为 null 时返回默认值 } // 处理对象 null 值 → 返回空字符串 override fun convertToDatabaseValue(entityProperty: Settings?): String { return entityProperty?.let { Json.encodeToString(it) } ?: "" // 对象为 null 时存储空字符串 } } ``` #### 3. **在实体类中安全使用** ```kotlin @Entity data class User( @Id var id: Long = 0, // 方案1: 非空属性 + 默认值 @Convert(converter = SettingsConverter::class, dbType = String::class) var settings: Settings = Settings(), // 方案2: 可空属性 + 安全访问 @Convert(converter = SettingsConverter::class, dbType = String::class) var preferences: Settings? = null ) { // 安全访问方法 fun getSafePreferences(): Settings { return preferences ?: Settings() } } ``` #### 4. **关键安全措施** 1. **转换器防御** ```kotlin override fun convertToEntityProperty(dbValue: String?): Settings { if (dbValue.isNullOrBlank()) return Settings() // ...解析逻辑 } ``` 2. **属性初始化** ```kotlin // 避免使用 lateinit（危险！） var settings: Settings = Settings() // ✅ 正确 @Convert(...) lateinit var settings: Settings // ❌ 危险！可能未初始化 ``` 3. **安全访问扩展** ```kotlin // 定义扩展函数 fun User.safeSettings() = settings ?: Settings() // 使用 user.safeSettings().theme ``` #### 5. JSON 序列化的空安全处理 ```kotlin // 使用 Kotlinx Serialization（内置空安全） @Serializable data class Settings( val theme: String = "light", val fontSize: Int? = null // 明确可空 ) // 在转换器中使用 val decoded = Json.decodeFromString<Settings>(jsonString) ``` #### 6. 单元测试用例 ```kotlin @Test fun `test null database value`() { val converter = SettingsConverter() val result = converter.convertToEntityProperty(null) assertEquals("light", result.theme) // 应返回默认值 } @Test fun `test invalid json`() { val converter = SettingsConverter() val result = converter.convertToEntityProperty("{invalid}") assertNotNull(result) // 不应返回 null } ``` #### 最佳实践总结 1. **避免 `!!` 操作符** 在转换器中绝对不要使用 `value!!`，优先使用空安全调用 `?.` 和 Elvis 运算符 `?:`[^3] 2. **区分设计意图** - 核心配置 → 非空类型 + 默认值 - 可选配置 → 可空类型 + 安全访问方法 3. **版本兼容处理** ```kotlin // 处理字段新增的情况 override fun convertToEntityProperty(dbValue: String?): Settings { val oldSettings = dbValue?.let { parseOldFormat(it) } return oldSettings?.toNewFormat() ?: Settings() } ``` 4. **监控异常** ```kotlin BoxStore.addObserver { event -> if (event is Throwable) { logError("转换异常", event) } } ``` > **技术原理**：Kotlin 的空安全机制会在字节码中插入空检查指令[^1]，而 `@Convert` 注解在 ObjectBox 中作用于属性存取过程。通过转换器处理 null 值，可避免 Kotlin 的非空检查抛出异常。 --- ### 相关问题 1. 如何在 ObjectBox 中处理枚举类型的空安全转换？ 2. 使用 Kotlinx Serialization 时如何优化 ObjectBox 的转换性能？ 3. ObjectBox 的 `@Convert` 注解支持哪些复杂类型？ 4. 如何为 ObjectBox 的转换器编写单元测试？ 5. 在 Kotlin 多平台项目中如何共享 ObjectBox 转换器逻辑？ [^1]: Kotlin 空安全原理 [^2]: Kotlin 类型系统 [^3]: !!操作符风险
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

唐诺

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值