如何在BCL中添加端点或捕获请求检查路径，实现通用环境接口？

核心思路是让类库仅依赖轻量的抽象包，将ASP.NET Core相关的注册逻辑委托给宿主项目，避免直接引用Microsoft.AspNetCore.App.Ref这类重型包，同时实现接口逻辑的复用。

方案1：基于Minimal API扩展方法（推荐） #

这种方式符合ASP.NET Core现代开发模式，代码简洁且依赖最轻量。

1. 类库配置 #

创建类库项目后，安装两个轻量NuGet包：

• Microsoft.Extensions.Hosting.Abstractions：提供环境信息的抽象接口IHostEnvironment
• Microsoft.AspNetCore.Http.Abstractions：提供端点路由的基础抽象

2. 类库核心代码 #

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Hosting;

namespace EnvironmentEndpointLib;

public static class EnvironmentEndpointExtensions
{
    public static IEndpointRouteBuilder MapEnvironmentEndpoint(this IEndpointRouteBuilder app)
    {
        app.MapGet("/api/environment", (IHostEnvironment env) => 
        {
            return Results.Ok(new 
            {
                EnvironmentName = env.EnvironmentName,
                IsDevelopment = env.IsDevelopment(),
                IsProduction = env.IsProduction(),
                IsStaging = env.IsStaging()
            });
        });
        
        return app;
    }
}

3. 宿主项目使用 #

在ASP.NET Core项目的Program.cs中引用类库，调用扩展方法注册端点：

var app = builder.Build();

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

app.MapEnvironmentEndpoint(); // 注册类库提供的环境接口

app.Run();

方案2：基于自定义中间件 #

如果需要更底层的请求拦截逻辑，可以用中间件方式实现：

1. 类库核心代码 #

using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Hosting;
using System.Text.Json;

namespace EnvironmentEndpointLib;

public class EnvironmentMiddleware
{
    private readonly RequestDelegate _next;
    private readonly IHostEnvironment _env;

    public EnvironmentMiddleware(RequestDelegate next, IHostEnvironment env)
    {
        _next = next;
        _env = env;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        if (context.Request.Path == "/api/environment" && context.Request.Method == HttpMethods.Get)
        {
            var envInfo = new 
            {
                EnvironmentName = _env.EnvironmentName,
                IsDevelopment = _env.IsDevelopment(),
                IsProduction = _env.IsProduction(),
                IsStaging = _env.IsStaging()
            };
            
            context.Response.ContentType = "application/json";
            await context.Response.WriteAsync(JsonSerializer.Serialize(envInfo));
            return;
        }

        await _next(context);
    }
}

public static class EnvironmentMiddlewareExtensions
{
    public static IApplicationBuilder UseEnvironmentEndpoint(this IApplicationBuilder app)
    {
        return app.UseMiddleware<EnvironmentMiddleware>();
    }
}

2. 宿主项目使用 #

在Program.cs中调用中间件扩展：

var app = builder.Build();

app.UseEnvironmentEndpoint(); // 注册环境检测中间件

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

app.Run();

关键说明 #

• 两种方案都仅依赖轻量抽象包，不会引入完整的ASP.NET Core运行时栈
• 类库只封装核心逻辑，具体的HTTP请求处理由宿主项目的ASP.NET Core框架完成
• 可直接在任意ASP.NET Core项目中引用该类库，一行代码即可启用/api/environment接口

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