Java11环境下父窗口未聚焦时JComboBox首次鼠标点击不弹出菜单问题

根因说明 #

这个问题是JDK 9及以上版本Swing组件的默认焦点行为变更导致：JDK 9重写了JComboBox的弹出触发逻辑，新增了所属父容器焦点状态的校验，首次点击事件会被未获得焦点的JPanel拦截用于抢占焦点，不会派发给JComboBox的弹出回调，因此需要第二次点击才能触发下拉菜单展示。

排查步骤 #

• 先构建最小复现Demo：仅保留JDesktopPane、两个内嵌JPanel、每个面板放置一个原生JComboBox，排除业务代码自定义监听器的干扰，如果Demo可复现即可确认是JDK版本自带的行为变更。
• 检查JDesktopPane、JPanel上绑定的自定义FocusListener、MouseListener，确认是否有业务代码主动消费了第一次点击事件。

解决方案 #

方案1：给JComboBox绑定自定义鼠标监听器（推荐，副作用最小） #

对需要适配的JComboBox添加鼠标按压事件监听，强制点击时直接请求焦点并弹出下拉菜单，代码示例：

comboBox.addMouseListener(new MouseAdapter() {
    @Override
    public void mousePressed(MouseEvent e) {
        JComboBox<?> source = (JComboBox<?>) e.getSource();
        if (!source.hasFocus()) {
            source.requestFocusInWindow();
            source.showPopup();
        }
    }
});

方案2：禁用父JPanel的焦点属性 #

如果承载JComboBox的JPanel本身不需要响应焦点事件，直接设置jPanel.setFocusable(false)，父面板不会拦截点击事件抢占焦点，点击会直接派发到JComboBox触发弹出。

方案3：全局关闭JComboBox的焦点校验（不推荐） #

通过UIManager全局修改配置：UIManager.put("ComboBox.forceFocusOnPopup", false)，该配置会全局关闭所有JComboBox的弹出前焦点校验，可能引发其他未知的焦点冲突问题，仅适配全项目所有JComboBox都需要该行为的场景。

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