PowerShell中ThreadJob与全局变量配合异常，LogsToDashboard未执行

核心问题点排查 #

• 函数定义顺序错误：你的代码里Build-DashboardLogValues函数是在循环执行完之后才定义的，PowerShell从上到下逐行解释，循环调用这个函数时它还不存在，直接报错，导致myValues根本没被添加内容。
• ThreadJob启动太晚：启动后台线程的代码在循环之后，循环已经跑完所有迭代才启动线程，这时候线程检查myValues时要么变量是空的，要么循环已经结束。
• 线程间变量作用域隔离：ThreadJob会创建独立子会话，父会话的全局变量默认不会被子会话继承，你在主线程更新的myValues，后台线程根本看不到。
• 无延迟空轮询：LogsToDashboard里的死循环没有任何休眠，会疯狂占用CPU，甚至可能被系统限制运行。
• 未查看Job错误日志：后台Job的错误不会直接显示在控制台，你没排查过Job是否有执行错误（比如网络请求失败）。

修正步骤 #

1. 调整函数定义顺序：把所有函数移到代码最前面，确保调用时函数已经加载。
2. 提前启动后台线程：把启动ThreadJob的代码放到循环之前，让线程在变量更新前就开始运行。
3. 解决变量作用域问题：用$using:关键字让后台线程引用父会话的集合对象，同时改用线程安全的集合（比如ConcurrentQueue）避免多线程读写冲突。
4. 添加循环延迟：在后台线程的循环里加Start-Sleep，减少空轮询的资源消耗。
5. 查看Job执行日志：用Get-Job $Dashboardjob | Receive-Job查看后台Job的输出和错误，排查隐藏问题。

修正后的示例代码 #

# 先定义所有函数
function Build-DashboardLogValues {
    param (
        [string] $message
    )
    $value = @(Get-Date -Format o, $message) # 直接用数组替代ArrayList更轻便
    $global:myValues.Enqueue($value)
}

function LogsToDashboard 
{
    $queue = $using:myValues # 引用父会话的线程安全队列
    while ($true) {
        if ($queue.TryDequeue([ref]$item)) {
            $headers = @{ 'Authorization' = "my token" }
            $jsonBase = @{
                Timestamp = $item[0]
                Message = $item[1]
            } 
            $bodyJson = $jsonBase | ConvertTo-Json -Depth 20

            try {
                Invoke-WebRequest -Uri "myurl" -Method Post -Headers $headers -Body $bodyJson -ContentType "application/json" -ErrorAction Stop
                Write-Verbose "日志发送成功: $($item[1])"
            }
            catch {
                Write-Error "日志发送失败: $_"
                # 发送失败的话把元素重新放回队列
                $queue.Enqueue($item)
            }
        }
        Start-Sleep -Milliseconds 500 # 每500毫秒检查一次，降低CPU占用
    }
}

# 初始化线程安全的队列（替代非线程安全的ArrayList）
$global:myValues = New-Object System.Collections.Concurrent.ConcurrentQueue[array]

# 先启动后台Job
$Dashboardjob = Start-ThreadJob -ScriptBlock ${function:LogsToDashboard}

# 执行变量更新循环
for ($i = 0; $i -lt 5; $i++) {
    Start-Sleep 10
    Build-DashboardLogValues -message "test $i"
    Start-Sleep 10
}

# 可选：查看Job输出
# Receive-Job $Dashboardjob -Wait -AutoRemoveJob

额外注意事项 #

• 生产环境一定要用System.Collections.Concurrent下的线程安全集合，避免多线程读写导致的数据损坏或异常；
• 脚本结束后记得用Stop-Job $Dashboardjob; Remove-Job $Dashboardjob清理后台线程，防止残留；
• 后台Job的异常要自行捕获处理，否则会静默失败，定期用Receive-Job查看日志。

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