为何PowerShell 7传递$null参数时错误信息不完整？如何配置？

问题重现 #

测试脚本 #

param(
  [Parameter()]
  $Adventurer = "Bilbo"
)

$ErrorActionPreference = 'Stop'
#Requires -Version 7

function Get-SpyResult($FileName) {
  $profile = Get-Item $FileName
  # ...
}

$x = Get-SpyResult $Adventurer
# ...
Write-Host "If this worked, we would get here."

执行现象 #

PS C:\temp> $PSVersionTable.PSVersion.ToString()
7.4.1
PS C:\temp> .\here_be_dragons.ps1 "Someone"
Get-Item: C:\temp\here_be_dragons.ps1:10
Line |
  10 |    $profile = Get-Item $FileName
     |               ~~~~~~~~~~~~~~~~~~
     | Cannot find path 'C:\temp\Someone' because it does not exist.
PS C:\temp> .\here_be_dragons.ps1 $Null
here_be_dragons.ps1: Cannot bind argument to parameter 'Path' because it is null.
PS C:\temp> $Error[0]
Get-Item: C:\temp\here_be_dragons.ps1:10
Line |
  10 |    $profile = Get-Item $FileName
     |                        ~~~~~~~~~
     | Cannot bind argument to parameter 'Path' because it is null.

可以看到：

• 传递非空无效参数时，错误会显示完整的调用行号和上下文
• 传递$null时，仅显示表层错误，完整信息需要手动查看$Error[0]

原因分析 #

错误类型差异导致输出不同 #

1. 非空参数错误：传递"Someone"时，Get-Item能正常接收参数，执行时因找不到路径抛出执行阶段终止错误，$ErrorActionPreference = 'Stop'会将该错误包装为ActionPreferenceStopException，PowerShell默认对这类错误输出完整的堆栈和上下文信息。
2. $null参数错误：传递$null时，错误发生在参数绑定阶段：Get-Item的Path参数不允许为$null，在调用Get-Item时参数绑定直接失败，触发的是ErrorRecord类型的参数绑定错误。PowerShell默认输出逻辑对这类绑定错误仅显示表层提示，不会自动展开完整堆栈。

解决方法 #

1. 脚本内强制显示完整错误 #

在脚本开头添加$ErrorView = 'NormalView'，该配置会让PowerShell对所有错误类型都输出完整的上下文（包括行号、调用栈）：

param(
  [Parameter()]
  $Adventurer = "Bilbo"
)

$ErrorActionPreference = 'Stop'
$ErrorView = 'NormalView' # 新增配置
#Requires -Version 7

function Get-SpyResult($FileName) {
  $profile = Get-Item $FileName
  # ...
}

$x = Get-SpyResult $Adventurer
# ...
Write-Host "If this worked, we would get here."

修改后传递$null执行，会直接显示完整的错误堆栈，和非空参数错误格式一致。

2. 提前拦截无效参数 #

给Get-SpyResult的FileName参数添加非空验证，在参数传递到Get-Item前就拦截$null，错误会在函数入口触发并显示完整上下文：

function Get-SpyResult([Parameter(Mandatory)][ValidateNotNullOrEmpty()]$FileName) {
  $profile = Get-Item $FileName
  # ...
}

此时传递$null时，会直接提示Get-SpyResult的参数错误，且包含完整的调用位置信息。

3. 全局配置PowerShell 7 #

若要让所有PowerShell 7会话默认显示完整错误，可修改用户配置文件：

1. 打开PowerShell 7，执行以下命令创建/打开配置文件：

   if (-not (Test-Path $PROFILE)) { New-Item -Path $PROFILE -ItemType File -Force }
   notepad $PROFILE
   

2. 在配置文件中添加$ErrorView = 'NormalView'，保存后重启PowerShell 7即可生效。

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