Kotlin Multiplatform中expect/actual类命名与Room构建异常问题

问题根源 #

这个冲突的核心是Kotlin/JVM对顶层成员的编译规则差异：

• 当Kotlin文件中仅包含顶层函数/属性（无顶层类、对象、接口）时，编译器会将该文件编译为一个以文件名Kt命名的JVM类，所有顶层成员都归属这个类。
• 在KMP项目中，commonMain和desktopMain的代码最终会合并到desktop目标的编译产物中。如果两边同包同名的文件都只有顶层函数（比如你的Database.kt），就会生成两个完全同名的DatabaseKt类，触发JVM类名重复异常。

而你的Util.kt没有出现问题，是因为commonMain的文件里存在顶层Util对象——此时编译器会把common侧的顶层成员（包括该对象和expect函数）编译到UtilKt类中，desktopMain的actual函数会被合并到同一个UtilKt类里，不会生成重复类。

解决方法 #

有两种可行的解决方式：

1. 给平台侧文件添加平台后缀 #

这是你已经验证有效的方法，将desktopMain的Database.kt重命名为Database.jvm.kt（或Database.desktop.kt）。编译器会生成DatabaseJvmKt类，和common侧的DatabaseKt类名不重复，冲突自然消失。

2. 在commonMain的文件中添加顶层类/对象 #

在commonMain的Database.kt中添加一个空的顶层类或对象作为占位符，就能让编译器自动合并platform侧的actual函数到同一个类中：

expect fun createDatabaseBuilder(): RoomDatabase.Builder<Database>

// 空对象占位符，避免纯顶层函数导致的类重复
private object DatabaseMarker

这样desktopMain的Database.kt无需改名即可正常编译，因为common侧的DatabaseKt类包含了占位符对象，desktop的actual函数会被合并到该类中，不会生成新的类。

补充说明 #

这种冲突仅会在纯顶层函数的文件场景下出现，只要文件中存在顶层类、对象或接口，编译器就会自动处理合并逻辑，不会出现类名重复问题——这也是其他带顶层对象的Util.kt未触发异常的核心原因。

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