.NET Framework 4.8 VB.NET Web API路由问题：Stock接口路径传参404

核心差异原因 #

你遇到的问题本质是路由占位符与Action参数名不匹配：

• CalendarController的Action参数名（比如id）和默认路由的{id}占位符一致，所以/api/Calendar/3050能把3050绑定到id参数，匹配成功。
• StockController的Action参数是friendlyURL，但默认路由的占位符是{id}，URL里的my-product找不到对应的参数绑定，因此返回404；而查询字符串?friendlyURL=my-product是直接通过参数名匹配，不受路由占位符限制，所以能正常请求。

具体解决方案 #

方案1：修改Action参数名匹配默认路由 #

把StockController的Action参数名改成id，和默认路由的占位符对齐：

Public Class StockController
    Inherits ApiController

    Public Function GetStock(id As String) As IHttpActionResult
        ' 原逻辑中把friendlyURL替换为id即可
        Return Ok("处理逻辑：" & id)
    End Function
End Class

修改后/api/Stock/my-product就能正常匹配。

方案2：添加Stock专属路由规则 #

在Global.asax.vb的路由配置中，在默认路由之前添加Stock的专用路由，确保优先匹配：

' 先添加Stock的专属路由
config.Routes.MapHttpRoute(
    name:="StockApi",
    routeTemplate:="api/Stock/{friendlyURL}",
    defaults:=New With {.controller = "Stock", .friendlyURL = RouteParameter.Optional}
)

' 保留原默认路由
config.Routes.MapHttpRoute(
    name:="DefaultApi",
    routeTemplate:="api/{controller}/{id}",
    defaults:=New With {.id = RouteParameter.Optional}
)

这样/api/Stock/my-product会优先匹配这个路由，把my-product绑定到friendlyURL参数。

方案3：使用特性路由（推荐，更灵活） #

如果项目是Web API 2及以上（.NET Framework 4.8完全支持），可以用特性路由精准控制：

1. 在Global.asax.vb中启用特性路由（放在路由配置最前面）：

config.MapHttpAttributeRoutes()

2. 在StockController上添加路由特性：

<RoutePrefix("api/Stock")>
Public Class StockController
    Inherits ApiController

    <Route("{friendlyURL}")>
    Public Function GetStock(friendlyURL As String) As IHttpActionResult
        ' 原有逻辑保持不变
        Return Ok("产品信息：" & friendlyURL)
    End Function
End Class

这种方式无需修改全局路由，直接在控制器层面定义路由规则，更清晰易维护。

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