Kotlin中ViewModel常量赋值失效：传入字符串常量变为空串

在Kotlin开发的Android应用中，ViewModel的setStateValue方法负责将传入值设置为状态，但调用时传入String类型常量（如ZERO_STRING），状态会被设为空字符串，而直接传入字面量"0"则正常工作。

相关代码 #

常量文件 #

ZERO_STRING = "0"
ITEM_QUANTITY_STRING = "ItemQuantity"

ViewModel代码 #

private val _shoppingListItemState = MutableLiveData(
    savedStateHandle.get<ShoppingListItem>("shoppinglistitem")
        ?: ShoppingListItem()
)

override val shoppingListItemState: LiveData<ShoppingListItem>
        get() = _shoppingListItemState

override fun setStateValue(stateToEdit: String, stateValue: Any?) {
   var itemToUpdate = _shoppingListItemState.value!!

   when(stateToEdit) {
       ITEM_QUANTITY_STRING -> itemToUpdate = itemToUpdate.copy(quantity = stateValue.toString())
   }
   _shoppingListItemState.value = itemToUpdate
}

调用示例 #

// 正常工作，quantity被设为"0"
setStateValue(ITEM_QUANTITY_STRING, "0")

// 失效，quantity被设为""而非"0"
setStateValue(ITEM_QUANTITY_STRING, ZERO_STRING)

问题原因 #

核心问题是**ZERO_STRING常量的实际值为空字符串**，而非预期的"0"，常见诱因包括：

• 常量声明不规范：缺少const val修饰符，用var声明时被其他代码意外修改；
• 局部变量覆盖：调用处存在同名局部变量ZERO_STRING，其值为空字符串；
• 初始化错误：声明时笔误写成ZERO_STRING = ""，或延迟初始化属性未完成初始化就被调用。

解决方案 #

1. 规范常量声明 #

确保常量以不可变方式声明，避免被意外修改：

// 顶层常量（全局可访问，推荐）
const val ZERO_STRING = "0"
const val ITEM_QUANTITY_STRING = "ItemQuantity"

// 或封装在object中
object Constants {
    const val ZERO_STRING = "0"
    const val ITEM_QUANTITY_STRING = "ItemQuantity"
}

2. 验证常量实际值 #

在调用setStateValue前打印ZERO_STRING的值，确认其为"0"：

Log.d("Debug", "ZERO_STRING value: '$ZERO_STRING'")
setStateValue(ITEM_QUANTITY_STRING, ZERO_STRING)

3. 优化ViewModel方法的类型安全性 #

将stateValue的类型从Any?改为具体的String?，避免不必要的类型转换，同时处理null情况：

override fun setStateValue(stateToEdit: String, stateValue: String?) {
    // 避免!!操作符，防止空指针异常
    val currentItem = _shoppingListItemState.value ?: ShoppingListItem()
    val updatedItem = when(stateToEdit) {
        ITEM_QUANTITY_STRING -> currentItem.copy(quantity = stateValue ?: "")
        else -> currentItem
    }
    _shoppingListItemState.value = updatedItem
}

4. 检查调用处的变量覆盖 #

确认调用时传入的是全局常量，而非局部同名变量：

// 错误示例：局部变量覆盖全局常量
fun updateQuantity() {
    val ZERO_STRING = "" // 此处局部变量会覆盖全局常量
    setStateValue(ITEM_QUANTITY_STRING, ZERO_STRING)
}

// 正确示例：直接使用全局常量
fun updateQuantity() {
    setStateValue(ITEM_QUANTITY_STRING, ZERO_STRING)
}

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