FlatLaf在Windows 11上窗口顶部边框渲染异常问题解析

问题现象

在使用FlatLaf框架开发的Java Swing应用程序中，部分Windows 11用户会遇到窗口顶部边框出现异常黑色线条的渲染问题。该问题表现为：

1. 窗口顶部边框偶尔会出现1像素宽的黑色线条
2. 当设置窗口原生边框颜色时，该黑色线条会覆盖在原生边框之上
3. 问题在高DPI显示器上更容易复现
4. 问题出现时机与窗口大小、位置以及重叠状态相关

技术背景

FlatLaf是一个现代化的Java Swing外观框架，它通过JNI调用Windows原生API来实现窗口边框的自定义渲染。在Windows 11系统上，框架使用DWMWA相关API来控制窗口边框的视觉效果。

问题根源

经过深入分析，发现问题源于Windows 11系统与FlatLaf框架在窗口边框计算上的差异：

1. Windows 11对窗口标题栏区域的布局计算与Windows 10存在细微差别
2. FlatLaf原有的边框计算逻辑未完全适配Windows 11的新特性
3. 在高DPI环境下，系统缩放导致1像素的偏差被放大
4. 框架对WM_NCCALCSIZE消息的处理需要针对Windows 11进行特殊调整

解决方案

开发团队通过以下技术手段解决了该问题：

1. 引入DWMWA_VISIBLE_FRAME_BORDER_THICKNESS属性获取系统边框厚度
2. 根据当前系统缩放比例动态调整顶部边框计算值
3. 仅针对Windows 11及以上系统应用特殊处理逻辑
4. 保持对Windows 10系统的兼容性

具体实现中，框架现在会：

• 在100%和125%缩放时添加1像素
• 在150%到225%缩放时添加2像素
• 在250%和300%缩放时添加3像素
• 在350%缩放时添加4像素

验证结果

该修复方案已在多个Windows 11 23H2系统上验证通过，测试覆盖了100%到200%的各种DPI缩放比例。验证内容包括：

• 普通窗口状态下的边框渲染
• 窗口最大化状态
• 多窗口重叠场景
• 菜单操作等交互场景

技术启示

该问题的解决过程为我们提供了以下经验：

1. 现代UI框架需要针对不同Windows版本进行差异化处理
2. 高DPI环境下的像素级精度控制至关重要
3. 系统原生API的细微变化可能导致UI渲染异常
4. 通过JNA进行快速原型验证是高效的问题排查方法

该修复已包含在FlatLaf 3.5-SNAPSHOT版本中，为Windows 11用户提供了更完美的视觉体验。