Java Swing实现三级JComboBox级联选择及空指针异常修复

问题根因 #

空指针完全是代码逻辑疏漏+判断写反导致的，核心触发点如下：

• 未考虑removeAllItems()的副作用：调用该方法清空下拉框选项时，Swing会立刻触发下拉框绑定的ActionEvent，此时下拉框内无有效选项，getSelectedItem()直接返回null，代码里直接链式调用.toString()就会抛出空指针。
• 二级下拉框事件方法存在低级逻辑错误：kategoriComboBoxActionPerformed中判断if(kategoriComboBox.getSelectedItem()==null)成立时，反而执行kategoriComboBox.getSelectedItem().toString()，这个分支只要触发必抛空指针。
• 清空下级下拉框的判断条件写反：现有逻辑是if(kategoriComboBox.getSelectedItem()!=null)才执行removeAllItems()，如果当前下拉框选中项已经是null，旧选项根本无法清空，会出现数据残留。
• 填充下拉框时未临时屏蔽事件监听，每添加一个选项就会触发一次ActionEvent，产生大量无效逻辑执行，甚至可能触发事件循环。

修复方案 #

1. 所有调用getSelectedItem()的位置先做非空判断，再调用toString()；判断常量相等时直接把getSelectedItem()传入equals方法（"常量".equals(null)会直接返回false，不会抛异常）。
2. 修正null分支逻辑：选中项为null时直接退出事件处理，不要执行任何取值操作。
3. 清空/填充下级下拉框前临时注销事件监听器，操作完成后再重新注册，避免中间过程触发无效事件。
4. 上级选项变更时，先清空所有下级下拉框的旧数据，再填充直接下级的对应选项，避免旧数据残留。

修复后参考代码 #

一级下拉框（dimensiComboBox）事件处理 #

private void dimensiComboBoxActionPerformed(java.awt.event.ActionEvent evt) {
    // 先取选中项做非空判断，避免直接toString触发空指针
    Object selectedDimensi = dimensiComboBox.getSelectedItem();
    if (selectedDimensi == null) {
        return;
    }
    String dimensiName = selectedDimensi.toString();

    // 临时移除下级下拉框的监听器，避免清空/填充时触发无效事件
    kategoriComboBox.removeActionListener(this::kategoriComboBoxActionPerformed);
    subKategoriComboBox.removeActionListener(this::subKategoriComboBoxActionPerformed);
    try {
        // 直接清空所有下级下拉框，不需要判断选中项是否为空
        kategoriComboBox.removeAllItems();
        subKategoriComboBox.removeAllItems();
        // 匹配选中项填充二级下拉框
        if ("Kepemimpinan".equals(dimensiName)
                || "Kompetensi Individu".equals(dimensiName)
                || "Jiwa Sosial".equals(dimensiName)
                || "Pengembangan Minat dan Kreativitas".equals(dimensiName)) {
            isiMatkul(dimensiName);
        }
    } finally {
        // 操作完成后重新注册监听器，用finally保证异常时监听器也能恢复
        kategoriComboBox.addActionListener(this::kategoriComboBoxActionPerformed);
        subKategoriComboBox.addActionListener(this::subKategoriComboBoxActionPerformed);
    }
}

二级下拉框（kategoriComboBox）事件处理 #

private void kategoriComboBoxActionPerformed(java.awt.event.ActionEvent evt) {
    Object selectedKategori = kategoriComboBox.getSelectedItem();
    // 选中项为空直接返回，修正原来写反的null分支逻辑
    if (selectedKategori == null) {
        return;
    }
    String kategoriName = selectedKategori.toString();

    // 临时移除三级下拉框监听器
    subKategoriComboBox.removeActionListener(this::subKategoriComboBoxActionPerformed);
    try {
        subKategoriComboBox.removeAllItems();
        // 匹配选中项填充三级下拉框，原有判断条件补全即可
        if ("Pendidikan".equals(kategoriName)
                || "Ormawa".equals(kategoriName)
                || "Pelaksana Organisasi".equals(kategoriName)
                || "Narasumber".equals(kategoriName)
                || "Prestasi".equals(kategoriName)
                || "Juara Kompetisi".equals(kategoriName)
                || "Peserta Kompetisi".equals(kategoriName)
                || "Olimpiade Perguruan Tinggi Kedinasan".equals(kategoriName)
                || "Kompetisi Internal STIS".equals(kategoriName)
                || "Putra-Putri STIS".equals(kategoriName)
                || "Penulis Buku".equals(kategoriName)
                || "Jurnal Ilmiah".equals(kategoriName)
                || "Menjadi Pembicara/Pelatih".equals(kategoriName)
                || "Panitia Kegiatan Sosial".equals(kategoriName)
                || "Relawan Kegiatan Sosial".equals(kategoriName)
                || "Pelatihan dan Pengabdian Masyarakat".equals(kategoriName)
                || "Kegiatan Sosial Lainnya".equals(kategoriName)
                || "Peserta Seminar".equals(kategoriName)
                || "Keanggotaan UKM/Bidang/Divisi".equals(kategoriName)
                || "Peserta Kegiatan Terbuka UKM/SEMA".equals(kategoriName)) {
            isiSubKategori(kategoriName);
        }
    } finally {
        subKategoriComboBox.addActionListener(this::subKategoriComboBoxActionPerformed);
    }
}

优化建议 #

• 可以给每个下拉框默认添加「请选择」的占位选项，避免初始化阶段选中项为null的问题。
• 如果上下级选项映射关系固定，可以用Map<String, List<String>>存储对应关系，替代冗长的if-else分支，降低维护成本。
• 如果不想频繁注册/注销监听器，可以加一个布尔类型的标志位isUpdating，清空/填充选项时将标志位设为true，事件方法开头判断标志位为true时直接返回，填充完成后再将标志位改回false，效果一致。

内容的提问来源于stack exchange，提问作者Alwan Rahmana Subian