PowerShell 7并行处理URL时的变量访问与同步对象错误

一、首次除以零错误的根因 #

在ForEach-Object -Parallel的并行块里，默认没法直接访问外部的$lines变量——因为每个并行子进程都有独立的作用域，没把$lines传进去的话，这个变量在子进程里就是0，执行100 * $i / $lines自然触发除以零的异常。

二、同步对象参数为空的原因 #

要么是创建[System.Object]同步对象时没正确初始化就传给了[System.Threading.Monitor]::Enter()，要么是并行块里没通过正确方式引用这个对象，导致传入的参数是空值，触发报错。

三、可落地的解决实现 #

核心思路 #

1. 用$using:关键字把外部变量（总URL数、同步对象、计数器）传递到并行块，确保子进程能访问到。
2. 用线程安全的计数器跟踪已处理数量，避免多线程竞争导致计数混乱。
3. 用同步对象控制进度条的控制台输出，防止多线程同时打印导致的内容错乱。

完整脚本示例 #

# 读取URL列表文件，替换成你的文件路径
$urlList = Get-Content ".\urls.txt"
$totalCount = $urlList.Count
# 线程安全的计数器，初始为0
$processed = [System.Threading.Interlocked]::new(0)
# 初始化同步对象，用于控制控制台输出
$outputLock = New-Object System.Object

# 并行处理URL下载
$urlList | ForEach-Object -Parallel {
    $currentUrl = $_
    $total = $using:totalCount
    $counter = $using:processed
    $lock = $using:outputLock

    # 执行下载逻辑，这里可以替换成你实际的下载代码
    try {
        $savePath = ".\downloads\$(Split-Path $currentUrl -Leaf)"
        Invoke-WebRequest -Uri $currentUrl -OutFile $savePath -ErrorAction Stop
    }
    catch {
        Write-Error "下载失败: $currentUrl - $($_.Exception.Message)"
    }

    # 原子更新已处理数量
    $currentNum = [System.Threading.Interlocked]::Increment($counter)
    $progressPercent = [int](100 * $currentNum / $total)

    # 同步输出进度，避免多线程打印混乱
    [System.Threading.Monitor]::Enter($lock)
    try {
        Write-Host "`r处理进度: $progressPercent% ($currentNum/$total)" -NoNewline
    }
    finally {
        [System.Threading.Monitor]::Exit($lock)
    }
} -ThrottleLimit 15 # 并行线程数，根据你的网络带宽调整

# 处理完成后换行，让输出更整洁
Write-Host "`n所有URL处理完成"

关键细节说明 #

• $using:是PowerShell并行块中引用外部变量的专用语法，能确保子进程拿到正确的变量值。
• [System.Threading.Interlocked]的Increment方法是原子操作，多个线程同时修改计数器也不会出问题。
• [System.Threading.Monitor]的Enter和Exit确保同一时间只有一个线程能输出进度信息，避免控制台内容乱跳。

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