ASP.NET WebAPI调用ASP.NET Core API出现MapHttpRoute 404问题

根据你描述的情况，部分带多段路径参数的URL返回404，大概率是自定义DelegatingHandler的URL转发逻辑存在问题，或者目标Core API的路由配置不匹配。下面是具体的排查和解决步骤：

1. 检查自定义DelegatingHandler的URL转换逻辑 #

这是最可能出问题的地方，需要确保你正确提取了/webapi/v1/之后的完整路径和查询参数，并转发到目标Core API。

错误示例（可能导致问题） #

如果你的Handler里用了不够严谨的字符串替换，比如只处理了固定长度的路径，或者Split时截断了参数段：

protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
{
    // 错误：如果路径中有重复的"/webapi/v1/"片段，会错误替换
    var path = request.RequestUri.PathAndQuery.Replace("/webapi/v1/", "");
    var newUri = new Uri("https://core-api.example.com/" + path);
    request.RequestUri = newUri;
    return await base.SendAsync(request, cancellationToken);
}

正确的处理方式 #

使用更可靠的Uri操作来提取相对路径，避免字符串替换的潜在问题：

protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
{
    // 目标Core API的基础地址
    var targetBase = new Uri("https://your-core-api-domain/");
    // 提取原始URL中"/webapi/v1/"之后的完整相对路径
    var originalPath = request.RequestUri.PathAndQuery;
    var prefix = "/webapi/v1/";
    if (originalPath.StartsWith(prefix, StringComparison.OrdinalIgnoreCase))
    {
        var relativePath = originalPath.Substring(prefix.Length);
        // 组合成目标URI
        var targetUri = new Uri(targetBase, relativePath);
        request.RequestUri = targetUri;
        
        // 可选：添加日志调试，确认转发的URI是否正确
        Debug.WriteLine($"转发请求：原始URI={request.RequestUri} → 目标URI={targetUri}");
    }
    
    return await base.SendAsync(request, cancellationToken);
}

这种方式能确保完整保留所有路径段（包括{plantId}、{userId}等参数）和查询参数。

2. 验证目标ASP.NET Core API的路由配置 #

确认Core API中对应接口的路由模板完全匹配请求路径：

[ApiController]
[Route("webapi/v1/plants")] // 注意这里的前缀要和转发的路径一致
public class PlantsController : ControllerBase
{
    // 路由模板要完全匹配请求的路径结构
    [HttpGet("{plantId}/user/{userId}/app/{appId}/{role}")]
    public IActionResult GetPlantUserAppRole(
        int plantId, 
        int userId, 
        string appId, 
        string role) // 注意参数类型要匹配，比如role是否允许特殊字符
    {
        // 接口逻辑
        return Ok();
    }
}

如果role参数包含特殊字符（比如下划线、斜杠），需要在路由模板中添加约束允许这些字符：

[HttpGet("{plantId}/user/{userId}/app/{appId}/{role:regex(^[a-zA-Z0-9_-]+$)}")]

3. 检查ASP.NET WebAPI的路由配置冲突 #

确保WebAPI的WebApiConfig中没有定义会拦截该路径的路由规则，比如：

public static void Register(HttpConfiguration config)
{
    // 避免定义类似这样的路由，会优先匹配并拦截请求，导致无法进入DelegatingHandler
    // config.Routes.MapHttpRoute(
    //     name: "DefaultApi",
    //     routeTemplate: "webapi/v1/{controller}/{id}",
    //     defaults: new { id = RouteParameter.Optional }
    // );

    // 正确的做法是：先注册DelegatingHandler，再配置路由
    config.MessageHandlers.Add(new ApiDelegatingHandler());

    // 如果需要WebAPI自身的路由，确保不会和转发路径冲突
    config.Routes.MapHttpRoute(
        name: "WebApiLocal",
        routeTemplate: "local/{controller}/{id}",
        defaults: new { id = RouteParameter.Optional }
    );
}

要保证DelegatingHandler的注册在路由配置之前，这样请求会先经过Handler处理，再进入路由匹配。

4. 调试确认请求流向 #

在DelegatingHandler和Core API的接口中添加日志，确认：

• 请求是否真的进入了DelegatingHandler
• 转发后的URI是否正确（比如是否包含所有路径参数）
• Core API是否接收到了请求，以及接收到的路径是什么

通过这些步骤，你应该能定位到404的根源，解决路径转发的问题。

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