首次运行PowerShell脚本报ExecuteSqlQuery未识别，后续运行正常问题

根因定位 #

• PowerShell 自定义函数的可识别规则是：函数定义代码必须先被执行加载、注册到当前会话的函数作用域表中，后续代码才能正常调用该函数。
• 当前脚本完全颠倒了函数定义与调用的先后顺序：两次ExecuteSqlQuery的调用代码写在脚本第7、9行，对应的函数定义块却放在两次调用之后的第11行位置。

为什么仅首次在全新会话报错、同会话后续重复运行可正常工作？
当在新启动的PowerShell会话中首次运行脚本时，执行流严格从上到下推进，走到第7行的函数调用时，还没执行到后面的函数定义代码，无法在函数表里匹配到ExecuteSqlQuery，直接抛出CommandNotFoundException中断执行。
但PowerShell在执行脚本前，会先完整解析整个脚本文件的所有语法结构，在中断抛错的间隙，已经把文件中所有顶层作用域的函数解析完成、注册到当前会话的内存中。因此只要不关闭当前PowerShell会话，后续再次运行同一脚本时，会话内存中已经存在ExecuteSqlQuery的注册信息，无论调用行在脚本的哪个位置，都可以正常识别执行。

修复方案 #

• 调整脚本代码顺序，把ExecuteSqlQuery的完整函数定义块移动到所有调用它的代码行之前，脚本最开头的位置是最稳妥的放置点。
• 修正原函数的逻辑漏洞：原代码把return $obj放在数据库连接关闭、资源释放代码之前，实际执行到return语句就会直接退出函数，后续的连接清理代码永远不会被执行，容易造成数据库连接泄漏，需要将资源释放逻辑放在return语句之前。

调整后的代码核心顺序参考：

# 第一步：先完成所有自定义函数的定义
function ExecuteSqlQuery ($Server, $Database, $SQLQuery) {
  $Connection = New-Object System.Data.SQLClient.SQLConnection
  $Connection.ConnectionString = "server='$Server';database='$Database';Integrated Security=True;"
  $Connection.Open()
  $Command = New-Object System.Data.SQLClient.SQLCommand
  $Command.Connection = $Connection
  $Command.CommandText = $SQLQuery
  $Reader = $Command.ExecuteReader()
  If ($Reader.HasRows) {
        $obj = $Reader | ForEach-Object {
          $row = $_;  
          New-Object psObject -Property @{ 
              CreateDate = $row.Item("created_date")
              ReasonDown = $row.Item("ReasonDown")
          }
        }
  }
  # 先完成资源释放，再返回结果
  $Connection.Close()
  $Connection.Dispose()
  return $obj
}

# 第二步：定义全局运行参数
[string] $Server= "Server"
[string] $Database = "mvTest"
[string] $UserSqlQuery= "select m.created_date, m.additional_data as ReasonDown from aeroscout.mv_audit m where m.created_date >= '2020-01-18' and m.additional_data like '%remainingCapacity={`"o`":`"3.5`",`"n`":`"3.0`"};batteryReplacementDate={`"o`":`"2020-02-29%'"

# 第三步：调用函数执行业务逻辑
$firstQueryResult = ExecuteSqlQuery $Server $Database $UserSqlQuery
Start-Sleep 5
$secondQueryResult = ExecuteSqlQuery $Server $Database $UserSqlQuery

# 后续数据对比逻辑
$fields = "created_date", "ReasonDown"
$exportObject=@()
$exportObject = Compare-Object -ReferenceObject $firstQueryResult -DifferenceObject $secondQueryResult -IncludeEqual -Property $fields -PassThru | Where-Object { $_.SideIndicator -eq "==" }

其他附带问题提醒 #

• PowerShell 语法不支持以数字开头的变量名（如原脚本里的$1_resultsDataTable、$2_resultsDataTable），这类命名在部分PowerShell版本中会触发解析异常，建议替换为符合规范的命名。
• 原脚本的对比逻辑里，把同一个变量$1_resultsDataTable同时作为参考对象和待对比对象，实际运行时永远不会检测到数据差异，对比结果没有实际业务价值。

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