FastEndpoints项目中的Swagger文档配置支持IServiceProvider解析

在FastEndpoints项目的Swagger文档配置中，开发者现在可以通过DocumentOptions.Services属性获取IServiceProvider实例，这一改进使得在配置阶段能够安全地解析依赖服务。

背景与需求

在ASP.NET Core应用中，Swagger文档配置通常需要在应用启动阶段完成。传统方式下，开发者若要在配置过程中访问已注册的服务（如配置选项IOptions、日志服务等），往往需要手动构建服务提供者(BuildServiceProvider)，这种做法不仅不够优雅，还可能导致服务生命周期管理问题。

解决方案实现

FastEndpoints从v5.33.0.8-beta版本开始，通过DocumentOptions.Services属性提供了对IServiceProvider的直接访问能力。这一设计使得开发者可以在配置Swagger文档时，自然地解析所需服务，而无需绕过依赖注入系统。

使用示例

以下代码展示了如何在FastEndpoints项目中利用这一特性：

var bld = WebApplication.CreateBuilder(args);
bld.Services.Configure<YourConfigClass>(bld.Configuration.GetSection(nameof(YourConfigClass)));

bld.Services
   .SwaggerDocument(
       o =>
       {
           // 通过DocumentOptions.Services获取服务
           var conf = o.Services.GetRequiredService<IOptions<YourConfigClass>>();
           o.DocumentSettings = doc =>
                                {
                                    doc.DocumentName = conf.Value.DocName;
                                };
       })
   .AddFastEndpoints();

var app = bld.Build();
app.UseFastEndpoints()
   .UseSwaggerGen();
app.Run();

技术优势

1. 生命周期安全：避免了手动构建服务提供者可能导致的瞬时服务被意外提升为单例的问题
2. 配置灵活性：可以在文档配置阶段动态获取配置值或其他服务
3. 代码整洁性：保持了依赖注入的最佳实践，无需引入特殊处理逻辑

适用场景

这一改进特别适用于以下情况：

• 需要根据配置值动态设置Swagger文档属性
• 在文档配置阶段需要访问数据库或其他服务
• 实现基于环境或条件的差异化文档配置

总结

FastEndpoints项目通过暴露DocumentOptions.Services属性，为Swagger文档配置提供了更符合.NET Core设计模式的服务解析方式。这一改进不仅提升了开发体验，也确保了服务生命周期的正确管理，是框架向更完善方向发展的重要一步。