ASP.NET Core路由匹配失败 且API Explorer出现重复路由参数

你遇到的路由匹配失败、API Explorer中出现重复路由参数的问题，根源是路由模板字符串里混入了多个不可见的零宽空格字符。

这类字符大多是从网页、PDF、聊天窗口复制粘贴代码时不经意带进来的，在代码编辑器中完全不可见，肉眼看上去和正常书写的{intakeId}没有任何区别，但路由解析器会把这些隐形字符识别成路由模板的组成部分：

• 解析得到的路由参数名根本不是纯文本的intakeId，而是夹杂了一串零宽字符的畸形值，和合法的路由占位符结构差异极大
• 错乱的字符位置还会让路由解析器误判，把一个完整的参数段拆成多个畸形片段，这就是API Explorer里出现重复intakeId参数提示的根本原因
• 运行日志中提到的“路由段'{​​​​​​​​intakeId}​​​​​​​​'被判定无效”的报错，也能对应这个问题：这个被标记的片段本身就不是合法的路由占位符，自然无法正常匹配传入的请求路径

• 直接删除原来写的整行[Route]特性，完全手动在键盘上敲入正确的路由模板，不要复用旧代码的字符串，从根源上避免不可见字符残留。正确的写法参考：

  [Route("api/intakes/{intakeId}/employees")]
  [ApiController]
  public class EmployeesController : ControllerBase
  {
      [HttpGet]
      public async Task<IReadOnlyCollection<object>> GetEmployees([FromRoute]int intakeId)
      {
          return new[] { new { a = "asdsf", id = intakeId } };
      }
  }
  

• 写完后逐字符排查：把光标移到{和intakeId、intakeId和}的相邻位置，用方向键逐格移动确认——如果按一次方向键光标跳过了好几个字符的位置，就说明那里藏了零宽字符，按删除键清理即可。
• 注意路由模板的书写规范：不要在路由模板的开头、结尾随意添加斜杠，ASP.NET Core的路由系统会自动处理首尾斜杠的匹配，多余的斜杠反而可能引发非预期的匹配异常。
• 如果在编辑器中实在排查不到隐形字符，可以直接新建一个空的类文件，手动输入所有Controller代码，就能彻底解决粘贴带来的隐形字符问题。

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