Kotlin中如何确保DTO映射时类属性同步不遗漏？

先看初始代码：
两个带默认参数的类：

class Foo(
    val baz: Boolean = false,
)

class Bar(
    val baz: Boolean = false,
)

以及从Foo到Bar的映射扩展函数：

fun Foo.toBar() = Bar(
    baz,
)

当给Bar新增带默认值的属性后，如下代码可以正常编译且通过现有测试，但Foo遗漏了对应的属性，导致映射不完整：

class Foo(
    val baz: Boolean = false,
)

class Bar(
    val baz: Boolean = false,
    val newProp: Boolean = false,
)

fun Foo.toBar() = Bar(
    baz,
)

补充说明：此场景为DTO映射，源类与目标类的属性类型不一定相同。添加测试仅能防止属性被意外删除，无法避免新增属性时的遗漏，因为修改测试和修改源类都需要手动记忆。

可行解决方案 #

1. 移除目标类构造参数的默认值（强制编译期报错） #

如果业务允许，把Bar构造函数的参数默认值去掉：

class Bar(
    val baz: Boolean,
    val newProp: Boolean,
)

这样当你给Bar新增newProp后，toBar()函数会直接编译报错，提示缺少newProp参数。此时你会立刻意识到需要给Foo添加对应属性，或者在映射时明确处理这个参数（比如指定默认值或者从其他地方获取）。

如果业务确实需要默认值，可以把默认值逻辑移到类内部，比如：

class Bar(
    val baz: Boolean,
    val newProp: Boolean,
) {
    constructor(baz: Boolean) : this(baz, false)
}

这样既保留了便捷的构造方式，又能在新增属性时触发编译报错。

2. 使用编译期映射库（如MapStruct） #

用MapStruct这类专门的映射库来替代手动写toBar()扩展函数。MapStruct会在编译时生成映射代码，并且如果目标类有未被映射的属性，会直接抛出编译错误。

示例配置（Kotlin环境）：

• 引入MapStruct依赖后，定义映射接口：

@Mapper
interface FooBarMapper {
    fun fooToBar(foo: Foo): Bar
}

当Bar新增newProp但Foo没有对应属性时，编译阶段就会报错，提示newProp未被映射，强制你处理这个属性（要么给Foo加对应属性，要么在映射接口里指定默认值或自定义映射逻辑）。

3. 自定义编译期检查 #

如果你不想引入第三方库，可以写一个简单的Kotlin注解处理器，检查toBar()函数是否覆盖了Bar构造函数的所有参数。核心逻辑是：

• 扫描所有带有自定义注解的映射函数（比如@MapTo(Bar::class)）
• 解析目标类Bar的构造参数
• 对比映射函数中传入的参数，找出未被处理的参数
• 如果存在未处理的参数，抛出编译错误

这种方式更灵活，完全适配你的业务场景，但需要额外编写注解处理器代码。

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