Android领域层模型添加@Keep注解是否合规？附Moshi转换异常问题

异常原因 #

Release构建时，Android的R8/ProGuard会对代码做混淆压缩，把未被显式保护的类、字段名重命名甚至移除。Moshi反序列化时需要依赖类的完整类名和字段名匹配JSON结构，一旦领域层的IconInfo被混淆，Moshi没法正确映射，就会把JSON解析成默认的LinkedHashTreeMap，后续强转自然抛出ClassCastException。

领域层加@Keep的可行性 #

完全可行，且不会违背领域层的设计原则：

• @Keep是AndroidX提供的轻量注解，仅在编译期告诉R8/ProGuard不要混淆目标类/字段，不会引入任何运行时依赖，也不会侵入业务逻辑。
• 领域层的核心要求是「业务独立」，而非完全禁止所有依赖。像@Keep这种通用的、无业务侵入的工具类注解，不属于破坏领域层独立性的范畴——它只是解决编译期的混淆问题，和业务逻辑完全无关。

更贴合领域层无依赖的替代方案 #

如果坚持领域层绝对不引入任何外部注解，也可以通过ProGuard/R8配置解决：
在混淆规则文件中添加如下规则，直接保护领域层的模型类：

-keep class com.myAppPath.domain.model.IconInfo { *; }

这种方式不需要修改领域层代码，纯配置就能避免混淆问题，更符合严格的「领域层无依赖」要求。

关于你提供的IconDTO代码 #

你贴的IconDTO属于数据层模型，加@Keep没问题，但要注意真正需要保护的是领域层的IconInfo类——毕竟异常是发生在IconInfo的强转操作上，确保这个类的类名和字段不被混淆才是解决问题的核心。

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