Kotlin：生成任意对象属性映射时出现协变错误的技术咨询

嘿，这个问题我之前在反射处理属性的时候也碰到过！咱们来拆解一下问题原因，然后给出可行的解决方案～

错误原因分析 #

你遇到的编译错误，核心问题出在memberProperties的类型上：this::class.memberProperties返回的是Collection<KProperty1<T, *>>，这里的*是out-projected（协变投影）类型。

Kotlin的类型系统认为，这种投影后的KProperty1<T, *>无法保证它的get方法接收的参数正好是T类型（虽然我们在逻辑上知道肯定是，但编译器认死理），所以直接调用property.get(this)会被禁止。

修复后的代码方案 #

我们可以通过安全的类型转换，加上Kotlin的associate函数来快速构建属性名到值的映射，同时让函数返回我们需要的Map<String, Any?>类型：

import kotlin.reflect.KProperty1
import kotlin.reflect.full.memberProperties

inline fun <reified T : Any> T.propertiesMap(): Map<String, Any?> {
    return this::class.memberProperties.associate { property ->
        // 处理私有/受保护属性（如果不需要访问私有属性可以去掉这行）
        property.isAccessible = true
        
        // 强制转换为明确的KProperty1<T, Any?>，我们确定属性属于T类，转换绝对安全
        @Suppress("UNCHECKED_CAST")
        val typedProperty = property as KProperty1<T, Any?>
        
        // 关联属性名和对应的值
        property.name to typedProperty.get(this)
    }
}

代码细节说明 #

• 类型转换：用@Suppress("UNCHECKED_CAST")告诉编译器我们明确知道这个转换是安全的——memberProperties里的所有属性都是T类的成员，它们的接收者类型必然是T，值类型用Any?可以覆盖所有可能的属性类型。
• associate函数：替代手动循环，更简洁地一键构建键值对映射。
• isAccessible设置：如果你的类包含私有或受保护的属性，这行代码能让反射突破访问限制；如果只需要处理公共属性，可以直接去掉这行。

使用示例 #

比如我们有一个包含私有属性的数据类：

data class User(val name: String, val age: Int, private val email: String)

fun main() {
    val user = User("Alice", 30, "alice@example.com")
    println(user.propertiesMap())
    // 输出结果：{name=Alice, age=30, email=alice@example.com}
}

这样就能完美生成对象的属性与值的映射啦～

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