从Java8迁移至Java17后Swing组件渲染异常问题求助

问题场景 #

当显示器分辨率为1920×1200、系统缩放比例设为150%时，同一Swing代码在Java 8中渲染正常，但在Java 17中出现文本截断、组件重叠问题。

验证代码：

public class Swing {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
        JPanel mainPanel = new JPanel();
        mainPanel.setLayout(new BorderLayout());
        JPanel panel1 = new JPanel();
        JPanel panel2 = new JPanel();

        panel1.setBorder(BorderFactory.createEmptyBorder(3,3,3,3));
        panel1.setLayout(new BorderLayout());
        JTextField f1 = new JTextField(30);
        panel1.add(f1, BorderLayout.WEST);
        JButton button1 = new JButton("OK");
        panel1.add(button1, BorderLayout.EAST);

        panel2.setBorder(BorderFactory.createEmptyBorder(3,3,3,3));
        panel2.setLayout(new BorderLayout());
        JTextField f2 = new JTextField(30);
        panel2.add(f2,BorderLayout.WEST);
        JButton button2 = new JButton("Cancel");
        panel2.add(button2,BorderLayout.EAST);

        mainPanel.add(panel1,BorderLayout.NORTH);
        mainPanel.add(panel2,BorderLayout.SOUTH);
        
        JDialog dialog = new JDialog();
        dialog.setContentPane(mainPanel);
        dialog.setDefaultCloseOperation(JDialog.DISPOSE_ON_CLOSE);
        dialog.pack();
        dialog.setVisible(true);
    
    }   
    );
}
}

解决方案 #

1. 调整VM启动参数适配高DPI #

Java 9+对高DPI缩放的默认逻辑做了变更，添加以下VM参数可恢复Java 8风格的缩放行为：

• 强制指定缩放比例匹配系统设置：

  -Dsun.java2d.uiScale=1.5
  

• 禁用Java的DPI感知，交由系统处理：

  -Dsun.java2d.dpiaware=false
  

• 启用系统原生LookAndFeel并开启UI缩放：

  -Dswing.defaultlaf=com.sun.java.swing.plaf.windows.WindowsLookAndFeel
  -Dsun.java2d.uiScaleEnabled=true
  

2. 代码层面优化布局 #

避免依赖BorderLayout的自动拉伸逻辑，给组件设置明确的尺寸约束，或改用更灵活的布局管理器：

• 给文本框设置最小尺寸：

  JTextField f1 = new JTextField(30);
  f1.setMinimumSize(new Dimension(200, f1.getPreferredSize().height));
  

• 改用GridBagLayout精确控制组件间距和大小，示例：

  panel1.setLayout(new GridBagLayout());
  GridBagConstraints gbc = new GridBagConstraints();
  gbc.fill = GridBagConstraints.HORIZONTAL;
  gbc.weightx = 1.0;
  gbc.insets = new Insets(3,3,3,3);
  panel1.add(f1, gbc);
  
  gbc.weightx = 0.0;
  panel1.add(button1, gbc);
  

3. 升级Java 17到最新小版本 #

Java 17后续的更新（如17.0.5及以上）修复了部分高DPI场景下的Swing布局bug，升级到最新LTS补丁版本可能直接解决问题。

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