含泛型类型的Web API端点无法访问返回404的解决方案咨询

你的端点返回404主要有两个核心问题：路由模板与请求URL不匹配，以及泛型方法在Web API路由中的兼容性问题。下面是具体的排查和修复步骤：

1. 修正路由匹配问题 #

你的请求URL是domain/api/Users/AddTwoInputs/1/2，但当前方法的路由属性[HttpGet("{number1}/{number2}")]并没有包含方法名AddTwoInputs。默认情况下，Web API的路由不会自动把方法名加入到路由路径中，除非你显式指定。

修复方式： #

在方法的HttpGet属性中添加方法名，确保路由模板和请求URL一致：

[AllowAnonymous]
[HttpGet("AddTwoInputs/{number1}/{number2}")] // 显式加入方法名
[IgnoreAntiforgeryToken]
// 先调整方法为非泛型，解决泛型兼容问题
public IActionResult AddTwoInputs(int number1, int number2)
{
    return Ok(number1 + number2);
}

同时确认你的UsersController上有正确的路由前缀：

[Route("api/[controller]")]
[ApiController]
public class UsersController : ControllerBase
{
    // 你的方法在这里
}

调整后，路由就会匹配api/Users/AddTwoInputs/1/2这个请求URL了。

2. 解决泛型方法的路由兼容性问题 #

Web API的路由系统无法从URL中推断泛型类型参数T，这会导致即使路由路径匹配，也无法正确找到并调用你的泛型方法，最终可能还是返回404或者参数绑定失败。

替代方案： #

方案A：使用具体数值类型（推荐）

直接指定参数的具体类型，比如int、double，这是Web API端点的常规写法，路由和模型绑定都会更稳定：

[AllowAnonymous]
[HttpGet("AddTwoInputs/{number1:int}/{number2:int}")]
[IgnoreAntiforgeryToken]
public IActionResult AddTwoInputs(int number1, int number2)
{
    return Ok(number1 + number2);
}

如果需要支持多种数值类型，可以创建重载方法，并通过路由约束区分：

// 处理整数
[HttpGet("AddTwoInputs/{number1:int}/{number2:int}")]
public IActionResult AddTwoInts(int number1, int number2)
{
    return Ok(number1 + number2);
}

// 处理浮点数
[HttpGet("AddTwoInputs/{number1:double}/{number2:double}")]
public IActionResult AddTwoDoubles(double number1, double number2)
{
    return Ok(number1 + number2);
}

方案B：动态处理输入（如果需要灵活类型）

如果你确实需要接受任意数值类型，可以将参数设为string，然后在方法内部解析转换，同时处理格式错误：

[AllowAnonymous]
[HttpGet("AddTwoInputs/{number1}/{number2}")]
[IgnoreAntiforgeryToken]
public IActionResult AddTwoInputs(string number1, string number2)
{
    if (double.TryParse(number1, out var a) && double.TryParse(number2, out var b))
    {
        return Ok(a + b);
    }
    return BadRequest("请输入有效的数字格式");
}

额外检查点 #

• 确认你的控制器继承自ControllerBase（ASP.NET Core）或者ApiController（ASP.NET Framework），这是Web API控制器的基类，缺少的话会导致路由无法识别。
• 清理Postman的缓存，确保请求没有使用旧的路由配置；或者直接在浏览器中访问该URL，测试是否能正常返回结果。

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