KMP iOS构建报错：FirebaseMessaging符号重复定义问题求助

错误原因 #

链接阶段的重复符号错误，核心原因是KMPNotifier与GitLive Firebase Messaging的依赖冲突：

• KMPNotifier作为KMP推送通知库，内部已经集成了iOS端的FirebaseMessaging原生依赖，并生成了对应的Kotlin绑定符号。
• 你同时在commonMain中引入了GitLive的firebase-messaging库，该库同样会生成FirebaseMessaging的Kotlin绑定。
• 由于你的KMP框架设置为静态框架（isStatic = true），编译时会将所有依赖的符号打包到同一个框架中，两个库导出的相同符号（如knifunptr_cocoapods_FirebaseMessaging1_FIRMessagingErrorDomain_getter）就会触发重复定义错误。

修复步骤 #

1. 移除重复的GitLive Firebase Messaging依赖
   在commonMain的依赖中删除implementation(libs.gitlive.firebase.messaging)，因为KMPNotifier已经覆盖了Firebase Messaging的集成需求：

   sourceSets {
       commonMain.dependencies {
           // Firebase
           implementation(libs.gitlive.firebase.firestore)
           implementation(libs.gitlive.firebase.auth)
           // 移除下面这行重复依赖
           // implementation(libs.gitlive.firebase.messaging)
           
           // 其他依赖...
       }
     }
   

2. 清理构建缓存与iOS Pod依赖

   • 执行KMP项目清理：./gradlew clean
   • 进入iOS项目目录，删除Pods文件夹和Podfile.lock
   • 重新安装Pod依赖：pod install

3. 验证静态框架配置
   确保framework配置中的export(libs.kmp.notifier)保留，这会让KMP框架正确导出KMPNotifier的符号给iOS端调用：

   framework {
       baseName = "ComposeApp"
       isStatic = true
       export(libs.kmp.notifier)
   }
   

KMP集成Firebase Messaging的关键注意事项 #

• 避免重复封装库：如果使用KMPNotifier这类专门的推送库，不需要再单独引入GitLive或其他Firebase Messaging的KMP封装，否则极易引发符号冲突。
• 静态框架限制：静态框架会合并所有依赖的符号，因此必须严格控制同一原生库的KMP封装数量，只能保留一个。如果需要同时使用多个Firebase服务，确保它们的KMP封装依赖的原生Firebase版本完全一致。
• Podfile无需手动添加FirebaseMessaging：KMP的cocoapods插件会自动通过KMP库的配置引入对应的原生Pod，手动添加反而可能导致重复。
• 版本一致性：检查KMPNotifier和GitLive Firebase库的文档，确认它们依赖的原生Firebase版本是否匹配，版本差异也可能导致符号不兼容。

内容的提问来源于stack exchange，提问作者Mehdi.ncb