PowerShell多日志对象转合法JSON数组的优化方案咨询

问题场景 #

多个PowerShell脚本通过追加方式向同一日志文件写入单个JSON格式的日志条目，最终希望日志文件保持为合法的JSON数组。现有格式化函数仅首次调用有效，后续追加日志后再执行格式化，会出现新的JSON对象位于数组闭合符号]之后的错误，导致JSON结构失效。

原方案失效原因 #

原格式化函数依赖纯文本替换逻辑，仅能处理从「多个独立JSON对象」转为「JSON数组」的场景。当日志文件已经是合法数组后，新追加的JSON对象会被写入到]之后，此时文本替换规则-replace "}\s*{"无法匹配到有效内容，无法将新对象合并到数组内，最终破坏JSON结构。

可行解决方案 #

方案一：修复格式化函数（兼容已有日志） #

通过JSON解析而非纯文本替换的方式，确保无论日志文件当前是独立JSON对象还是已损坏的数组结构，都能重新合并为合法的JSON数组：

function Format-JsonLog {
    param(
        [Parameter(Mandatory=$true)]
        [string]$LogFile
    )

    # 读取日志内容并过滤空行
    $rawContent = Get-Content $LogFile -Raw | Where-Object { $_ -match '\S' }

    # 尝试解析为JSON对象/数组，失败则拆分独立JSON条目
    try {
        $logEntries = $rawContent | ConvertFrom-Json -ErrorAction Stop
        # 若解析结果为单个对象，转为数组
        if ($logEntries -isnot [array]) {
            $logEntries = @($logEntries)
        }
    }
    catch {
        # 匹配所有独立的JSON对象（处理跨行情况）
        $jsonMatches = [regex]::Matches($rawContent, '\{[^{}]*\}') | ForEach-Object { $_.Value }
        $logEntries = $jsonMatches | ConvertFrom-Json
    }

    # 重新序列化为格式化的JSON数组并写入
    $formattedJson = $logEntries | ConvertTo-Json -Depth 10 -AsArray
    Set-Content $LogFile -Value $formattedJson -Force
}

优势

• 自动兼容多种日志状态：独立JSON对象、合法数组、损坏的数组结构
• 依赖PowerShell原生JSON解析，避免纯文本替换的边缘错误
• -Depth 10参数可根据日志条目的嵌套深度调整，防止序列化失败

方案二：从写入阶段优化（更高效） #

直接在写入日志时维护JSON数组结构，彻底避免事后格式化的需求：

function Write-JsonLog {
    param(
        [Parameter(Mandatory=$true)]
        [string]$LogFile,
        [Parameter(Mandatory=$true)]
        [string]$Severity,
        [Parameter(Mandatory=$true)]
        [string]$Message,
        [DateTime]$CurrentDate = (Get-Date)
    )

    # 构造标准化日志条目（用ISO时间格式保证可移植性）
    $newLogEntry = @{
        date     = $CurrentDate.ToString('o')
        severity = $Severity
        message  = $Message
    }

    # 读取并解析现有日志数组
    if (Test-Path $LogFile) {
        try {
            $existingLogs = Get-Content $LogFile -Raw | ConvertFrom-Json -ErrorAction Stop
            # 确保解析结果为数组
            if ($existingLogs -isnot [array]) {
                $existingLogs = @($existingLogs)
            }
        }
        catch {
            # 若日志内容不合法，初始化空数组
            $existingLogs = @()
        }
        # 添加新条目
        $existingLogs += $newLogEntry
    }
    else {
        # 文件不存在时直接创建包含新条目的数组
        $existingLogs = @($newLogEntry)
    }

    # 写入格式化后的JSON数组
    $existingLogs | ConvertTo-Json -Depth 10 -AsArray | Set-Content $LogFile -Force
}

优势

• 每次写入直接维护合法JSON数组，无需事后格式化
• 自动处理文件不存在、日志内容损坏等异常情况
• 标准化时间格式，提升日志的跨平台可读性

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