FastEndpoints多宿主应用中的路由冲突解决方案

在基于FastEndpoints框架开发多宿主应用时，开发人员可能会遇到一个典型的路由冲突问题：当多个独立API项目（如面向客户的API和内部管理API）部署在同一解决方案中时，即使它们位于不同项目，框架默认的自动发现机制仍可能导致路由重复注册。本文将深入分析问题成因并提供两种有效的解决方案。

问题现象与成因分析

当解决方案中存在多个Web API项目时（例如CustomerAPI和InternalAPI），每个项目都有自己的Program.cs和路由定义。若这些API中存在相同路径（如"/currencies"），在集成测试环境中同时启动多个WebApplicationFactory实例时，FastEndpoints会抛出"Duplicate routes detected"异常。

问题的核心在于：

1. FastEndpoints默认会扫描所有引用程序集进行路由自动发现
2. 即使通过o.Assemblies指定了当前程序集，框架仍可能扫描到其他项目的端点
3. 传统解决方案依赖源码生成器(SourceGenerator)，但可能引发CS0234编译错误

解决方案一：禁用自动发现+显式指定程序集

最可靠的解决方案是同时配置以下两个参数：

builder.Services.AddFastEndpoints(o => {
    o.DisableAutoDiscovery = true;  // 关键配置：禁用自动发现
    o.Assemblies = [ typeof(Program).Assembly ]; // 显式指定当前程序集
});

这种方法通过：

1. 完全关闭框架的自动发现机制
2. 仅加载显式指定的程序集
3. 确保各API项目完全独立，互不干扰

解决方案二：使用AssemblyFilter进行精细控制

对于需要更灵活控制的场景，可以使用AssemblyFilter函数：

builder.Services.AddFastEndpoints(o => {
    o.AssemblyFilter = asm => asm == typeof(Program).Assembly;
});

此方案的优势在于：

1. 保留自动发现机制的同时增加过滤条件
2. 可按需扩展过滤逻辑，支持更复杂的场景
3. 对现有代码改动较小

最佳实践建议

1. 测试策略优化：考虑为不同API项目创建独立的测试项目，避免在单个测试中同时启动多个WebApplicationFactory

2. 环境隔离：在开发和生产环境中确保各API运行在独立的进程或容器中

3. 编译问题处理：如果使用源码生成器方案，建议配置项目清理脚本自动删除bin/obj目录

4. 路由设计：即使技术可行，也应考虑为不同API添加前缀区分（如"/api/customer/currencies"和"/api/internal/currencies"）

通过以上方案，开发者可以优雅地解决FastEndpoints在多宿主环境中的路由冲突问题，同时保持各API项目的独立性和可测试性。