Parallel日志输出混乱：如何实现任务日志分组？

先排查基础配置问题 #

很多时候不是BeginScope不生效，而是日志框架没配置输出Scope内容。以.NET默认日志为例，需在appsettings.json中开启Scope输出：

"Logging": {
  "Console": {
    "FormatterOptions": {
      "IncludeScopes": true,
      // 可选：自定义模板，确保包含{Scope}
      "LogTemplate": "{Timestamp:HH:mm:ss} [{Level}] {Scope} {Message}{NewLine}{Exception}"
    }
  }
}

若用Serilog，需在配置中添加Enrich.FromLogContext()，并在输出模板中加入{Properties:j}或{Scope}。

方案1：手动给日志加任务标识（最小改动） #

如果Scope始终有问题，直接放弃依赖Scope，给每条日志硬加文件名参数，稳妥且改动量小：

Parallel.ForEach(files, file =>
{
    _logger.LogInformation("处理文件 {FileName}：开始读取内容", file.Name);
    // 你的业务代码
    _logger.LogInformation("处理文件 {FileName}：内容处理完成", file.Name);
});

每条日志都会带上文件名，自然能按文件归类，不会混乱。

方案2：改用Task.WhenAll异步处理（更可靠的Scope支持） #

.NET日志的BeginScope基于AsyncLocal实现，在异步任务中比线程池线程复用场景更可靠。替换Parallel.ForEach为异步批量处理：

await Task.WhenAll(files.Select(file => Task.Run(() =>
{
    using (_logger.BeginScope("{FileName}", file.Name))
    {
        // 你的同步业务代码，用Task.Run卸载到线程池
        ProcessFile(file);
    }
})));

如果业务代码本身是异步的（比如ProcessFileAsync），直接去掉Task.Run即可，Scope会在异步流中正确传递，每个文件的日志都会带上对应标识。

方案3：修复Parallel.ForEach中的Scope传递（针对必须用Parallel的场景） #

若必须保留Parallel.ForEach，可使用带本地状态的重载，确保每个线程的Scope独立：

Parallel.ForEach(files,
    () => new Dictionary<string, object>(),
    (file, state, localState) =>
    {
        using (_logger.BeginScope("{FileName}", file.Name))
        {
            // 你的业务代码
            _logger.LogInformation("正在处理文件");
        }
        return localState;
    },
    localState => { });

这个方案逻辑和你原有代码一致，核心还是要确保日志框架正确配置了Scope输出。

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