PowerShell类在Runspace中无法调用自身方法的问题排查

在PowerShell 5.1环境中，自定义类实例跨Runspace传递后，调用其内部方法（无论静态还是实例方法）会导致程序挂起，无任何报错输出；直接在主Runspace调用类方法则完全正常，仅在Runspace池/子Runspace环境中触发该问题。

根本原因 #

PowerShell 5.1基于.NET Framework构建，自定义类的实例跨Runspace传递时，其方法会绑定到原创建Runspace的上下文。当子Runspace尝试调用这些方法时，会触发跨Runspace的线程同步阻塞——方法执行需要依赖原Runspace的状态，但原Runspace可能处于等待子Runspace完成的状态，最终形成死锁，导致程序挂起。

解决方案 #

方案1：升级到PowerShell 7+ #

PowerShell 7采用.NET Core的序列化体系，彻底修复了自定义类跨Runspace的方法调用兼容性问题，是最彻底的解决方式。升级后无需修改现有类结构，直接沿用原代码即可。

方案2：在子Runspace内部创建类实例（适用于无法升级PS版本的场景） #

避免从主Runspace传递类实例到子Runspace，改为在子Runspace内部创建实例，仅传递创建实例所需的参数而非实例本身。

修改后的Runspace创建代码示例：

$ScriptBlock = {
    param([Parameter()]$glpiUsrkey, [Parameter()]$glpiAppkey, [Parameter()]$glpiUrl, [Parameter()]$item)
    
    # 在子Runspace内部创建ClassA实例，避免跨Runspace传递实例
    $glpiManager = [ClassA]::new($glpiUsrkey, $glpiAppkey, $glpiUrl)
    $glpiManager.StartSession()
    $glpiManager.ProcessItem($item)
    $glpiManager.EndSession()
}

foreach($item in $itemlist) {
    $runspace = [PowerShell]::Create($iss)
    $null = $runspace.AddScript($ScriptBlock)

    # 传递创建实例的参数，而非实例
    $null = $runspace.AddParameter('glpiUsrkey', $glpi_usrkey)
    $null = $runspace.AddParameter('glpiAppkey', $glpi_appkey)
    $null = $runspace.AddParameter('glpiUrl', $glpi_url)
    $null = $runspace.AddParameter('item', $item)

    $runspace.RunspacePool = $RunspacePool

    $Runspaces += [PSCustomObject]@{
        Pipe = $runspace;
        Status = $runspace.BeginInvoke()
    }
}

方案3：替换自定义类为函数（PS5.1兼容替代方案） #

如果自定义类的逻辑不复杂，可以将类的方法拆分为独立函数——函数在Runspace中的兼容性远高于自定义类，能避免跨Runspace的序列化问题。

示例：将RestModel的GetRequest改为函数

function Invoke-CustomGetRequest {
    param(
        [string]$url,
        [object]$headers
    )
    try {
        $response = Invoke-RestMethod -Uri $url -Headers $headers -Method Get
        return $response
    } catch {         
        throw [CustomRestException]::new("Error while performing GET request on $url. ($_)", $_.Exception.Response.StatusCode.value__)
    }
}

之后在逻辑中直接调用该函数即可，无需依赖自定义类实例。

额外注意事项 #

• 保持Runspace池的ApartmentState设置为MTA（你的代码中已配置，无需修改），纯PowerShell逻辑无需切换为STA。
• 调试时可给BeginInvoke()的等待逻辑添加超时，避免无限挂起：比如通过$status.AsyncWaitHandle.WaitOne(10000)设置10秒超时，超时后终止Runspace。

内容的提问来源于stack exchange，提问作者TXoC