PowerShell关闭Splash等待弹窗触发空值表达式错误排查

问题根因 #

报错的核心原因是PowerShell变量作用域限制：

• 在OpenSplash()函数内通过$Splash = New-Object ...声明的变量是函数局部变量，仅在OpenSplash执行阶段有效，函数运行结束后变量会被回收销毁，外部的CloseSplash()函数无法访问到这个变量，因此调用$Splash.Close()时会触发空值错误。
• 第一种$This.Parent.Close()的写法逻辑错误：$This仅在脚本块绑定到对象实例、类方法、控件事件场景下才会指向对应对象，在独立的CloseSplash函数中直接调用时，$This不会指向Splash弹窗，因此会错误关闭主窗体。
• 把创建、业务执行、关闭逻辑写在同一代码块时能正常关闭，就是因为同作用域下$Splash变量全程有效，不存在跨函数访问的作用域问题。

可直接复用的修复方案 #

方案1：使用脚本级作用域存储弹窗对象（改动最小） #

给变量加上script:作用域修饰符，让弹窗对象在整个脚本生命周期内可被两个函数访问，同时补充资源释放逻辑避免内存泄漏：

# 提前加载所需程序集，无需在函数内重复判断加载
Add-Type -AssemblyName System.Windows.Forms, System.Drawing, PresentationFramework

Function OpenSplash()
{
    $script:Splash = New-Object System.Windows.Forms.Form
    $script:Splash.StartPosition = 'CenterScreen'
    $script:Splash.Size = New-Object System.Drawing.Size(350,200)
    $script:Splash.TopMost = $true # 弹窗始终置顶，避免被业务窗体遮挡
    $script:Splash.ControlBox = $false # 隐藏关闭按钮，防止用户手动误关

    $SplashLabel = New-Object System.Windows.Forms.Label
    $script:Splash.Controls.Add($SplashLabel)

    $SplashLabel.Location = New-Object System.Drawing.Point(100,60)
    $SplashLabel.Font = [System.Drawing.Font]::new("Microsoft Sans Serif", 16, [System.Drawing.FontStyle]::Bold)
    $SplashLabel.Text = "Please Wait"
    $SplashLabel.AutoSize = $true
    $script:Splash.Show()
    $script:Splash.Update()
}

Function CloseSplash()
{
    # 增加判空逻辑，避免重复关闭触发报错
    if ($null -ne $script:Splash -and !$script:Splash.IsDisposed) {
        $script:Splash.Close()
        $script:Splash.Dispose()
    }
}

# 原有CheckShuffle逻辑无需改动
Function CheckShuffle()
{
    If ($Global:x -eq "" -or $Global:x -eq '0')
    {
        [System.Windows.MessageBox]::Show('You must select your part first', 'Warning', 'OK')
    }
    Else
    {
        OpenSplash
        # 原有Shuffle业务逻辑
        CloseSplash
    }
}

方案2：通过函数返回值传递弹窗对象（无全局变量污染） #

如果不想使用脚本级变量，可以让OpenSplash返回创建好的窗体实例，关闭时将实例作为参数传入CloseSplash，更符合函数式编程规范：

Add-Type -AssemblyName System.Windows.Forms, System.Drawing, PresentationFramework

Function OpenSplash()
{
    $Splash = New-Object System.Windows.Forms.Form
    $Splash.StartPosition = 'CenterScreen'
    $Splash.Size = New-Object System.Drawing.Size(350,200)
    $Splash.TopMost = $true
    $Splash.ControlBox = $false

    $SplashLabel = New-Object System.Windows.Forms.Label
    $Splash.Controls.Add($SplashLabel)

    $SplashLabel.Location = New-Object System.Drawing.Point(100,60)
    $SplashLabel.Font = [System.Drawing.Font]::new("Microsoft Sans Serif", 16, [System.Drawing.FontStyle]::Bold)
    $SplashLabel.Text = "Please Wait"
    $SplashLabel.AutoSize = $true
    $Splash.Show()
    $Splash.Update()
    return $Splash
}

Function CloseSplash($targetSplash)
{
    if ($null -ne $targetSplash -and !$targetSplash.IsDisposed) {
        $targetSplash.Close()
        $targetSplash.Dispose()
    }
}

# 调用逻辑需要小幅调整
Function CheckShuffle()
{
    If ($Global:x -eq "" -or $Global:x -eq '0')
    {
        [System.Windows.MessageBox]::Show('You must select your part first', 'Warning', 'OK')
    }
    Else
    {
        $currentSplash = OpenSplash
        # 原有Shuffle业务逻辑
        CloseSplash $currentSplash
    }
}

避坑提示 #

• 不建议用$Global:全局作用域存储弹窗对象，脚本执行结束后变量会残留在当前PowerShell会话中，容易引发后续脚本的变量冲突，$script:作用域仅在当前脚本内生效，更安全。
• 弹窗显示优先用Show()方法，比单独设置Visible = $true更稳定，配合Update()方法可以强制重绘界面，避免业务代码阻塞导致弹窗加载不全。
• 关闭窗体后必须调用Dispose()释放GDI资源，多次调用弹窗如果不释放会引发内存泄漏。

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