如何在Kotlin数据类中废弃指定字段且保留数据类特性？

首先明确：Kotlin的@Deprecated注解完全支持标记PROPERTY（属性），你之前的写法本身合法，若未生效可能是IDE缓存问题，或是需要更彻底覆盖数据类自动生成的相关方法（比如copy、解构函数），确保所有使用age的场景都能触发警告。

下面提供两种优雅的迁移方案：

方案一：保留age构造参数，全面标记废弃 #

适合需要逐步迁移、暂时保留age字段存储的场景，同时覆盖数据类自动生成的copy方法和解构component函数，确保所有使用age的入口都能收到警告：

import java.time.ZonedDateTime

enum class UserType { ADMIN, MEMBER }

data class User(
    val name: String,
    val type: UserType,
    
    @Deprecated(
        "改用birthDay字段动态计算年龄",
        level = DeprecationLevel.WARNING
    )
    val age: Int,
    
    val birthDay: ZonedDateTime
) {
    // 重写copy方法，标记age参数为废弃
    @Deprecated(
        "使用birthDay替代age参数",
        level = DeprecationLevel.WARNING
    )
    fun copy(
        name: String = this.name,
        type: UserType = this.type,
        @Deprecated("改用birthDay") age: Int = this.age,
        birthDay: ZonedDateTime = this.birthDay
    ): User = User(name, type, age, birthDay)

    // 标记对应age的解构component函数（age是第3个属性，对应component3）
    @Deprecated(
        "使用birthDay替代解构获取age",
        level = DeprecationLevel.WARNING
    )
    operator fun component3(): Int = age
}

方案二：将age改为派生属性，彻底废弃存储 #

如果你的目标是完全用birthDay替代age（不再存储age值），可以把age改成通过birthDay计算的派生属性，既保留数据类结构，又实现健壮的年龄逻辑：

import java.time.ZonedDateTime
import java.time.temporal.ChronoUnit

enum class UserType { ADMIN, MEMBER }

data class User(
    val name: String,
    val type: UserType,
    val birthDay: ZonedDateTime
) {
    @Deprecated(
        "从birthDay动态计算年龄，不再直接存储age字段",
        level = DeprecationLevel.WARNING
    )
    val age: Int
        get() = ChronoUnit.YEARS.between(birthDay, ZonedDateTime.now()).toInt()
}

说明 #

• 方案一：在迁移过渡期保留age的存储，所有直接使用age、解构获取age、copy时传入age的操作都会触发IDE警告，引导开发者转向birthDay。
• 方案二：彻底移除age的存储，通过计算得到年龄，避免数据不一致（比如age和birthDay值不匹配），更符合你追求的健壮性。

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