Azure Function App（PowerShell）偶现默认命令缺失问题排查

问题背景 #

我开发的PowerShell Azure Function App由多个队列触发的函数组成，负责在队列间流转状态。运行过程中偶尔会弹出这个错误：

The term 'write-output:' is not recognized as a name of a cmdlet, function, script file, or executable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again. Exception : Type : System.Management.Automation.CommandNotFoundException

所有子函数都用Write-Output打日志，这个错误会导致部分try-catch逻辑失效。本来以为PowerShell会话会自动刷新恢复，但把脚本简化成示例代码后问题就消失，恢复完整脚本又会重现，目前正在排查中。

排查和解决思路 #

• 先查语法硬错误：全量搜索脚本里的write-output:字符串，大概率是某个地方不小心把Write-Output写成了带冒号的版本。因为问题偶现，可能是特定分支、循环或者动态生成的代码里出现了这个笔误，得仔细核对所有日志调用。
• 处理会话复用问题：Azure Functions为了性能会复用PowerShell会话，如果某个会话里Write-Output被意外覆盖、删除或者污染，后续请求用这个会话就会报错。可以在函数开头加一段代码，检查并重置这个cmdlet：

  if (-not (Get-Command Write-Output -ErrorAction SilentlyContinue)) {
      & (Get-Command -Name Write-Output -CommandType Cmdlet) "重置Write-Output会话环境"
  }
  

• 换用更稳定的日志命令：Azure Functions里更推荐用Write-Information或者Write-Error来记录日志，比Write-Output更适配函数环境，稳定性更好。比如：

  Write-Information "业务执行日志内容" -InformationAction Continue
  

• 关闭会话复用：在host.json里配置禁用会话亲和性，强制每个请求用新的PowerShell会话，避免环境污染：

  {
      "version": "2.0",
      "powerShell": {
          "sessionAffinity": "none"
      }
  }
  

• 逐步定位问题代码：把完整脚本拆成模块，每次恢复一个模块后测试运行，直到问题重现，这样就能找到触发错误的具体代码段，重点关注动态生成代码、复杂条件分支里的日志调用。

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