FastEndpoints v5.34 版本发布：增强任务队列与身份验证功能

项目简介

FastEndpoints 是一个高性能的 .NET Web API 开发框架，专注于简化端点(Endpoint)的创建和管理。它通过减少样板代码、提供强大的功能集和优化性能，帮助开发者快速构建高效的API服务。该框架特别适合需要高性能和简洁代码的项目。

版本亮点

任务队列进度监控

v5.34 版本引入了任务队列执行进度监控功能，这是一个重要的增强。开发者现在可以：

1. 将任务加入队列后实时监控其执行进度
2. 获取命令处理器执行过程中产生的中间结果
3. 通过作业状态管理器实现细粒度的任务状态管理

这一功能特别适合长时间运行的后台任务，开发者可以随时了解任务执行情况，而不必等待任务完全完成。

全局 JWT 创建选项支持

在身份验证方面，新版本改进了 RefreshTokenService 的配置方式：

1. 现在支持从全局配置中获取 JwtCreationOptions 默认值
2. 开发者可以在全局配置中设置签名密钥等选项
3. TokenService 配置时可以省略重复的全局设置

这种设计既保持了灵活性，又减少了重复配置，使代码更加简洁。

其他重要更新

全局响应修改器

新增的全局响应修改器功能允许开发者在所有端点响应写入前执行统一操作：

1. 可以添加公共响应头
2. 统一修改响应内容
3. 实现跨端点的响应标准化处理

Swagger 文档配置增强

在 Swagger 文档配置中，现在可以直接访问 IServiceProvider：

1. 可以在文档配置阶段解析依赖服务
2. 动态获取配置信息来设置文档属性
3. 实现更灵活的文档生成逻辑

性能优化

反射源生成器支持值解析器

1. 值解析器函数现在支持源生成
2. 减少运行时编译开销
3. 提升非STJ模型绑定的性能

字符串值解析优化

1. 简化了字符串值解析逻辑
2. 减少了不必要的内存分配
3. 避免了不必要的装箱操作

稳定性改进

任务队列优雅关闭

1. 改进了应用关闭时的任务队列处理
2. 在重试循环中至少尝试一次操作
3. 确保重要任务不会因应用关闭而丢失

单元测试修复

1. 修复了预处理器依赖注入的问题
2. 改进了 ServiceResolver 的单例实例化逻辑
3. 使单元测试更加可靠

Swagger 处理器递归问题

1. 修复了循环引用导致的潜在无限递归
2. 防止了内存泄漏风险
3. 提高了Swagger文档生成的稳定性

总结

FastEndpoints v5.34 版本在任务队列、身份验证和整体稳定性方面做出了重要改进。这些增强使框架更适合构建复杂的企业级应用，同时保持了其高性能和易用性的特点。开发者现在可以更有效地管理后台任务，更灵活地配置身份验证，并享受更稳定的开发体验。