Micronaut多端点匹配规则：特定HTTP请求的路由优先级疑问

针对你提出的两个端点匹配问题，结合Micronaut 3.2.0的路由机制，具体规则和异常情况原因如下：

核心匹配优先级规则 #

Micronaut的路由匹配基于路径段的权重计算，权重越高的路由越优先被匹配：

• 固定字面量路径段（比如/not_a_param1/、/not_a_param2/）的权重远高于路径变量（{param2}、{param3}）。
• 对于请求GET /hello/not_a_param1/not_a_param2，第二个端点getSomethingElse的路径后两段是固定字面量，权重比第一个全变量的端点更高，理论上应该始终优先匹配第二个端点。

匹配不一致的原因 #

你遇到的“有时选第一个、有时选第二个”的情况，大概率是路由注册顺序的不确定性导致的：

• Micronaut启动时会扫描并注册路由，若两个路由的权重计算出现异常（比如3.2.0版本的权重计算bug），或者类加载、注解处理的顺序不稳定（比如两个方法在不同类中，类的加载顺序受编译、部署环境影响），就会导致路由注册顺序变化。
• 当权重判定无法区分优先级时，Micronaut会按照路由注册的先后顺序选择第一个匹配的路由，从而出现匹配结果不一致的现象。

未触发多路由匹配错误的原因 #

Stack Overflow中提到的“More than 1 route matched the incoming request”错误，只有当Micronaut检测到多个权重完全相同且都匹配请求的路由时才会抛出。而你的场景中，要么权重计算存在差异（匹配器直接选了权重高的），要么3.2.0版本的匹配器逻辑是找到第一个符合条件的路由就返回，未触发多路由校验。

解决方法 #

为了避免匹配不确定性，你可以通过以下方式明确优先级：

• 在@Get注解中指定priority参数，给需要优先匹配的端点设置更高的数值（比如给getSomethingElse设置priority = 10，第一个端点设置priority = 5）：

  @Get(value = "/{param1}/not_a_param1/not_a_param2", priority = 10)
  public HttpResponse<?> getSomethingElse(String param1){
      ....
  }
  

• 调整路径设计，避免出现这种模糊匹配的场景，比如给第一个端点增加前缀或区分性路径段。

内容的提问来源于stack exchange，提问作者Open Door Logistics