Firebase Android 如何校验同名节点，禁止添加重复Programme子节点

问题现象 #

开发者的预期实现逻辑：向实时数据库路径Admin/{当前登录用户UID}/INSTITUTE/STUDENTS下新增Programme类型子节点。新增前读取该路径下所有已有子节点的键值，校验用户输入的Programme名称是否与已有键值重名：存在重名则弹出匹配提示拦截操作，无重名则执行节点写入操作。
当前代码的实际运行效果完全偏离预期：

• 读取到已有节点列表后，逐一遍历比对时，每完成单个节点的比对就立刻弹出一次结果提示
• 典型异常场景：当数据库已存在bps、cs、mm三个Programme节点时，用户输入bps做校验，程序会依次弹出“匹配”“不匹配”“不匹配”三次提示，无法准确判断重名状态
• 由于新增逻辑被写在单次比对的不匹配分支下，遍历过程中会多次触发重复写入操作

现有实现的核心问题 #

1. 循环逻辑错位：将结果弹窗、操作判断逻辑全部放在单次循环体内部，没有等待全量节点遍历完成、得出全局判断结果后再执行后续动作，导致循环每迭代一次就触发一次弹窗/写入操作
2. 临时列表数据堆积：作为临时存储的pgName字符串列表没有在每次监听回调触发时清空原有数据，加上使用了持续监听的addValueEventListener，每次数据库变动触发回调时，都会把所有已有节点键值重复追加到列表中，长期运行后列表会堆积大量重复冗余数据，进一步干扰比对结果
3. 缺少全局状态标记：没有用统一的布尔变量记录“是否存在重名”的最终结论，而是把单次循环的局部比对结果直接作为全局操作的判断依据

修复方案 #

核心改造点 #

• 取消不必要的临时列表存储，在遍历快照的过程中直接完成键值比对，用布尔标记位记录最终的重名判断结果
• 改用单次读取的addListenerForSingleValueEvent替代持续监听的事件，避免页面停留期间数据库变动触发重复回调
• 全量遍历完成后，根据标记位的最终值统一弹出一次提示，再决定是否执行新增写入操作，避免循环内多次触发操作

修复后参考代码 #

// 获取输入框文本并做标准化处理（去除空格、统一小写，避免大小写差异导致的判断失效）
String prnamez = programmeName.getEditableText().toString().trim().toLowerCase();
FirebaseAuth autha = FirebaseAuth.getInstance();
DatabaseReference targetRef = FirebaseDatabase.getInstance()
        .getReference("Admin").child(autha.getUid()).child("INSTITUTE")
        .child("STUDENTS");

// 单次读取节点数据，完成校验与写入
targetRef.addListenerForSingleValueEvent(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        progressBar.setVisibility(View.VISIBLE);
        // 默认状态为无重名
        boolean isNameExist = false;
        // 遍历所有已有子节点做比对
        for (DataSnapshot childNode : snapshot.getChildren()) {
            String existKey = childNode.getKey().toString().toLowerCase();
            // 发现匹配项时直接修改标记位，跳出循环，无需继续遍历剩余节点
            if (existKey.equals(prnamez)) {
                isNameExist = true;
                break;
            }
        }
        // 全量遍历完成后统一判断结果，仅弹一次提示
        if (isNameExist) {
            StyleableToast.makeText(Programme_students.this,
                    "Matches", R.style.exampleToast).show();
        } else {
            StyleableToast.makeText(Programme_students.this,
                    "not Matches", R.style.exampleToast).show();
            // 无重名时执行新增节点的写入操作
            targetRef.child(prnamez).setValue("对应节点存储的内容");
        }
        progressBar.setVisibility(View.GONE);
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        progressBar.setVisibility(View.GONE);
    }
});

优化提示 #

• 原代码中用于存储键值的pgName列表没有实际存在的必要，遍历DataSnapshot的过程中即可直接完成比对，可减少不必要的内存开销
• 所有键值比对前统一做小写转换，避免因为大小写输入差异导致的重名判断失效
• 所有分支执行完成后记得隐藏加载进度条，避免页面卡在加载状态

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