

## 一、痛点引入

先看一个很常见但危险的写法：

```csharp
public class BadTraceMiddleware
{
    private readonly RequestDelegate _next;
    private string? _currentTraceId; // 危险：字段会被并发请求共享

    public BadTraceMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context)
    {
        _currentTraceId = context.TraceIdentifier;

        await _next(context);

        Console.WriteLine($"traceId: {_currentTraceId}");
    }
}
```

问题在于：

- Middleware 默认通常是单例语义
- `_currentTraceId` 是实例字段
- 多请求并发时会互相覆盖

这就会出现典型“串请求数据”。

---

## 二、底层原理

ASP.NET Core 里要先记住一句话：

> **中间件对象通常不是每请求 new 一个，而是应用启动时构建后反复复用。**

所以：

- 局部变量：安全
- 实例字段：高并发下不安全
- 静态字段：更危险

另外，请求级数据如果需要跨层传递，很多框架能力依赖的是：

- `HttpContext.Items`
- Scoped 服务
- `AsyncLocal<T>`

其中 `AsyncLocal<T>` 的特点是：

- 它不是线程局部变量
- 它是“异步调用链上下文局部变量”
- `await` 之后上下文还能跟着流动

这也是为什么日志追踪、链路 ID、租户信息等经常基于它实现。

---

## 三、代码实战示例

### 错误写法：把请求数据放到字段里

```csharp
public class BadTenantMiddleware
{
    private readonly RequestDelegate _next;
    private string? _tenantId; // 并发请求共享

    public BadTenantMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context)
    {
        _tenantId = context.Request.Headers["X-Tenant-Id"];
        await _next(context);
    }
}
```

---

### 正确写法 1：用局部变量

```csharp
public class GoodTenantMiddleware
{
    private readonly RequestDelegate _next;

    public GoodTenantMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context)
    {
        var tenantId = context.Request.Headers["X-Tenant-Id"].ToString();

        // 当前请求内使用局部变量，天然安全
        Console.WriteLine($"tenantId: {tenantId}");

        await _next(context);
    }
}
```

---

### 正确写法 2：跨层传递用 `HttpContext.Items`

```csharp
public class TenantMiddleware
{
    private readonly RequestDelegate _next;

    public TenantMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context)
    {
        var tenantId = context.Request.Headers["X-Tenant-Id"].ToString();
        context.Items["TenantId"] = tenantId;

        await _next(context);
    }
}
```

控制器中读取：

```csharp
[ApiController]
[Route("api/demo")]
public class DemoController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        var tenantId = HttpContext.Items["TenantId"]?.ToString();
        return Ok(new { TenantId = tenantId });
    }
}
```

---

### 正确写法 3：需要跨服务层传递时，用 `AsyncLocal`

```csharp
public static class TenantContext
{
    private static readonly AsyncLocal<string?> _current = new();

    public static string? Current
    {
        get => _current.Value;
        set => _current.Value = value;
    }
}

public class TenantMiddleware
{
    private readonly RequestDelegate _next;

    public TenantMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context)
    {
        TenantContext.Current = context.Request.Headers["X-Tenant-Id"].ToString();

        try
        {
            await _next(context);
        }
        finally
        {
            // 必须清理，避免上下文污染
            TenantContext.Current = null;
        }
    }
}
```

---

## 四、避坑要点

### 1. 中间件不要保存请求态数据到字段
实例字段在并发请求下会共享，最容易串数据。

### 2. 不要在单例里注入 Scoped 服务后长期保存
比如把 `DbContext`、当前用户信息缓存到单例对象里，属于经典生命周期错误。

### 3. `AsyncLocal` 不是万能的
它适合少量请求上下文传递，不适合拿大对象乱塞，否则会带来额外开销。

### 4. 用完要清理
特别是自定义 `AsyncLocal`，不清理容易造成链路污染，排查非常痛苦。

---

## 五、性能 / 架构建议

- **请求内传值优先局部变量**
- **跨中间件 / 控制器传值优先 `HttpContext.Items`**
- **跨服务层链路传值再考虑 `AsyncLocal`**
- **不要把请求态数据放进单例字段或静态变量**

如果是用户、租户、TraceId 这类上下文信息，建议统一封装成访问器，避免团队成员各写各的。

---

## 六、总结

ASP.NET Core 里很多“串数据”事故，本质不是框架 bug，而是：

- 没理解中间件复用机制
- 没理解服务生命周期
- 没理解 `AsyncLocal` 的上下文边界

记住一句话就够了：

> **请求数据只活在请求作用域里，别放进会被复用的对象字段。**

这类问题平时不一定炸，一旦高并发就是生产事故级别。


如果是用户、租户、TraceId 这类上下文信息，建议统一封装成访问器，避免团队成员各写各的。

.NET 中间件为什么会“串数据”？从 `AsyncLocal`、作用域生命周期到实战避坑

后端

架构设计

开发工具

ASP.NET Core中间件并发安全指南：避免请求数据共享问题。正确使用局部变量、HttpContext.Items和AsyncLocal传递请求数据，防止单例字段导致的数据串改。掌握中间件复用机制和服务生命周期，确保高并发下数据隔离，提升应用稳定性。

中间件

2026采购季 | AI焕新·智启新局

message-queue-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

.NET 中间件为什么会“串数据”？从 `AsyncLocal`、作用域生命周期到实战避坑-腾讯云开发者社区-腾讯云

.NET 中间件为什么会“串数据”？从 `AsyncLocal`、作用域生命周期到实战避坑

.NET 中间件为什么会“串数据”？从 `AsyncLocal`、作用域生命周期到实战避坑

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐