ABP Framework 5+版本401错误无响应体问题求助

问题场景 #

使用ABP Framework 5.x及以上版本时，请求未授权接口返回401状态码，但响应体为空；应用日志中已生成包含错误码、提示信息的RemoteServiceErrorInfo，但未返回给客户端。4.4.4及更早版本（使用IdentityServer）可正常返回错误内容，怀疑与OpenIddict替换IdentityServer有关。

解决步骤 #

1. 配置OpenIddict允许返回错误详情 #

ABP 5.x默认使用OpenIddict，其默认配置不会将详细错误返回给客户端，需手动添加事件处理器：

在模块的ConfigureServices方法中添加以下代码：

Configure<OpenIddictServerOptions>(options =>
{
    options.UseAspNetCore()
           .EnableStatusCodePagesIntegration(); // 启用状态码页面集成，确保错误响应能被处理

    // 自定义挑战上下文处理器，填充401响应体
    options.AddEventHandler<OpenIddictServerEvents.ProcessChallengeContext>(builder =>
    {
        builder.UseInlineHandler(async context =>
        {
            if (context.Response.StatusCode == StatusCodes.Status401Unauthorized)
            {
                // 从Abp的特性中获取预生成的错误信息
                var errorInfo = context.HttpContext.Features.Get<IRemoteServiceErrorInfoProvider>()?.GetErrorInfo();
                if (errorInfo != null)
                {
                    context.Response.ContentType = "application/json";
                    await context.Response.WriteAsJsonAsync(errorInfo);
                }
            }
            return default;
        });
    });
});

2. 开启Abp远程服务错误详情返回 #

确保Abp允许将错误详情发送给客户端（开发环境建议开启，生产环境按需调整）：

Configure<AbpRemoteServiceErrorOptions>(options =>
{
    options.SendExceptionsDetailsToClients = true;
    options.SendStackTraceToClients = false; // 生产环境建议关闭
});

3. 验证中间件顺序 #

在模块的OnApplicationInitialization方法中，确保异常处理中间件在认证、授权中间件之前：

public override void OnApplicationInitialization(ApplicationInitializationContext context)
{
    var app = context.GetApplicationBuilder();

    app.UseAbpExceptionHandling(); // 先处理异常
    app.UseAuthentication();
    app.UseAuthorization();

    // 其他中间件配置...
}

4. 自定义异常过滤器（备选方案） #

若上述配置不生效，可添加自定义异常过滤器直接捕获AbpAuthorizationException并返回响应：

第一步：创建过滤器类

public class AuthorizationExceptionFilter : IAsyncExceptionFilter, ITransientDependency
{
    private readonly IRemoteServiceErrorInfoProvider _errorInfoProvider;
    private readonly IJsonSerializer _jsonSerializer;

    public AuthorizationExceptionFilter(IRemoteServiceErrorInfoProvider errorInfoProvider, IJsonSerializer jsonSerializer)
    {
        _errorInfoProvider = errorInfoProvider;
        _jsonSerializer = jsonSerializer;
    }

    public async Task OnExceptionAsync(ExceptionContext context)
    {
        if (context.Exception is AbpAuthorizationException authException)
        {
            var errorInfo = _errorInfoProvider.GetErrorInfo(authException);
            context.HttpContext.Response.StatusCode = StatusCodes.Status401Unauthorized;
            context.HttpContext.Response.ContentType = "application/json";
            await context.HttpContext.Response.WriteAsync(_jsonSerializer.Serialize(errorInfo));
            context.ExceptionHandled = true;
        }
    }
}

第二步：注册过滤器

在模块的ConfigureServices方法中添加：

Configure<MvcOptions>(options =>
{
    options.Filters.Add<AuthorizationExceptionFilter>();
});

内容的提问来源于stack exchange，提问作者Usama K. Alobaidy