Android+Firebase云函数（kotlin2js）报错：Cannot read property 'iterator' of undefined

我之前也踩过类似Kotlin/JS+Firebase云函数的坑，结合你描述的场景，咱们一步步拆解问题和解决办法：

最可能的报错原因 #

1. Kotlin/JS与Firestore JS对象的映射不匹配 #

Firestore的DocumentSnapshot.data()返回的是原生JavaScript对象，如果Kotlin/JS的类没有正确配置序列化/反序列化，会导致你在Kotlin中访问的属性和JS对象实际存在的属性名不匹配，甚至无法将JS对象转换为Kotlin对象，最终迭代时抛出"未定义"错误。
比如：

• 你在Kotlin中定义的数据类是data class User(val userName: String)，但Android端上传时因序列化规则（比如Gson自动转蛇形命名），把属性名存成了user_name；
• 或者Kotlin/JS开启了代码混淆，编译后属性名被修改，导致运行时找不到对应属性。

2. Kotlin迭代语法的JS编译差异 #

Kotlin中的for (prop in obj)语法编译成JS后，行为可能和预期不符：

• 如果obj是Kotlin数据类实例，编译后会带有$metadata$等额外元数据属性，迭代时会遍历到这些非业务属性；
• 如果obj是Firestore返回的原生JS对象，Kotlin的in操作符在JS端可能会遍历原型链上的属性，导致访问到不存在的属性而报错。

3. 对象本身未正确初始化 #

可能你从Firestore获取数据时，data()返回了null，但没做空判断就直接迭代，导致后续访问属性时抛出"Cannot read properties of null/undefined"错误。

针对性解决办法 #

步骤1：配置Kotlin/JS与Firestore的数据映射（推荐用kotlinx.serialization） #

在云函数的build.gradle中添加序列化依赖，确保Kotlin类能和Firestore的JS对象正确互转：

plugins {
    kotlin("js") version "1.9.20"
    kotlin("plugin.serialization") version "1.9.20"
}

dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0")
    implementation("com.google.firebase:firebase-functions:20.3.0")
    implementation("com.google.firebase:firebase-firestore:24.10.0")
}

kotlin {
    js(IR) {
        browser()
        nodejs()
        binaries.executable()
    }
}

给你的Kotlin数据类添加@Serializable注解：

// index.kt
import kotlinx.serialization.Serializable

@Serializable
data class User(
    val userName: String,
    val age: Int
)

从Firestore获取数据时，用序列化工具把JS对象转换成Kotlin对象，再安全迭代属性：

// index.kt
import kotlinx.serialization.json.Json
import kotlin.js.JSON

fun handleUserRequest(event: functions.https.Request) {
    val firestore = FirebaseFirestore.getInstance()
    firestore.collection("users").document("userId").get()
        .then { snapshot ->
            val userJson = snapshot.data() ?: throw Error("User data is null")
            // 将JS对象转为Kotlin数据类
            val user = Json.decodeFromString<User>(JSON.stringify(userJson))
            // 遍历Kotlin对象的业务属性
            for ((key, value) in user::class.memberProperties.associate { it.name to it.get(user) }) {
                println("$key: $value")
            }
        }
        .catch { error ->
            console.error(error.message)
        }
}

步骤2：确保Android端与服务端的属性名一致 #

Android端上传数据时，要保证属性名和Kotlin/JS端的数据类完全匹配：

// MainActivity.kt
val user = hashMapOf(
    "userName" to "AdamZ", // 键名必须和Kotlin/JS端data class的属性名一致
    "age" to 30
)
Firebase.firestore.collection("users").document("userId").set(user)

如果Android端用数据类上传，建议统一用kotlinx.serialization序列化，避免自动转蛇形命名导致的不匹配。

步骤3：用JS原生方法遍历Firestore返回的对象 #

如果不想用序列化，直接用JS原生方法遍历Firestore返回的JS对象自身属性，避免Kotlin迭代语法的兼容问题：

// index.kt
fun handleUserRequest(event: functions.https.Request) {
    val firestore = FirebaseFirestore.getInstance()
    firestore.collection("users").document("userId").get()
        .then { snapshot ->
            val userData = snapshot.data() ?: run {
                console.error("No data found in document")
                return@then
            }
            // 用JS原生的Object.entries遍历键值对
            val entries = js("Object.entries(userData)") as Array<Array<Any>>
            entries.forEach { (key, value) ->
                println("$key: $value")
            }
        }
        .catch { error ->
            console.error(error.message)
        }
}

步骤4：强制做空判断 #

处理Firestore数据前，必须检查data()是否为null，避免后续操作触发未定义错误：

val snapshot = ... // 获取DocumentSnapshot
val userData = snapshot.data() ?: run {
    console.error("Document has no data or does not exist")
    return@then
}
// 再执行属性迭代操作

日志报错排查补充 #

如果以上方法还没解决，把Firebase云函数日志里的具体报错信息（比如是哪个属性未定义，还是对象本身undefined）整理出来，能更精准定位问题。比如日志显示Cannot read property 'userName' of undefined，大概率是userData本身为undefined，需要检查Firestore文档是否存在、查询路径是否正确。

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