ASP.NET Core API项目如何获取访问接口的当前用户ID

旧版逻辑对应说明 #

原ASP.NET Framework版本中引用Microsoft.AspNet.Identity后使用的User.Identity.GetUserId()方法，在ASP.NET Core中没有完全同名的默认实现，核心逻辑是从当前用户的身份声明（Claims）中读取用户唯一标识。

返回204 No Content问题的核心原因 #

返回空内容不是读取声明的方法错误，是以下两类基础问题导致当前请求的用户身份未被正确填充：

• 中间件顺序错误：认证、授权中间件没有放在路由映射、接口执行逻辑之前
• 请求未携带合法认证凭证：调用接口时没有传有效的Token/Cookie，或者认证参数校验不通过，User.Identity.IsAuthenticated值为false，自然读不到用户ID声明

前置配置校验 #

先检查Program.cs中的中间件顺序，必须严格按照下面的顺序排列，顺序颠倒会导致身份信息无法正确注入：

// 其他中间件...
app.UseAuthentication();
app.UseAuthorization();
// 路由映射必须放在两个认证授权中间件之后
app.MapControllers();

同时确认发起API请求时，已经在请求头中携带了合法的身份凭证，比如JWT场景下请求头需要包含：

Authorization: Bearer {你的有效访问Token}

正确获取用户ID的写法 #

场景1：在Controller中直接获取 #

如果接口所在类继承自ControllerBase或Controller，可以直接通过内置的User对象读取：

// 读取用户唯一ID，对应旧版GetUserId()的返回值
var userId = User.FindFirstValue(ClaimTypes.NameIdentifier);

如果项目已经引入了Microsoft.AspNetCore.Identity包，也可以直接使用内置的扩展方法，写法和旧版几乎一致：

using Microsoft.AspNetCore.Identity;
// ...
string userId = User.GetUserId();

说明：User.FindFirstValue(ClaimTypes.Name)读取的是当前用户的用户名，不是用户ID，这个逻辑和旧版ASP.NET的声明规则一致。

场景2：在非Controller的服务层获取 #

如果需要在业务服务、自定义工具类中获取当前用户ID，不要手动构造HttpContext，通过IHttpContextAccessor获取即可：

1. 先在Program.cs中注册访问器：

builder.Services.AddHttpContextAccessor();

2. 在自定义服务中注入使用：

public class OrderService
{
    private readonly IHttpContextAccessor _contextAccessor;
    // 构造函数注入
    public OrderService(IHttpContextAccessor contextAccessor)
    {
        _contextAccessor = contextAccessor;
    }

    public string? GetCurrentUserId()
    {
        var httpContext = _contextAccessor.HttpContext;
        // 先判断是否认证通过，避免空引用
        if (httpContext?.User.Identity?.IsAuthenticated != true)
        {
            return null;
        }
        return httpContext.User.FindFirstValue(ClaimTypes.NameIdentifier);
    }
}

排查指引 #

如果按上述配置后仍然无法获取ID，直接在读取ID的代码处打断点，检查User.Identity.IsAuthenticated的返回值：

• 如果返回false，优先排查认证方案配置是否正确（比如JWT的密钥、Issuer、Audience参数是否和Token签发时一致，Cookie认证的域名、过期时间配置是否正确）
• 如果返回true，遍历User.Claims集合查看实际存储用户ID的声明类型，部分自定义认证方案可能不会把用户ID存在ClaimTypes.NameIdentifier对应的声明节点下，找到对应声明类型读取即可。

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