本地正常的Pester测试在Azure发布管道中报错：Test-SQLConnection未识别

以下是几个常见的原因和对应的检查/修复步骤：

1. 函数未被正确加载到测试执行上下文 #

• 如果Test-SQLConnection函数定义在单独的脚本文件（比如SQLHelpers.ps1）中，检查测试脚本开头是否有导入该文件的代码：

  # 确保路径正确，使用相对路径时要注意工作目录
  . .\SQLHelpers.ps1
  

  本地运行时可能因为当前目录就是脚本所在目录所以能加载，但Azure管道的工作目录可能不同，建议使用基于测试脚本位置的相对路径：

  $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition
  . "$scriptDir\SQLHelpers.ps1"
  

• 如果函数是在Pester的Describe/Context块内定义的，确认所有调用该函数的测试用例都在同一个块的作用域内，或者把函数定义移到块外的脚本作用域。

2. Azure管道的工作目录与本地不一致 #

• 在Azure管道的PowerShell步骤中，先添加查看当前目录的命令，确认脚本路径是否正确：

  Write-Host "当前工作目录: $((Get-Location).Path)"
  Get-ChildItem # 列出当前目录下的文件，确认函数文件是否存在
  

• 如果使用Azure DevOps的Pester任务，检查任务的"工作目录"设置，确保指向包含测试脚本和函数文件的目录。

3. 管道执行环境的依赖问题 #

• 检查本地和管道使用的PowerShell版本是否一致（本地运行$PSVersionTable.PSVersion，管道里同样输出这个变量对比）。虽然报错是找不到命令，但版本差异可能导致函数加载失败。
• 如果函数属于自定义模块，确认管道的agent环境中是否安装了该模块。可以在管道步骤中添加模块导入命令：

  $modulePath = Join-Path -Path $scriptDir -ChildPath "YourCustomModule.psd1"
  Import-Module -Path $modulePath -Force
  

4. Pester任务的配置问题 #

• 如果使用Azure DevOps的Pester任务，确认"脚本路径"是否包含了所有需要的文件——不仅是测试脚本，还要包含定义Test-SQLConnection函数的文件。或者在任务的"初始化脚本"中添加加载函数文件的代码。

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