从全屏恢复时嵌套MigLayout布局超出边界的技术问题

问题背景 #

在Windows系统上运行Swing应用时，遇到窗口尺寸调整异常：将窗口最大化后恢复，主面板无法随窗口同步调整尺寸，会停留在全屏尺寸与当前窗口尺寸之间的中间状态，只有多次拖拽窗口边框强制调整后，才能恢复正常显示。

最小复现案例 #

JFrame mainWindow = new JFrame("TEST");
UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
mainWindow.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

JPanel outerPanel = new JPanel();
outerPanel.setLayout(new MigLayout("fill, insets 0", "[grow]", "[grow]"));

JPanel innerPanel = new JPanel();
innerPanel.setLayout(new MigLayout("fill, insets 10", "[75%:75%:100%]", "[grow]"));
JTextArea text = new JTextArea("text 1");
innerPanel.add(text, "cell 0 0, grow");

outerPanel.add(innerPanel, "cell 0 0, grow");

mainWindow.getContentPane().add(outerPanel);

mainWindow.pack();
mainWindow.setLocationRelativeTo(null);
mainWindow.setVisible(true);

现象分析 #

给text、innerPanel和outerPanel添加ComponentListener打印宽度变化后发现：

• outerPanel能正确跟随窗口调整尺寸
• innerPanel和text每次尺寸更新时，仅按与正确尺寸的差距比例缩小，无法一步到位

问题触发的关键条件：innerPanel的列最小尺寸约束（75%）在窗口最大化时的计算值，大于窗口恢复后的实际宽度。测试验证：

• 初始窗口宽度120px，最大化后2560px
• 最小尺寸设为1%（最大化时为25.6px）：无异常
• 最小尺寸设为5%（最大化时为128px）：出现异常

核心疑问 #

1. 为什么窗口恢复初始状态时尺寸无法正常调整，但多次增量拖拽边框后能收敛到正确值？
2. 如何让最小尺寸约束在窗口最大化和恢复时正常生效？

实际项目结构 #

问题出在嵌套的面板结构中，相关代码片段：

// RecordingListPanel
setLayout(new MigLayout("fill, insets 2", "[75%:75%:90%]2[10%::300]", "[][grow]"));

// tabbedPane
tabbedPane.add("Recordings", recordingListPanel);

// mainPanel
mainLayout = new CardLayout();
mainPanel.setLayout(mainLayout);
mainPanel.add(tabbedPane, "mainView");

// metaPanel
metaPanel.setLayout(new MigLayout("fill, insets 0 0 0 0", "[grow]", "[grow][30!]"));
metaPanel.add(mainPanel, "cell 0 0, grow");
mainFrame.getContentPane().add(metaPanel);

问题原因 #

MigLayout在处理百分比形式的最小尺寸约束时，会缓存上一次布局计算时的容器尺寸。当窗口从最大化恢复时，布局会基于最大化状态的容器尺寸计算最小宽度，而非当前恢复后的窗口实际宽度。这就导致最大化时算出的最小宽度（比如2560px的75%=1920px）远大于恢复后的窗口宽度（120px），此时布局会陷入“逐步收敛”循环——每次调整窗口时，MigLayout会尝试缩小一点，但受限于缓存的旧尺寸，无法一步到位，直到多次调整后缓存尺寸逐步趋近实际窗口尺寸。

解决方案 #

1. 修改布局约束，避免百分比最小尺寸的缓存问题 #

放弃直接使用基于当前容器尺寸的百分比最小约束，改用动态适配的约束类型：

// 方式1：用pref替代固定百分比最小，让布局优先适应父容器尺寸
innerPanel.setLayout(new MigLayout("fill, insets 10", "[pref:75%:100%]", "[grow]"));
// 方式2：设置固定最小宽度（根据实际需求调整数值）
innerPanel.setLayout(new MigLayout("fill, insets 10", "[50:75%:100%]", "[grow]"));

2. 窗口状态变化时强制刷新布局 #

给主窗口添加WindowStateListener，在窗口从最大化恢复时，强制触发布局重新计算，清除缓存的旧尺寸：

mainWindow.addWindowStateListener(new WindowStateListener() {
    @Override
    public void windowStateChanged(WindowEvent e) {
        if ((e.getOldState() & Frame.MAXIMIZED_BOTH) != 0 && 
            (e.getNewState() & Frame.MAXIMIZED_BOTH) == 0) {
            SwingUtilities.invokeLater(() -> {
                outerPanel.revalidate();
                outerPanel.repaint();
            });
        }
    }
});

针对实际项目的调整 #

将RecordingListPanel的列约束修改为动态适配类型，避免固定百分比的缓存问题：

setLayout(new MigLayout("fill, insets 2", "[pref:75%:90%]2[10%::300]", "[][grow]"));

同时给主窗口添加上述WindowStateListener，确保窗口状态变化时布局能及时刷新。

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