在Asp.net Core的启动类（通常是Startup类）中，Configure方法是用于配置应用HTTP请求管道的核心方法，它定义了应用如何处理每一个进入的HTTP请求，是整个应用请求处理流程的关键入口。
Configure方法的基本特性
Configure方法由运行时自动调用，它的参数中通常包含IApplicationBuilder对象，我们可以借助这个对象向请求管道中添加中间件。需要注意，Configure方法没有返回值，且不能在其中编写阻塞性的长时间运行逻辑，否则会影响应用启动效率。
与ConfigureServices方法的区别
很多开发者会混淆Configure方法和ConfigureServices方法的作用，两者的核心差异如下：
| 方法名称 | 核心作用 | 调用时机 |
|---|---|---|
| ConfigureServices | 注册应用所需的各类服务到依赖注入容器 | 先于Configure方法执行 |
| Configure | 配置请求管道，添加中间件定义请求处理流程 | 在ConfigureServices执行完成后执行 |
Configure方法的常见使用场景
1. 添加异常处理中间件
我们可以在请求管道的最前端添加异常处理中间件，捕获后续中间件抛出的异常并返回友好的错误响应，避免异常直接暴露给用户。
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
// 开发环境使用开发者异常页
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
// 非开发环境使用自定义异常处理
app.UseExceptionHandler("/Error");
app.UseHsts();
}
}
2. 启用静态文件服务
如果应用需要提供静态文件（如CSS、JS、图片等），可以通过UseStaticFiles中间件实现，该中间件会直接处理静态文件请求，不需要走到后续的MVC路由逻辑。
public void Configure(IApplicationBuilder app)
{
// 启用静态文件服务，默认处理wwwroot目录下的文件
app.UseStaticFiles();
}
3. 配置路由与端点
对于MVC或者Web API应用，我们需要在请求管道的末尾配置路由规则，将请求映射到对应的控制器和Action。通常在添加完所有中间件后，再调用UseEndpoints定义路由。
public void Configure(IApplicationBuilder app)
{
app.UseRouting();
// 配置路由端点
app.UseEndpoints(endpoints =>
{
// 映射控制器路由
endpoints.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
// 映射Razor页面路由
endpoints.MapRazorPages();
});
}
4. 添加身份验证与授权中间件
如果应用需要身份验证和授权功能，需要先添加认证中间件，再添加授权中间件，确保请求经过身份校验后再处理业务逻辑。
public void Configure(IApplicationBuilder app)
{
// 启用身份验证中间件
app.UseAuthentication();
// 启用授权中间件
app.UseAuthorization();
}
中间件添加顺序的注意事项
请求管道中中间件的添加顺序非常重要，因为请求会按照添加顺序依次经过每个中间件，响应则会按照相反的顺序返回。一般需要遵循以下顺序：
- 异常处理中间件放在最前面，确保能捕获后续所有中间件的异常
- 静态文件中间件放在路由中间件之前，避免静态文件请求走不必要的路由逻辑
- 身份验证、授权中间件放在路由端点之前，确保请求到达端点前已经完成身份校验
- 端点中间件（UseEndpoints）放在最后，作为请求管道的终点
如果顺序错误，可能会导致功能异常，比如把授权中间件放在路由后面，就会出现未授权的请求也能访问到端点的情况。
总结
Configure方法是Asp.net Core启动类中定义请求处理流程的核心方法，通过向IApplicationBuilder添加不同的中间件，我们可以灵活定制应用的请求处理能力，实现异常处理、静态文件服务、路由、身份验证等各类功能。掌握Configure方法的作用和中间件的使用规则，是开发Asp.net Core应用的基础，也能帮助我们更高效地解决请求处理相关的各类问题。
Asp_net_CoreConfigure方法启动类中间件请求管道修改时间：2026-06-28 00:48:27