PAYATHON 2026

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、启动任务或显示驱动默认设置。

解决步骤

  1. 先对比两个 resource group 的 VM 配置:image、vmSize、extensions、policy、startup task、注册表显示设置和已安装驱动。重点确认失败 RG 是否统一采用低分辨率默认值,或者缺少设置分辨率的启动脚本。
  2. 在 AutoLogon 用户登录后、启动 Electron/Selenium 之前,将桌面分辨率设为 1920x1080,并等设置生效。不要只改应用窗口大小。
  3. 设置分辨率的脚本必须在交互式用户会话中运行。通过 Azure VM Run Command 或 Windows 服务运行,通常无法修改交互式桌面的分辨率;可以把脚本放进 Startup 文件夹,或创建触发条件为 At log on 的计划任务。
  4. pipeline 启动 VM 后,先轮询 Win32_VideoController 的分辨率,确认达到 1920x1080 再启动测试,避免测试在显示初始化完成前就开始执行。
  5. 如果问题仍然存在,再检查 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 的全新启动验证,确认不是本次会话残留导致。

备注:内容仅供参考。