FastEndpoints.AspVersioning在多Web应用测试中的并发问题解析与解决方案

背景介绍

在ASP.NET Core应用开发中，FastEndpoints框架因其高性能和简洁性受到开发者青睐。当项目需要同时支持多版本API时，FastEndpoints.AspVersioning扩展提供了便捷的版本控制功能。然而，在进行多Web应用工厂(WAF)并行测试时，开发者可能会遇到非并发集合修改导致的异常问题。

问题现象

在集成测试环境中，当同时运行4-5个Web应用工厂进行并行测试时，系统会抛出以下异常：

System.InvalidOperationException: Operations that change non-concurrent collections must have exclusive access...

异常发生在VersionSets.CreateApi()方法调用时，表明在Dictionary集合操作时发生了并发冲突。

问题根源分析

1. 集合并发问题：VersionSets内部使用普通Dictionary存储API版本信息，不支持多线程并发写入
2. 测试环境特性：XUnit的TestCollections并行执行多个测试类，每个测试类都创建独立的Web应用工厂
3. 初始化时机：各Web应用工厂在初始化时都会调用VersionSets.CreateApi()，尝试修改同一个静态字典

临时解决方案

在等待官方修复期间，可以采用锁机制临时解决问题：

private static readonly object _lock = new();
public static IServiceCollection ConfigureVersioning(this IServiceCollection services)
{
    lock (_lock)
    {
        VersionSets.CreateApi(Versions.V1, v => v.HasApiVersion(new ApiVersion(1.0)));
    }
    // 其他配置代码...
}

官方解决方案

FastEndpoints团队在v5.34.0.6-beta版本中已将内部字典替换为并发安全的ConcurrentDictionary，从根本上解决了多线程访问问题。升级后无需额外锁机制即可安全使用。

最佳实践建议

1. 版本控制配置：推荐将版本配置代码放在应用启动初期执行
2. 测试环境优化：
   • 对于共享的静态配置，考虑使用测试隔离策略
   • 评估是否所有测试都需要独立的应用工厂
3. 版本管理：合理规划API版本策略，避免过度版本化

总结

这个问题展示了在并行测试环境下静态资源配置的常见陷阱。FastEndpoints团队的快速响应体现了开源项目的优势，开发者既可以通过临时方案解决问题，也能及时获得官方修复。理解这类并发问题的本质有助于开发者在类似场景下做出更好的架构决策。

对于正在迁移到FastEndpoints的项目，建议：

1. 直接采用v5.34.0.6-beta或更高版本
2. 在测试策略中考虑资源共享问题
3. 定期关注框架更新，获取性能改进和bug修复