Kotlin/JS项目无法解析'firebase/app'模块问题求助

可能的原因及对应解决方案 #

1. 对齐Firebase 9+的模块化导入语法 #

Firebase 9.x采用模块化API，不再支持旧版整体导入逻辑，需修正外部声明文件的导入方式：

• 错误示例：

  @JsModule("firebase/app")
  @JsNonModule
  external fun initializeApp(options: dynamic): dynamic
  

• 正确适配Firebase 9+的声明：

  @JsModule("firebase/app")
  @JsNonModule
  external val initializeApp: (options: dynamic) -> dynamic
  

  调用时保持语法匹配：

  val firebaseConfig = js("""{
    apiKey: "YOUR_API_KEY",
    authDomain: "YOUR_AUTH_DOMAIN",
    projectId: "YOUR_PROJECT_ID"
  }""")
  initializeApp(firebaseConfig)
  

2. 重新安装并校验npm依赖 #

执行以下命令清理缓存后重装依赖，解决安装异常或缓存导致的路径问题：

./gradlew clean npmInstall

3. 匹配Kotlin/JS的模块配置 #

在build.gradle.kts中确保浏览器目标的模块类型与Firebase兼容：

kotlin {
    js {
        browser {
            commonWebpackConfig {
                output.libraryTarget = "ESModule"
            }
        }
        binaries.executable()
    }
}

Firebase 9+默认使用ES模块，此配置可避免解析冲突。

4. 检查外部声明文件的有效性 #

• 确保.d.kt声明文件放在src/main/kotlin目录下，保证编译器能识别。
• 所有声明需严格对应Firebase 9.x的导出结构，避免混用旧版语法。

5. 尝试切换Firebase版本（临时方案） #

若上述方法无效，可切换到Firebase 9.x的其他稳定版本，比如9.22.0，更新依赖后重新构建：

implementation(npm("firebase", "9.22.0"))

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