Firestore多字段orderBy排序实现及列表不显示问题排查

需要实现列表三级升序排序，规则如下：

• 第一优先级：按menuCategory字段升序排列，字段固定取值为food、drink
• 第二优先级：按menuName字段升序排列
• 第三优先级：按menuPrice字段从最低价到最高价排序

原有实现代码运行后列表无法正常显示，原代码如下：

when {
    userId != null -> {
        firebaseFirestore.collection("outlets").document(outletId)
            .collection("menu")
            .orderBy("menuCategory")
            .orderBy("menuName")
            .orderBy("menuPrice", Query.Direction.ASCENDING).get()
            .apply {
                addOnSuccessListener { querySnapshot ->
                    for (document in querySnapshot) {
                        document.apply {
                            menuList.add(
                                Menu(
                                    getString("menuCategory"),
                                    getString("menuPhoto"),
                                    getString("menuName"),
                                    getString("menuDescription"),
                                    getString("menuPrice")
                                )
                            )
                        }
                    }

                    adapter = menuOutletDetailAdapter
                    menuOutletDetailAdapter.notifyDataSetChanged()
                }
            }
        }
    }

原有代码存在4个核心问题，导致排序不生效、列表不显示：

1. 字段类型错误：menuPrice是数值类字段，代码中用getString()读取，说明字段大概率被存为字符串类型，字符串按字典序排序时"12"会排在"2"前面，价格排序完全失效。
2. 缺少复合索引：Firestore多字段组合排序需要创建对应的复合索引，未创建索引的查询会直接失败，无法返回数据。
3. 旧数据未清空：查询成功后直接往menuList中追加数据，如果列表之前加载过其他数据，会出现重复、乱序问题。
4. Adapter初始化时机错误：在数据回调里才给adapter赋值，第一次加载时RecyclerView没有绑定adapter，根本无法渲染列表，且代码未加查询失败监听，出错后无任何提示。

另外默认字典序下"drink" < "food"，刚好符合当前要求的category排序规则，如果后续需要调整分类优先级（比如food排在drink前面），需要给菜单文档加categorySortWeight权重字段，给对应分类设置数字权重后按权重排序即可。

when {
    userId != null -> {
        // 提前初始化adapter并绑定给RecyclerView，不要在数据回调里赋值
        if (adapter == null) {
            adapter = MenuOutletDetailAdapter(menuList)
            recyclerView.adapter = adapter
        }

        firebaseFirestore.collection("outlets").document(outletId)
            .collection("menu")
            .orderBy("menuCategory", Query.Direction.ASCENDING)
            .orderBy("menuName", Query.Direction.ASCENDING)
            .orderBy("menuPrice", Query.Direction.ASCENDING)
            .get()
            .addOnSuccessListener { querySnapshot ->
                // 先清空旧数据，避免重复
                menuList.clear()
                for (document in querySnapshot) {
                    menuList.add(
                        Menu(
                            document.getString("menuCategory"),
                            document.getString("menuPhoto"),
                            document.getString("menuName"),
                            document.getString("menuDescription"),
                            // 注意：Firestore中menuPrice必须存为Number类型，按数值读取后再根据Menu类参数类型转换
                            document.getDouble("menuPrice").toString()
                        )
                    )
                }
                // 通知adapter刷新列表
                adapter?.notifyDataSetChanged()
            }
            .addOnFailureListener { e ->
                // 打印错误日志，方便排查问题
                e.printStackTrace()
            }
    }
}

• 运行代码后如果日志提示缺少复合索引，按照日志指引完成复合索引创建，等待索引生效后查询即可正常返回排序后的数据。
• 检查Firestore中存储的菜单文档，确保menuPrice字段是数字类型，不要存成字符串，否则价格排序逻辑永远错误。

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