ASP.NET控制器本地正常，部署Service Fabric集群报404的原因与解决

问题原因 #

1. Service Fabric环境的应用基路径差异
   本地运行时，ASP.NET Core默认以根路径（/）作为应用的基地址，类级路由[Route("api/MyAPI")]和方法级路由[Route("GetData")]会拼接成/api/MyAPI/GetData，和访问URL完全匹配。但部署到Service Fabric集群后，服务通常会被配置为在非根路径的基地址下运行——比如Service Fabric反向代理会自动给每个服务请求添加服务名称作为路径前缀，或者服务自身的端点配置了特定路径前缀。此时类级路由的前缀会和这个基路径叠加，形成/[服务基路径]/api/MyAPI/GetData，而你访问的是/api/MyAPI/GetData，自然会出现404。

2. 路由拼接受基路径影响
   当使用类级+方法级的拆分路由时，ASP.NET Core会严格按照基路径+类路由+方法路由的顺序拼接最终路径；而直接在方法上配置完整路由时，路由规则是基于根路径的，不受应用基路径变化的影响，所以在两种环境下都能正确匹配。

解决方法 #

方法1：显式配置应用基路径 #

在ASP.NET Core的启动代码（比如Program.cs）中，指定应用的基路径，让它和Service Fabric中服务暴露的路径前缀匹配：

var builder = WebApplication.CreateBuilder(args);

// 根据集群中服务的实际暴露路径调整此处的基路径
builder.WebHost.UsePathBase("/api/MyAPI");

// 其他服务配置...

var app = builder.Build();

// 启用路径中间件，确保基路径生效
app.UsePathBase("/api/MyAPI");

// 注册路由、控制器等中间件...
app.Run();

配置完成后，类级路由可以改为[Route("")]，或者保留原类级路由，此时拼接后的路径会和你的访问URL完全一致。

方法2：调整Service Fabric服务端点配置 #

修改服务的ServiceManifest.xml文件，将服务端点的路径改为根路径，避免额外的前缀干扰：

<Resources>
  <Endpoints>
    <!-- 移除原路径配置，直接监听根路径 -->
    <Endpoint Name="ServiceEndpoint" Protocol="http" Port="80" />
  </Endpoints>
</Resources>

如果使用了Service Fabric反向代理，同时要确保反向代理的路径重写规则不会给请求添加额外前缀，让请求直接转发到服务的根路径。

方法3：保留方法级完整路由（快速方案） #

如果需要快速恢复服务可用，可以继续使用你已经验证有效的方式——移除类级路由，在方法上直接配置完整的路由规则：

[HttpGet, HttpPost, Route("api/MyAPI/GetData")]
public async Task<MyResponse> GetData()
{
    // 方法逻辑不变
}

这种方式的路由规则不依赖应用基路径，在本地和集群环境下都能正常工作。

内容的提问来源于stack exchange，提问作者atprra