ASP.NET MVC Core Web API同模式Action路由匹配异常问题排查

让我来逐个拆解你遇到的这几个问题，都是ASP.NET Core路由和字符编码的常见坑：

问题原因分析 #

1. http://localhost/users/search/français 返回200但无内容 #

这个和路由无关，是URL特殊字符没正确编码导致的：

• 法语里的ç属于非ASCII字符，浏览器发请求时本来应该自动把它编码成%C3%A7，但如果是直接手动输入未编码的URL，服务器接收到的term参数可能会乱码或者解析不正确，导致你的_userService.Search(term)查不到任何数据，自然就返回空的200响应了。
• 你可以试试手动把URL改成http://localhost/users/search/fran%C3%A7ais再请求，应该就能拿到正常结果。

2. http://localhost/users/search?term=fra 调用了GetUserByUsername Action #

这是核心问题，完全是路由匹配逻辑和请求路径不匹配导致的：

• 你的Search Action路由模板是users/search/{term}，要求路径必须是/users/search/xxx这种带路由参数的格式，但你发的请求是/users/search?term=fra——路径只到search这一层，没有后面的路由参数片段，所以这个请求根本匹配不上Search的路由。
• 那为啥会跑到GetUserByUsername去？哦，我猜你可能在写代码时不小心把GetUserByUsername的[Route]写成了[Route("{username}")]（少了username/前缀），这样它的完整路由就变成了users/{username}——这时候/users/search会被当成username参数的值是search，自然就触发了GetUserByUsername方法。
• 另外，如果你的项目里还有其他全局路由规则（比如定义了[Route("users/{username}")]），也会导致这个请求被错误匹配。

为啥前两个请求正常？ #

• http://localhost/users/username/mmyusername 完全贴合users/username/{username}的路由模板，username参数被正确赋值成mmyusername，所以正常触发对应方法。
• http://localhost/users/search/fra 完美匹配users/search/{term}的模板，term参数拿到fra，自然就调用Search了。

解决建议 #

1. 调整Search的路由，支持查询参数：如果你想通过?term=xxx这种方式调用，把路由改成这样：

[HttpGet("search")]
public async Task<IActionResult> Search([FromQuery] string term)
{
    var response = await _userService.Search(term);
    return Ok(response);
}

这样/users/search?term=fra就能正确命中Search方法了。

2. 统一路由写法：建议直接用[HttpGet("模板")]的方式定义路由，别混用[HttpGet]和[Route]，虽然功能一样，但可读性差很多，比如：

[HttpGet("username/{username}")]
public async Task<IActionResult> GetUserByUsername(string username) { ... }

[HttpGet("search/{term}")]
public async Task<IActionResult> Search(string term) { ... }

3. 处理特殊字符编码：前端发请求时，对包含特殊字符的参数做URL编码（比如JS里用encodeURIComponent()），避免服务器解析出错。

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