如何在OpenIddict 5.0中自定义端点/路由检测？原3.x方法已失效

OpenIddict 5.x重构了端点匹配逻辑，原OpenIddictServerEvents.MatchEndpoint事件已被移除，替代方案主要有两种：自定义端点路由器，或利用请求预处理事件实现需求。

一、自定义端点路由器（推荐用于多Token端点场景） #

OpenIddict 5.x通过IOpenIddictServerRouter接口处理端点匹配，你可以实现该接口或继承默认实现OpenIddictServerRouter来扩展逻辑：

1. 编写自定义路由器类：

public class CustomOpenIddictServerRouter : OpenIddictServerRouter
{
    public CustomOpenIddictServerRouter(
        IOptionsMonitor<OpenIddictServerOptions> options,
        ILoggerFactory loggerFactory,
        IOpenIddictServerDispatcher dispatcher,
        IOpenIddictServerFactory factory)
        : base(options, loggerFactory, dispatcher, factory)
    {
    }

    public override async ValueTask<OpenIddictServerEndpoint?> MatchAsync(HttpContext context)
    {
        // 可选：先执行默认匹配逻辑，保留原有端点规则
        var defaultEndpoint = await base.MatchAsync(context);

        // 自定义匹配规则：新增一个Token端点路径
        if (context.Request.Path.StartsWithSegments("/api/custom-token", StringComparison.OrdinalIgnoreCase) &&
            context.Request.Method.Equals(HttpMethods.Post, StringComparison.OrdinalIgnoreCase))
        {
            return new ValueTask<OpenIddictServerEndpoint?>(
                new OpenIddictServerEndpoint(OpenIddictServerEndpointNames.Token));
        }

        // 匹配前查看请求数据：比如读取表单参数做额外判断
        if (defaultEndpoint is not null)
        {
            var clientId = context.Request.Form["client_id"].FirstOrDefault();
            // 根据业务需求对client_id做校验或路由调整
        }

        return defaultEndpoint;
    }
}

2. 在DI容器中替换默认路由器：

services.AddOpenIddict()
    .AddServer(options =>
    {
        // 配置原有服务器选项（如授权码流、客户端验证等）
        options
            .AllowPasswordFlow()
            .AllowClientCredentialsFlow()
            .SetTokenEndpointUris("/connect/token");
    })
    // 替换为自定义路由器
    .ReplaceService<IOpenIddictServerRouter, CustomOpenIddictServerRouter>(ServiceLifetime.Singleton);

二、利用请求预处理事件（适合匹配前查看/校验请求数据） #

如果仅需在端点匹配前检查请求数据，无需修改路由规则，可使用OpenIddictServerEvents.ValidateRequest事件（5.x中负责请求预处理的核心事件）：

services.AddOpenIddict()
    .AddServer(options =>
    {
        // 原有服务器配置...
        options.AddEventHandler<OpenIddictServerEvents.ValidateRequest>(builder =>
        {
            builder.AddNotification(async context =>
            {
                // 访问请求数据：路径、表单、查询参数等
                var requestPath = context.HttpContext.Request.Path;
                var clientSecret = context.HttpContext.Request.Form["client_secret"].FirstOrDefault();

                // 根据数据做校验，不符合则直接拒绝请求
                if (string.IsNullOrEmpty(clientSecret))
                {
                    context.Reject(
                        error: OpenIddictConstants.Errors.InvalidClient,
                        description: "客户端密钥不能为空。");
                }
            });
        });
    });

三、补充说明 #

• 自定义路由器适合需要新增端点、修改原有路由规则的场景，灵活性更高；
• ValidateRequest事件在所有端点处理流程的早期触发，适合做全局请求校验或数据预处理；
• 自定义路由器时，优先调用base.MatchAsync(context)可保留OpenIddict默认的端点匹配逻辑，避免破坏原有功能。

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