SSH远程执行Selenium脚本时Web元素找不到的问题求助

在Windows Server 2019本地运行Selenium脚本时可正常定位Web元素，但通过SSH远程连接该服务器执行同一脚本时，出现元素找不到的情况。已知并非图形渲染问题，因为脚本中其他相同逻辑的元素定位均正常。

相关代码片段 #

$searchInput="/html/body/bi-webconsole/ui-view/bi-group-details/div/layout-advanced-details/div/div[2]/div/layout-transclude-view-details/div/bi-group-details-view-smartgroups/div/wc-grid-viewer/div[2]/div/ui-filter-bar/ui-filter-bar-textbox/div/ui-textbox/ui-input-wrapper/div[1]/div/input"
Click-Elment -driver $driver -ifClickable -selector $searchInput     
$searchInput=Wait-ElmentCondition -selector $searchInput -ifClickable
write-debug "[Update-SmartRuleAccessUI]this should be webElment`nsearchInput`n$($searchInput | fl *| out-string)"
$searchInput.Clear()
$searchInput.SendKeys($smartRuleName)
$searchInput.SendKeys([OpenQA.Selenium.Keys]::Enter)

function Wait-ElmentCondition {
    param (
        [string]
        $selector,
        [switch]
        $ifVisable,
        [switch]
        $ifClickable
    )
    if ($ifVisable) {
        Write-Debug "proccessing $selector"
        try {
            [OpenQA.Selenium.Support.UI.WebDriverWait]$wait = New-Object OpenQA.Selenium.Support.UI.WebDriverWait ($driver, [System.TimeSpan]::FromSeconds(5)) 
            $res = $wait.Until([OpenQA.Selenium.Support.UI.ExpectedConditions]::ElementExists([OpenQA.Selenium.By]::XPath(($selector))))
            Write-Debug "[Wait-ElmentCondition]`$res = $res"
            return $res    
            }
        catch {
        }
    }
    if ($ifClickable){
        Write-Debug "proccessing $selector"
        try {
            [OpenQA.Selenium.Support.UI.WebDriverWait]$wait = New-Object OpenQA.Selenium.Support.UI.WebDriverWait ($driver, [System.TimeSpan]::FromSeconds(5))
            $res = $wait.Until([OpenQA.Selenium.Support.UI.ExpectedConditions]::ElementToBeClickable([OpenQA.Selenium.By]::XPath(($selector))))
            Write-Debug "[Wait-ElmentCondition]`$res = $res"
            return $res
            }
        catch {
        }
    }
}

本地执行调试信息 #

DEBUG: [Update-SmartRuleAccessUI]this should be webElment
searchInput

WrappedDriver                        : OpenQA.Selenium.Chrome.ChromeDriver
TagName                              : input
Text                                 :
Enabled                              : True
Selected                             : False
Location                             : {X=520,Y=417}
Size                                 : {Width=194, Height=20}
Displayed                            : True
LocationOnScreenOnceScrolledIntoView : {X=520,Y=417}
Coordinates                          : OpenQA.Selenium.Remote.RemoteCoordinates

SSH远程执行报错信息 #

DEBUG: [Update-SmartRuleAccessUI]this should be webElment
searchInput

InvalidOperation: C:\Users\xx\Downloads\se1\pammange.ps1:836
Line |
 836 |          $searchInput.Clear()
     |          ~~~~~~~~~~~~~~~~~~~~
     | You cannot call a method on a null-valued expression.

InvalidOperation: C:\Users\xx\Downloads\se1\pammange.ps1:837
Line |
 837 |          $searchInput.SendKeys($smartRuleName)
     |          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | You cannot call a method on a null-valued expression.

InvalidOperation: C:\Users\xx\Downloads\se1\pammange.ps1:838
Line |
 838 |          $searchInput.SendKeys([OpenQA.Selenium.Keys]::Enter)
     |          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | You cannot call a method on a null-valued expression.

1. 修复等待函数的异常处理
   当前Wait-ElmentCondition函数捕获异常后直接吞掉错误，无任何提示，导致远程执行时元素定位失败后$searchInput为null却无法定位问题根源。修改函数，在catch块抛出异常：

   function Wait-ElmentCondition {
       param (
           [string]
           $selector,
           [switch]
           $ifVisable,
           [switch]
           $ifClickable
       )
       if ($ifVisable) {
           Write-Debug "processing $selector"
           try {
               [OpenQA.Selenium.Support.UI.WebDriverWait]$wait = New-Object OpenQA.Selenium.Support.UI.WebDriverWait ($driver, [System.TimeSpan]::FromSeconds(5)) 
               $res = $wait.Until([OpenQA.Selenium.Support.UI.ExpectedConditions]::ElementExists([OpenQA.Selenium.By]::XPath(($selector))))
               Write-Debug "[Wait-ElmentCondition]`$res = $res"
               return $res    
           }
           catch {
               throw "等待元素可见失败：$_"
           }
       }
       if ($ifClickable){
           Write-Debug "processing $selector"
           try {
               [OpenQA.Selenium.Support.UI.WebDriverWait]$wait = New-Object OpenQA.Selenium.Support.UI.WebDriverWait ($driver, [System.TimeSpan]::FromSeconds(5))
               $res = $wait.Until([OpenQA.Selenium.Support.UI.ExpectedConditions]::ElementToBeClickable([OpenQA.Selenium.By]::XPath(($selector))))
               Write-Debug "[Wait-ElmentCondition]`$res = $res"
               return $res
           }
           catch {
               throw "等待元素可点击失败：$_"
           }
       }
   }
   

2. 优化XPath定位器
   绝对XPath依赖完整DOM层级，远程执行时窗口尺寸、加载顺序差异可能导致DOM结构微小变化，直接引发定位失败。改为相对XPath，比如通过元素属性定位：

   # 示例：根据实际元素属性调整，如class、placeholder等
   $searchInput="//input[contains(@class,'ui-input') or @placeholder='搜索智能规则']"
   

3. 设置远程执行的浏览器窗口尺寸
   SSH远程执行时，浏览器可能以极小窗口或无头模式运行，导致目标元素被移出视口，即使ElementToBeClickable也无法正确识别。添加窗口最大化代码：

   $driver.Manage().Window.Maximize()
   # 或固定窗口尺寸
   $driver.Manage().Window.Size = New-Object System.Drawing.Size(1920, 1080)
   

4. 延长等待时间
   远程服务器的网络或页面加载速度通常慢于本地，5秒等待时间可能不足。将等待时间延长至10-15秒：

   [OpenQA.Selenium.Support.UI.WebDriverWait]$wait = New-Object OpenQA.Selenium.Support.UI.WebDriverWait ($driver, [System.TimeSpan]::FromSeconds(10))
   

5. 验证页面加载状态
   在定位元素前，确认页面已完全加载：

   $wait.Until({ $driver.ExecuteScript("return document.readyState") -eq "complete" })
   

内容的提问来源于stack exchange，提问作者جواد محمد