从ASP.NET Web Forms向Web API Controller提交时出现404错误

我来帮你排查这个404问题，这类错误大多和路由配置、控制器设置或者表单提交路径不匹配有关，咱们一步步来解决：

1. 补全Web API路由配置 #

你提供的Global.asax.vb里MapHttpRoute代码不完整，这很可能是核心问题。完整的Web API默认路由需要明确指定路由模板、控制器、动作和可选参数。把你的路由配置改成这样：

RouteTable.Routes.MapHttpRoute(
    name:="DefaultApi",
    routeTemplate:="api/{controller}/{action}/{id}",
    defaults:=New With { .id = RouteParameter.Optional }
)

这里的api/前缀是关键，它用来区分Web API路由和普通MVC路由，避免冲突；{action}则允许你通过URL指定要调用的控制器动作，适合表单提交的场景。

2. 确认控制器继承正确的基类 #

你的Web API控制器必须继承自System.Web.Http.ApiController，而不是MVC的Controller类。比如：

Imports System.Web.Http
Imports System.Web.Http.ModelBinding

Public Class FormApiController
    Inherits ApiController

    <HttpPost> ' 标记这是POST请求的动作
    Public Function SubmitForm(<FromBody> formData As YourFormModel) As IHttpActionResult
        ' 处理表单数据的逻辑
        Return Ok("表单提交成功")
    End Function
End Class

这里的<HttpPost>特性明确告诉Web API这个动作只响应POST请求，<FromBody>则用来从请求体中获取表单数据（如果用强类型模型的话）。

3. 确保表单提交的URL匹配路由 #

假设你的控制器是FormApiController，动作是SubmitForm，那表单的action属性应该设置为/api/FormApi/SubmitForm。注意：

• 不要漏掉api/前缀
• 控制器名称要去掉末尾的Controller（比如FormApiController对应URL里的FormApi）

4. 检查表单提交方式与动作特性匹配 #

如果你的表单是用method="post"提交的，那对应的Web API动作必须要么标记<HttpPost>特性，要么动作名称以Post开头（比如PostSubmitForm），这样Web API才能正确匹配到对应的处理方法。

5. 验证路由注册顺序 #

在Application_Start方法里，确保Web API的路由注册在MVC路由之前（如果你的项目同时有MVC的话），避免路由匹配优先级问题。比如：

Sub Application_Start(sender As Object, e As EventArgs)
    ' 先注册Web API路由
    RouteTable.Routes.MapHttpRoute(
        name:="DefaultApi",
        routeTemplate:="api/{controller}/{action}/{id}",
        defaults:=New With { .id = RouteParameter.Optional }
    )
    ' 再注册MVC路由（如果有的话）
    RegisterRoutes(RouteTable.Routes)
    BundleConfig.RegisterBundles(BundleTable.Bundles)
End Sub

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