.NET Core 3.1跨类库共享IHttpContextAccessor获取用户会话方案咨询

你的问题核心是避免业务类库依赖Web项目的基础设施（比如IHttpContextAccessor），同时能获取登录用户的信息。完全可以实现，这里提供两种常用的解耦方案：

方案1：抽象用户上下文接口（推荐） #

这种方式通过定义共享的抽象接口，让Web项目实现具体逻辑，业务类库只依赖抽象层，彻底解耦。

步骤1：创建共享核心类库 #

新建一个不依赖任何Web组件的类库（比如YourApp.Core），在里面定义：

// 抽象用户上下文接口
public interface IUserContext
{
    UserSession GetCurrentUser();
}

// 自定义用户会话模型
public class UserSession
{
    public string UserDisplayName { get; set; }
    // 按需添加其他声明字段，比如UserID、角色等
    // public string UserId { get; set; }
}

步骤2：在Web项目中实现接口 #

在你的API项目（YourApp.Api）里，实现IUserContext，利用IHttpContextAccessor获取用户信息：

public class HttpUserContext : IUserContext
{
    private readonly IHttpContextAccessor _httpContextAccessor;

    public HttpUserContext(IHttpContextAccessor httpContextAccessor)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public UserSession GetCurrentUser()
    {
        var httpUser = _httpContextAccessor.HttpContext?.User;
        if (httpUser == null)
        {
            return null; // 或抛出未授权异常，根据业务需求处理
        }

        return new UserSession
        {
            UserDisplayName = httpUser.Identity?.Name,
            // 示例：提取用户ID声明
            // UserId = httpUser.FindFirstValue(ClaimTypes.NameIdentifier)
        };
    }
}

步骤3：注册依赖注入 #

在Startup.cs的ConfigureServices中注册服务：

services.AddHttpContextAccessor();
services.AddScoped<IUserContext, HttpUserContext>();

步骤4：业务类库中使用 #

业务服务类库（YourApp.Business）只需要引用YourApp.Core，就可以通过依赖注入使用IUserContext：

public class ExampleBusinessService
{
    private readonly IUnitOfWork _unitOfWork;
    private readonly IUserContext _userContext;

    public ExampleBusinessService(IUnitOfWork unitOfWork, IUserContext userContext)
    {
        _unitOfWork = unitOfWork;
        _userContext = userContext;
    }

    public void ProcessBusinessTask()
    {
        var currentUser = _userContext.GetCurrentUser();
        if (currentUser == null)
        {
            // 处理未登录的情况
            throw new UnauthorizedAccessException("用户未登录");
        }

        // 使用currentUser做业务逻辑，比如记录操作人
        _unitOfWork.Logs.Add(new OperationLog
        {
            OperatorName = currentUser.UserDisplayName,
            OperationTime = DateTime.UtcNow
        });
        _unitOfWork.SaveChanges();
    }
}

方案2：控制器层传递用户信息 #

如果业务逻辑比较简单，或者你希望更明确地控制用户信息的传递，可以在控制器中先提取用户信息，再作为参数传给业务服务方法：

控制器代码： #

[ApiController]
[Route("api/[controller]")]
public class ExampleController : ControllerBase
{
    private readonly ExampleBusinessService _businessService;

    public ExampleController(ExampleBusinessService businessService)
    {
        _businessService = businessService;
    }

    [HttpPost("process")]
    public IActionResult ProcessTask()
    {
        // 直接从Controller的User属性获取信息（无需IHttpContextAccessor）
        var userSession = new UserSession
        {
            UserDisplayName = User.Identity?.Name,
            // UserId = User.FindFirstValue(ClaimTypes.NameIdentifier)
        };

        // 传递给业务服务
        _businessService.ProcessBusinessTask(userSession);
        return Ok();
    }
}

业务服务代码： #

public class ExampleBusinessService
{
    private readonly IUnitOfWork _unitOfWork;

    public ExampleBusinessService(IUnitOfWork unitOfWork)
    {
        _unitOfWork = unitOfWork;
    }

    public void ProcessBusinessTask(UserSession currentUser)
    {
        if (currentUser == null)
        {
            throw new UnauthorizedAccessException("用户未登录");
        }

        // 业务逻辑处理
        _unitOfWork.Logs.Add(new OperationLog
        {
            OperatorName = currentUser.UserDisplayName,
            OperationTime = DateTime.UtcNow
        });
        _unitOfWork.SaveChanges();
    }
}

为什么原方案不行？ #

你之前的UsersService直接依赖IHttpContextAccessor，这会导致业务类库必须引用Microsoft.AspNetCore.Http包，从而和Web项目强耦合，违背了分层架构的原则（业务层应该独立于表现层）。上面的两种方案都避免了这个问题。

注意事项 #

• 使用IHttpContextAccessor时，要确保代码在请求上下文范围内执行（比如异步操作中不要脱离请求线程），否则HttpContext可能为null。
• 根据业务需求，在获取不到用户信息时，要合理处理（比如抛出异常、返回默认值等）。

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