$Profile延迟加载模块时Where-Object/ForEach-Object管道失效原因探究

前言 #

本文不寻求代码修复方案（已完成修复），仅旨在理解问题根源，避免后续同类错误。

场景 #

使用PowerShell 7.4.1，在$Profile中通过一段延迟加载代码加载自定义模块。模块中的Get-DirectoryItem函数使用管道调用Where-Object和ForEach-Object时，出现ForEach-Object: Object reference not set to an instance of an object.及Where-Object: Object reference not set to an instance of an object.错误，但Get-Item、Get-ChildItem等其他管道命令可正常工作。

可复现示例 #

$Profile中的脚本 #

$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = [Text.Encoding]::UTF8
$GlobalState = [psmoduleinfo]::new($false)
$GlobalState.SessionState = $ExecutionContext.SessionState

$Job = Start-ThreadJob -Name TestJob -ArgumentList $GlobalState -ScriptBlock {
    $GlobalState = $args[0]
    . $GlobalState {

        # 等待Import-Module命令可用
        do {
            Start-Sleep -Milliseconds 200
        } until (Get-Command Import-Module -ErrorAction Ignore)

        # 其他点源脚本（已注释）
        # . "$ProfileDirectory\CustomAlias.ps1"
        # . "$ProfileDirectory\CustomConstants.ps1"
        # . "$ProfileDirectory\CustomVariables.ps1"
        # . "$ProfileDirectory\CustomPrompt.ps1"

        # 导入自定义模块
        Import-Module -Name Get-DirectoryItem

    }
}


$null = Register-ObjectEvent -InputObject $Job -EventName StateChanged -SourceIdentifier Job.Monitor -Action {
    # JobState: NotStarted = 0, Running = 1, Completed = 2, etc.
    if ($Event.SourceEventArgs.JobStateInfo.State -eq 'Completed') {
        $Result = $Event.Sender | Receive-Job
        if ($Result) {
            $Result | Out-String | Write-Host
        }

        $Event.Sender | Remove-Job
        Unregister-Event Job.Monitor
        Get-Job Job.Monitor | Remove-Job
    }
    elseif ($Event.SourceEventArgs.JobStateInfo.State -gt 2) {
        $Event.Sender | Receive-Job | Out-String | Write-Host
    }
}

加载的模块代码 #

function Get-DirectoryItem {
    [CmdletBinding(DefaultParameterSetName = 'BaseSet')]
    [Alias('Get-Dir', 'GD')]
    param (
    )

    process {
        1..3 | Where-Object { $_ }
        1..3 | ForEach-Object { $_ }
        $a = @('a', 'b', 'c') 
        $a | ForEach-Object { $_ }
        $a | Where-Object { $_ }

    }
}

修复方式 #

移除Job中的Import-Module语句后，模块可自动导入且功能正常。

问题根源分析 #

这错误的核心是线程作业的会话状态和主会话状态被硬绑定导致的不兼容：

• 你用[psmoduleinfo]::new($false)创建了模块信息对象，并将主会话的$ExecutionContext.SessionState赋值给它，随后在线程作业内部通过.调用语法把该模块对象作为作用域容器执行代码。这种操作相当于把主会话的状态硬塞给线程作业的执行环境，本身就违背了PowerShell的会话隔离设计。
• Where-Object和ForEach-Object这类核心命令高度依赖当前会话的自动化运行时上下文。当在线程作业里用主会话的SessionState导入模块时，它们无法正确获取线程作业自身的会话上下文，内部关键对象未初始化，因此抛出空引用异常。
• 而Get-Item、Get-ChildItem等命令对会话上下文的依赖逻辑不同，它们更多依赖文件系统提供者的全局实例，所以在这种错误绑定下还能临时正常工作，但这只是特殊情况，并非通用行为。
• 删掉Job里的Import-Module后，PowerShell会通过自动模块导入机制在主会话中加载模块，此时模块完全在主会话的正常上下文里运行，所有核心命令都能获取到正确的状态，错误自然消失。

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