Azure VM 上 Electron 应用在未 RDP 连接时窗口渲染异常
技术问小赵
结论
这个问题通常出在无人值守启动时,Windows 的虚拟显示或控制台会话仍停留在 1024x768;Electron 窗口尺寸设置本身一般不是原因。Electron/Chromium 会按当前桌面尺寸布局,所以即使代码把窗口设成 1920x1080 或最大化,也无法超过桌面分辨率,截图里就会出现部分渲染和空白区域。RDP 登录会触发显示模式切换,并且可能把 1920x1080 持久化下来,因此连过一次之后,后续运行看起来正常。不同资源组之间的差异,更可能来自 VM 映像、部署模板、自定义脚本、策略、显示驱动或默认分辨率配置不同。
原因分析
- 失败的 VM 在无 RDP 会话时,Hyper-V Video 报告的分辨率是 1024x768,应用和截图都会受这个桌面尺寸限制。
- AutoLogon 能让 Agent 以交互方式运行,但首次启动时显示初始化可能晚于测试启动,或者当时没有活动的控制台会话。
- RDP 会话建立后,系统会切换到 1920x1080,后续测试继续沿用了这个显示模式。
- 同一订阅下,不同 resource group 的 VM 可能使用不同的 image、vmSize、Custom Script Extension、Azure Policy、启动任务或显示驱动默认设置。
解决步骤
- 先对比两个 resource group 的 VM 配置:image、vmSize、extensions、policy、startup task、注册表显示设置和已安装驱动。重点确认失败 RG 是否统一采用低分辨率默认值,或者缺少设置分辨率的启动脚本。
- 在 AutoLogon 用户登录后、启动 Electron/Selenium 之前,将桌面分辨率设为 1920x1080,并等设置生效。不要只改应用窗口大小。
- 设置分辨率的脚本必须在交互式用户会话中运行。通过 Azure VM Run Command 或 Windows 服务运行,通常无法修改交互式桌面的分辨率;可以把脚本放进 Startup 文件夹,或创建触发条件为 At log on 的计划任务。
- pipeline 启动 VM 后,先轮询 Win32_VideoController 的分辨率,确认达到 1920x1080 再启动测试,避免测试在显示初始化完成前就开始执行。
- 如果问题仍然存在,再检查 DPI 缩放、Electron GPU 参数和 Selenium 截图方式;但仍应优先确认桌面分辨率。
代码示例
如果环境里已部署 QRes(第三方工具,需自行校验来源和许可),可在 AutoLogon 启动任务中执行:
& 'C:/Tools/QRes.exe' /x:1920 /y:1080
Start-Sleep -Seconds 2
Get-CimInstance Win32_VideoController |
Select-Object Name, CurrentHorizontalResolution, CurrentVerticalResolution
pipeline 启动测试前可等待分辨率就绪:
$deadline = (Get-Date).AddMinutes(5)
do {
$vc = Get-CimInstance Win32_VideoController | Select-Object -First 1
if ($vc.CurrentHorizontalResolution -eq 1920 -and $vc.CurrentVerticalResolution -eq 1080) { break }
Start-Sleep -Seconds 5
} while ((Get-Date) -lt $deadline)
if ($vc.CurrentHorizontalResolution -ne 1920 -or $vc.CurrentVerticalResolution -ne 1080) {
throw '显示分辨率未就绪'
}
如果不想引入 QRes,可以把 Win32 API 的 ChangeDisplaySettings 封装成 PowerShell 或小工具,在登录会话中调用。思路一样:设置 DM_PELSWIDTH/DM_PELSHEIGHT 后调用 ChangeDisplaySettings,再检查返回值和实际分辨率。
注意事项
- 只把 Electron 窗口设为 maximized 或设置 width/height,无法突破 1024x768 的桌面。
- 依赖先 RDP 一次再断开并不可靠;建议在启动阶段显式设置并校验分辨率。
- 如果两个 RG 的 VM 配置完全一致,表现却仍不同,可以继续检查 Azure Policy、自定义扩展、组策略、注册表显示模式缓存和 Hyper-V 显示驱动版本。
- 修改显示设置后,建议重启一次 VM,再做一次无 RDP 的全新启动验证,确认不是本次会话残留导致。
备注:内容仅供参考。
