Swing中最大化窗口后位置异常为[-8,-8]的修复方案咨询

兄弟，我太懂你这种被Swing跨平台细节坑到的感觉了！在Java 8+Windows 10环境下，最大化JDialog后位置飘到[-8,-8]、侧边留明显间隙的问题，确实是Swing和Windows原生窗口交互时的一个典型bug，你猜的根源方向完全没错——就是JFrame和JDialog在原生对等体（Peer）实现上的补偿逻辑差异。

问题根源拆解 #

对于JFrame来说，Windows平台的Swing原生对等体（sun.awt.windows.WComponentPeer）会自动把[-8,-8]的位置映射成屏幕实际原点(0,0)，这是为了补偿Windows窗口的阴影/装饰边框偏移；但JDialog的对等体在执行pShow方法时，完全没有做这个补偿，真的把[-8,-8]当成了实际窗口位置，导致窗口和屏幕边缘之间出现8像素的间隙。

几种可行的修复方案 #

方案一：监听窗口状态，手动修正位置（推荐，无API风险）

给你的JDialog添加窗口状态改变监听器，等最大化操作完成后，强行把窗口位置和尺寸修正为屏幕的可用区域，这是最稳妥的方法：

dialog.addWindowStateListener(new WindowStateListener() {
    @Override
    public void windowStateChanged(WindowEvent e) {
        // 检测窗口是否被最大化
        if ((e.getNewState() & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH) {
            // 用invokeLater等原生层操作完成后再修正
            SwingUtilities.invokeLater(() -> {
                GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
                // 获取系统实际可用的屏幕边界（自动排除任务栏）
                Rectangle screenBounds = ge.getMaximumWindowBounds();
                dialog.setBounds(screenBounds);
            });
        }
    }
});

这个方法的好处是完全基于公开API，不会因为Java小版本更新失效，而且getMaximumWindowBounds能准确拿到排除任务栏的可用区域，比直接用Toolkit.getDefaultToolkit().getScreenSize更合理。

方案二：反射修改原生Peer的补偿逻辑（进阶，慎用）

如果方案一有轻微的闪烁或者延迟，你可以通过反射直接修改WComponentPeer的位置处理，但这依赖Sun的内部非公开API，只适合Java 8+Windows环境，升级Java版本后大概率失效：

// 仅在Windows+Java 8环境下执行
if (System.getProperty("os.name").contains("Windows") 
    && System.getProperty("java.version").startsWith("1.8")) {
    try {
        // 反射获取Dialog的Peer对象
        Field peerField = Window.class.getDeclaredField("peer");
        peerField.setAccessible(true);
        Object windowPeer = peerField.get(dialog);
        
        if (windowPeer.getClass().getName().equals("sun.awt.windows.WComponentPeer")) {
            // 调用Peer的setBounds方法，手动补偿位置偏移
            Method setBoundsMethod = windowPeer.getClass()
                .getDeclaredMethod("setBounds", int.class, int.class, int.class, int.class, boolean.class);
            setBoundsMethod.setAccessible(true);
            
            GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
            Rectangle screenBounds = ge.getMaximumWindowBounds();
            // 把位置设为(0,0)，尺寸设为屏幕可用大小
            setBoundsMethod.invoke(windowPeer, 0, 0, screenBounds.width, screenBounds.height, true);
        }
    } catch (NoSuchFieldException | IllegalAccessException | NoSuchMethodException | InvocationTargetException ex) {
        ex.printStackTrace();
    }
}

⚠️ 注意：这个方法属于“hack”级别的，仅在你必须追求原生最大化的无延迟体验时使用，上线前要做充分的版本兼容性测试。

方案三：用JFrame模拟Dialog（折中方案）

如果不想碰监听器或者反射，也可以用JFrame来模拟Dialog的行为：设置JFrame为模态（通过setModalExclusionType或者自定义玻璃面板），保留窗口装饰，这样最大化时会自动走JFrame的Peer补偿逻辑，不会出现[-8,-8]的问题。不过这种方法需要自己处理窗口的关闭和模态逻辑，适合对窗口行为有高度定制需求的场景。

额外注意事项 #

• 测试前先切换到Swing默认的Metal LookAndFeel，有些第三方LAF（比如FlatLaf、Nimbus）会自定义窗口装饰，可能影响位置修正逻辑
• 确保你的Dialog没有设置过自定义的insets或者边框，这些会和修正后的尺寸冲突

备注：内容来源于stack exchange，提问作者Cagepi