如何解决REST API URL末尾传递邮箱时出现的404错误？

针对你遇到的不带斜杠访问API返回404.0、带斜杠正常的情况，可通过以下几种方式解决：

• 调整路由模板支持可选斜杠
  修改路由属性为[Route("{email}/?")]，其中/?表示末尾斜杠是可选的，这样无论URL末尾是否带斜杠，路由引擎都能正确匹配到你的GetUsers方法：

  [HttpGet]
  [Route("{email}/?")]
  public async Task<IHttpActionResult> GetUsers(string email)
  {
      // 业务代码
  }
  

• 禁用IIS静态文件模块的干扰
  IIS默认会优先尝试匹配静态文件，当你的邮箱格式（如xxx@domain.com）被IIS识别为类似静态文件的路径时，会去查找对应的物理文件，找不到就返回404。可以通过web.config配置强制让所有请求走托管模块：

  <system.webServer>
    <modules runAllManagedModulesForAllRequests="true" />
  </system.webServer>
  

  若担心全局配置影响性能，也可针对API路径单独配置：

  <system.webServer>
    <rewrite>
      <rules>
        <rule name="API Route Fix" stopProcessing="true">
          <match url="^api/.*$" />
          <action type="Rewrite" url="{R:0}" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
  

• 改用查询参数传递邮箱
  把邮箱从路由参数改为查询参数，避免路径解析的问题：

  [HttpGet]
  public async Task<IHttpActionResult> GetUsers([FromUri] string email)
  {
      // 业务代码
  }
  

  此时访问URL格式为/api/yourcontroller?email=xxx@domain.com，无需依赖末尾斜杠即可正常匹配。

• 确认属性路由已启用
  检查WebApiConfig.cs（或Startup.cs）中是否启用了属性路由，确保添加了config.MapHttpAttributeRoutes();，否则属性路由的配置不会生效：

  public static class WebApiConfig
  {
      public static void Register(HttpConfiguration config)
      {
          // 启用属性路由
          config.MapHttpAttributeRoutes();
  
          // 其他路由配置
          config.Routes.MapHttpRoute(
              name: "DefaultApi",
              routeTemplate: "api/{controller}/{id}",
              defaults: new { id = RouteParameter.Optional }
          );
      }
  }
  

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