Vertx-web路由匹配异常：路径URI与路径参数区分问题

这是个很典型的Vert.x路由匹配逻辑问题，我来给你拆解清楚：

核心原因：路由匹配的优先级与路径参数的特性 #

Vert.x Web的路由匹配有两个关键规则：

1. 注册顺序优先：路由是按照你注册的顺序逐个匹配的，只要找到第一个符合条件的路由就会停止匹配，不会继续检查后面的路由。
2. 路径参数匹配任意非空路径段：你定义的:orderId是路径参数，它会匹配任意非空的字符串——包括getOrders这种看起来像固定路径的内容。而且查询参数（比如?count=10）不会参与路径匹配，所以请求的路径部分/company/xxx/brand/xxx/order/getOrders会完全匹配第一条路由的模板/company/:companyId/brand/:brandId/order/:orderId（此时getOrders会被当作:orderId的取值）。

这就导致当你先注册第一条路由时，第二条路由的请求会被第一条“截胡”。

解决方法 #

针对这个问题，有几个常用的解决方案，你可以根据自己的场景选择：

1. 调整路由注册顺序（最推荐） #

把更具体的路由（第二条）放在前面注册。因为Vert.x会按顺序匹配，先遇到更精确的固定路径路由，就会优先匹配它，而不会走到后面的通用路径参数路由：

// 先注册具体的getOrders路由
router.get("/company/:companyId/brand/:brandId/order/getOrders")
    .handler(ctx -> {
        // 处理批量获取订单的逻辑
        ctx.response().end("Get orders list");
    });

// 再注册单个订单的路由
router.get("/company/:companyId/brand/:brandId/order/:orderId")
    .handler(ctx -> {
        String orderId = ctx.pathParam("orderId");
        ctx.response().end("Get single order: " + orderId);
    });

2. 给路径参数添加正则约束 #

如果你希望:orderId只能匹配特定格式（比如数字），可以给路径参数加上正则表达式限制，这样getOrders就不会被匹配到了：

// 限制:orderId只能是数字
router.get("/company/:companyId/brand/:brandId/order/:orderId(\\d+)")
    .handler(ctx -> {
        String orderId = ctx.pathParam("orderId");
        ctx.response().end("Get single order: " + orderId);
    });

// 再注册getOrders路由，顺序不影响了（当然还是建议放前面）
router.get("/company/:companyId/brand/:brandId/order/getOrders")
    .handler(ctx -> {
        ctx.response().end("Get orders list");
    });

3. 区分HTTP方法（如果适用） #

如果两条路由的HTTP方法不同（比如一条是GET，一条是POST），可以在注册路由时指定方法，这样即使路径类似，也不会混淆。不过看你的问题描述，应该都是GET请求，这个方法可能不适用，但可以作为扩展思路。

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