解决FlaUI自动化测试在无图形会话环境下的失败问题

背景介绍

FlaUI是一个基于微软UI自动化技术的测试框架，广泛应用于Windows桌面应用程序的自动化测试。在实际使用过程中，特别是在持续集成/持续部署(CI/CD)环境中，测试工程师经常会遇到一个棘手问题：当测试运行在没有图形会话的环境中时，FlaUI测试会失败。

问题现象

当FlaUI测试在以下环境中运行时，会出现各种错误：

• 自动化测试流水线中的自动化测试
• 通过远程连接后断开连接的服务器
• 服务器重启后未登录的会话

常见的错误信息包括：

• "No process is associated with this object"（没有进程与此对象关联）
• "Object reference not set to an instance of an object"（对象引用未设置为对象的实例）
• "Process with an Id of [number] is not running"（指定ID的进程未运行）

问题根源

FlaUI框架需要有效的图形用户界面(GUI)会话来执行自动化测试。这与许多基于控制台的测试框架不同，GUI测试框架需要：

1. 一个活动的桌面会话
2. 正确的会话状态（不能是断开或锁定状态）
3. 足够的权限访问UI元素

在自动化测试流水线等CI/CD环境中，默认情况下运行代理是以非交互式服务账户运行的，这会导致FlaUI无法访问必要的UI组件。

解决方案

基础配置

首先，确保运行代理以"交互式进程"方式运行，并启用自动登录：

1. 配置代理以交互式用户身份运行
2. 启用自动登录功能
3. 确保代理账户有足够的权限

高级解决方案：会话重连

仅配置交互式代理有时还不够，因为以下情况仍会导致会话被锁定：

• 远程断开连接
• 会话超时
• 服务器重启后未登录

为了解决这个问题，可以在运行FlaUI测试前执行一个PowerShell脚本，该脚本会：

1. 检查当前用户的所有会话
2. 识别处于"断开"状态的会话
3. 将这些会话重新连接到控制台

以下是实现这一功能的PowerShell脚本核心逻辑：

$user = $env:USERNAME
Write-Host "Running as user: $user"
foreach ($line in (quser 2>&1)) {
    $clean = $line.TrimStart('>',' ').Trim()
    if ($clean -match "^(?:\S+\\)?$user\b") {
        $tokens = ($clean -split '\s+') | Where-Object { $_ -ne '' }
        $sessionId = $tokens | Where-Object { $_ -match '^\d+$' } | Select-Object -First 1
        $state = $tokens | Where-Object { $_ -match '^(Active|Disc|Connect|Listen|Reset|Down|Idle)$' } | Select-Object -First 1
        if ($sessionId) {
            if ($state -eq 'Disc') {
                Write-Host "Found disconnected session ID $sessionId for $user; reattaching..."
                try {
                    tscon $sessionId /dest:console
                    Write-Host "  tscon succeeded for session $sessionId."
                } catch {
                    $msg = $_.Exception.Message
                    Write-Warning ("  tscon failed for session {0}: {1}" -f $sessionId, $msg)
                }
            }
        }
    }
}

实现细节

脚本解析

1. 用户识别：脚本首先获取当前运行用户的用户名
2. 会话查询：使用quser命令获取当前所有用户会话信息
3. 会话过滤：通过正则表达式匹配当前用户的会话
4. 状态检查：识别会话状态，特别是"Disc"（断开）状态
5. 会话重连：使用tscon命令将断开连接的会话重新连接到控制台

在自动化测试流水线中的集成

将上述脚本作为流水线中的一个步骤，在运行FlaUI测试前执行：

- task: PowerShell@2
  displayName: 'Reattach only disconnected sessions to console'
  inputs:
    targetType: 'inline'
    script: |
      # 上述PowerShell脚本内容

注意事项

1. 权限要求：执行此脚本的账户需要有足够的权限来操作会话
2. 环境差异：不同Windows版本可能会有细微差异，建议在目标环境中测试
3. 会话冲突：确保不会意外重连其他用户的会话
4. 日志记录：添加详细的日志记录有助于排查问题

扩展思考

对于更复杂的测试环境，还可以考虑以下增强措施：

1. 会话保持：配置组策略防止会话自动断开
2. 屏幕保护：禁用屏幕保护程序避免锁定会话
3. 电源管理：防止系统进入睡眠状态
4. 多显示器：处理多显示器环境下的UI定位问题

通过以上方法，可以确保FlaUI测试在各种环境下都能稳定运行，为持续集成流程提供可靠的自动化测试支持。