ABP框架OpenIddict模块本地化移除原因及默认消息覆盖方法问询

一、为何移除本地化功能？ #

OpenIddict的错误消息遵循OAuth2.0与OpenID Connect规范的标准化定义，这类消息本质是面向开发者的系统级提示，而非直接展示给终端用户的交互文本。标准化的消息格式能保证跨系统、跨服务的兼容性，避免因本地化翻译差异导致的错误解析问题。

另外，ABP团队的设计思路是将终端用户可见的认证错误展示控制权交给应用层：开发者应在应用中捕获OpenIddict的错误代码，再结合业务场景自定义本地化后的用户提示，而非依赖模块内置的本地化逻辑。因此移除了模块内的本地化实现，简化模块核心逻辑的同时，给予开发者更灵活的自定义空间。

二、如何覆盖默认消息？ #

有以下几种常用方案：

• 通过OpenIddict事件拦截修改消息
  在模块的ConfigureServices方法中，配置OpenIddict服务器选项，拦截错误处理事件并替换默认描述：

  Configure<OpenIddictServerOptions>(options =>
  {
      options.AddEventHandler<OpenIddictServerEvents.ProcessErrorContext>(context =>
      {
          // 根据错误类型替换为自定义消息
          if (string.Equals(context.Error, OpenIddictConstants.Errors.InvalidGrant, StringComparison.Ordinal))
          {
              context.Response.ErrorDescription = "您提供的授权凭证无效，请重新尝试";
          }
          else if (string.Equals(context.Error, OpenIddictConstants.Errors.InvalidClient, StringComparison.Ordinal))
          {
              context.Response.ErrorDescription = "客户端身份验证失败";
          }
          return Task.CompletedTask;
      });
  });
  

• 结合ABP本地化系统自定义用户提示
  不在OpenIddict层面修改原始消息，而是在应用的API或页面中，捕获OpenIddict返回的错误代码，通过ABP的ILocalizationManager获取对应语言的本地化文本，再展示给终端用户。例如在API过滤器中处理：

  public class OpenIddictErrorFilter : IAsyncActionFilter
  {
      private readonly ILocalizationManager _localizationManager;
  
      public OpenIddictErrorFilter(ILocalizationManager localizationManager)
      {
          _localizationManager = localizationManager;
      }
  
      public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
      {
          var resultContext = await next();
          if (resultContext.Result is ObjectResult objectResult && objectResult.Value is ProblemDetails problemDetails)
          {
              if (!string.IsNullOrEmpty(problemDetails.Detail))
              {
                  // 根据错误代码获取本地化消息
                  var localizedMessage = await _localizationManager.GetStringAsync("YourResourceName", problemDetails.Detail);
                  problemDetails.Detail = localizedMessage;
              }
          }
      }
  }
  

  记得在模块中注册这个过滤器：

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

• 自定义OpenIddict错误处理器
  继承OpenIddict的错误处理相关类，重写消息生成逻辑，替换为自定义内容或结合ABP本地化系统生成消息。这种方式适合需要深度定制错误处理流程的场景。

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