JSF h:selectManyListbox开启noSelectionOption报Value is not valid错误

问题原因 #

• 这是h:selectManyListbox的预期行为，不是配置bug。noSelectionOption属性仅在h:selectOneXxx系列单选组件中会被特殊处理：选中该选项时会跳过可选值匹配校验。但多选组件的逻辑是所有提交的选中值必须存在于你定义的f:selectItems可选值集合中，你单独加的null值无选择项不在availableItems导出的可选值里，所以校验失败抛出「Value is not valid」错误。
• 你之前用OmniFaces SelectItemsConverter不生效的原因是你当前配置中itemValue绑定的是entry.id（String类型），而非BaseDTO对象，转换器针对POJO的转换逻辑完全没有触发场景。

可行解决方案 #

方案1：替换null为特殊标记值（最稳定） #

用不会和业务ID冲突的特殊字符串代替null作为无选择项的值，后端接收时做兼容处理：

1. 修改XHTML中的无选择项配置：

<f:selectItem itemValue="___NO_SELECTION_MARKER___" itemLabel="--" noSelectionOption="true" />

2. 调整Bean中selectedItems的setter逻辑：

public void setSelectedItems(String[] selectedItems) {
    // 仅选中无选择项时清空选中值
    if (selectedItems != null && selectedItems.length == 1 && "___NO_SELECTION_MARKER___".equals(selectedItems[0])) {
        this.selectedItems = null;
    } else {
        // 过滤掉可能误选的无选择标记（配合多选场景）
        this.selectedItems = Arrays.stream(selectedItems)
            .filter(item -> !"___NO_SELECTION_MARKER___".equals(item))
            .toArray(String[]::new);
    }
}

方案2：绑定POJO对象而非ID（更符合JSF设计规范） #

直接将选中值绑定为BaseDTO集合，配合转换器使用，此时noSelectionOption的null值会被正常识别：

1. 修改Bean中的属性类型：

private List<BaseDTO> selectedItems;
// 对应getter、setter改为List<BaseDTO>类型

2. 修改XHTML配置，加上OmniFaces转换器：

<h:selectManyListbox value="#{myBean.selectedItems}" hideNoSelectionOption="false" size="4" converter="omnifaces.SelectItemsConverter">
    <f:selectItem itemValue="#{null}" itemLabel="--" noSelectionOption="true" />
    <f:selectItems value="#{myBean.availableItems}" var="entry" itemValue="#{entry}" itemLabel="#{entry.description}" />
</h:selectManyListbox>

方案3：保留null值，禁用默认可选值校验 #

如果一定要用null作为无选择项的值，可以手动关闭组件的可选值匹配校验，自己实现校验逻辑：
给h:selectManyListbox添加属性validator="#{null}"即可跳过默认的可选值校验，后续可根据业务需要自行添加自定义校验逻辑。

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