macOS下Java Swing按钮选中时背景为灰色而非蓝色问题排查

问题表现 #

JButton、JToggleButton组件在选中/按下状态下背景显示为灰色，与预期的系统默认蓝色效果不符。
JToggleButton异常效果如下：

已尝试的无效方案 #

• 手动设置背景色+开启不透明
  最初尝试通过如下代码修改按钮背景：

  button.setBackground(Color.BLUE);
  button.setOpaque(true);
  

  实际效果仅为按钮外围增加一圈窄蓝色边框，按钮主体背景未发生变化：
  
• 追加关闭边框绘制配置
  在上述代码基础上新增button.setBorderPainted(false);配置后，虽然边框被移除，但macOS原生按钮的视觉样式完全丢失，文本区域背景色异常变深：
  

初步排查结论 #

单独调用setBackground()无效果，推测是macOS专属Aqua外观下的AquaButtonBorder拦截了背景色修改逻辑。
已验证切换Look and Feel无法解决问题：分别测试UIManager.getSystemLookAndFeelClassName()（系统原生外观）、UIManager.getCrossPlatformLookAndFeelClassName()（跨平台金属外观）两种配置，问题均复现。

复现环境 #

• Java版本：Java 11、Java 17
• 硬件：M1芯片MacBook Pro
• 系统版本：macOS 12.4

可行解决方案 #

• 全局修改Aqua LAF配色（推荐，保留原生样式）
  macOS Aqua外观的按钮状态色由UIManager统一管理，直接修改对应配置项即可全局生效，不会破坏原生按钮的圆角、动效等视觉特性：

  // 配置需在Swing组件初始化前执行
  UIManager.put("ToggleButton.select", Color.BLUE); // JToggleButton选中色
  UIManager.put("Button.pressed", Color.BLUE); // JButton按下色
  
  // 如果组件已经初始化完成，调用以下方法刷新UI
  // SwingUtilities.updateComponentTreeUI(你的顶层窗口实例);
  

• 自定义ButtonUI（高自由度自定义场景）
  如果需要更灵活的样式调整，可以继承AquaButtonUI重写背景绘制逻辑，或直接使用BasicButtonUI完全接管按钮的全状态绘制。该方式自由度最高，但需要自行实现悬停、按下、选中、禁用等所有状态的视觉效果，开发成本较高。
• 替换第三方Look and Feel（跨平台一致场景）
  如果需要跨平台统一视觉表现，可以替换为FlatLaf、Darcula等成熟的第三方Swing外观库，这类库对组件自定义属性的支持更友好，不会出现Aqua LAF下背景色设置不生效的问题，在macOS下也能保持协调的视觉效果。

注意：不建议使用setOpaque(true)+setBorderPainted(false)的方式强行修改背景，该方案会完全破坏macOS原生按钮的交互与视觉特性，界面表现非常割裂。

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