Kotlin内联值类在Java调用时出现找不到符号等编译问题

问题根源 #

1. 值类对Java的不可见性：@JvmInline标记的值类在编译时会被Kotlin内联为底层类型（此处为String），生成的ItemId类是合成（synthetic）类，仅对Kotlin代码可见。Java编译器无法识别该类型，因此调用Item.getId()时会因找不到返回类型符号报错。
2. Data Class构造函数限制：Item的构造函数参数为ItemId?，Kotlin生成的对应Java构造函数接受ItemId类型参数，但由于ItemId对Java不可见，且底层接受String的构造函数被标记为私有，导致Java无法直接调用Item的构造函数。

解决方法 #

方法1：为Item添加Java友好的构造函数与访问方法 #

修改Item类，提供直接操作String类型的构造函数和访问方法，绕过ItemId对Java的不可见性：

data class Item(
    var id: ItemId? = null
) {
    // 给Java提供的重载构造函数，直接接受String参数
    @JvmOverloads
    constructor(id: String?) : this(id?.let { ItemId(it) })

    // 返回id的底层String值，供Java调用
    fun getIdValue(): String? = id?.value

    // 可选：重命名getter，让Java调用`getId()`时直接返回String
    @JvmName("getId")
    fun getIdForJava(): String? = id?.value
}

Java侧使用示例：

// 创建Item实例
Item item = new Item("item-123");
// 获取id值
String id = item.getIdValue();
// 或使用重命名后的方法
String idAlt = item.getId();

方法2：为ItemId添加可见的工厂方法（不推荐直接在Java中使用ItemId） #

若需要在Java中显式创建ItemId实例，可给ItemId添加静态工厂方法，同时确保Item的构造函数对Java可见：

@JvmInline
value class ItemId(val value: String) {
    companion object {
        @JvmStatic
        fun of(value: String): ItemId = ItemId(value)
    }
}

data class Item @JvmOverloads constructor(
    var id: ItemId? = null
)

Java侧使用示例：

ItemId itemId = ItemId.of("item-123");
Item item = new Item(itemId);
// 仍需通过getIdValue()获取String值，直接调用getId()会因Java无法识别ItemId报错
String id = item.getIdValue();

方法3：用@JvmField直接暴露底层字段 #

若无需严格封装，可将id字段标记为@JvmField，让Java直接访问底层的String值：

data class Item(
    @JvmField var id: ItemId? = null
)

Java侧直接访问：

Item item = new Item();
item.id = "item-123";
String id = item.id;

注意事项 #

JVM值类是Kotlin特有的轻量级类型安全特性，Java本身不支持内联类型，因此跨语言调用时必须通过桥接API处理类型转换，优先推荐方法1，既能保留Kotlin侧的类型安全，又能让Java代码友好调用。

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