ASP.NET中如何将旧API路由重定向到新API路由并返回308状态码

你遇到的问题本质是返回类型和当前项目框架不匹配：你使用了System.Web.Http命名空间下的Web API路由特性，这套是ASP.NET Framework时代的Web API 2规范，RedirectResult不会被识别为系统级的重定向响应，只会被当作普通业务对象序列化为JSON返回，所以得到200状态码和JSON格式的响应体。

场景1：项目为ASP.NET Framework（传统Web API 2） #

直接构造HttpResponseMessage返回308响应即可，示例代码：

[System.Web.Http.HttpGet]
[System.Web.Http.Route("v1/getNames")]
public System.Net.Http.HttpResponseMessage Get()
{
    var response = Request.CreateResponse((System.Net.HttpStatusCode)308);
    response.Headers.Location = new Uri("/api/v2/getNames", UriKind.Relative);
    return response;
}

说明：部分旧版System.Net.Http枚举里没有PermanentRedirect对应308，直接强转int值308即可，不影响实际响应效果。

场景2：项目为ASP.NET Core MVC/Core Web API #

你误用了Framework时代的System.Web.Http特性，替换为Core原生的Mvc特性即可，原有RedirectResult写法就能生效：

using Microsoft.AspNetCore.Mvc;

[HttpGet]
[Route("api/v1/getNames")]
public IActionResult Get()
{
    // 写法1：直接调用封装好的工具方法
    return RedirectPermanentPreserveMethod("/api/v2/getNames");
    
    // 写法2：和你原有写法一致，参数含义为：重定向地址、永久重定向、保留请求方法
    // return new RedirectResult("/api/v2/getNames", permanent: true, preserveMethod: true);
}

如果你有大量v1版本的废弃接口需要统一重定向，不需要逐个编写Action，可以用全局拦截方案统一处理，以下是ASP.NET Core的中间件示例：

// Program.cs中，放在路由匹配中间件之前即可
app.Use(async (context, next) =>
{
    // 匹配所有/api/v1开头的请求
    if (context.Request.Path.StartsWithSegments("/api/v1", out var remainingPath))
    {
        // 拼接新路由
        var newPath = $"/api/v2{remainingPath}{context.Request.QueryString}";
        context.Response.StatusCode = StatusCodes.Status308PermanentRedirect;
        context.Response.Headers.Location = newPath;
        return;
    }
    await next();
});

• 308状态码默认会保留原请求的HTTP方法和请求体，适合API接口重定向场景，如果你需要兼容特别老旧的HTTP客户端，可以替换为301状态码，但301会把POST/PUT等非GET请求转为GET请求，会丢失请求体。
• 如果重定向目标是跨站点接口，需要填写完整的绝对URL路径，相对路径仅支持同站点内重定向。

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