SparkJava端点大小写敏感问题：如何实现URL不区分大小写匹配？

遇到这种URL大小写不一致导致的路由匹配失败很常见，我给你几个实用的解决方案，你可以根据自己的场景选择：

方案1：全局修改请求URI为小写（最简单直接） #

你之前尝试过Before过滤器但没成功，大概率是没用到原生的HttpServletRequest对象。Spark的Request封装类里的uri()是只读的，但我们可以通过request.raw()获取底层的原生请求对象来修改URI：

before((request, response) -> {
    String originalUri = request.uri();
    // 将整个请求URI转成小写
    String lowerCaseUri = originalUri.toLowerCase();
    // 修改原生请求的URI，让后续路由匹配使用小写路径
    request.raw().setRequestURI(lowerCaseUri);
});

这样配置后，所有进来的请求URI都会被转成小写，只要你定义的端点是小写（比如/api/status/car），不管用户调用/api/status/CAR还是/api/status/Car，都会正确匹配到对应的路由。这个方案全局生效，适合所有端点都需要大小写不敏感的场景。

方案2：自定义路由匹配器（更灵活） #

如果你不想全局修改URI，或者需要更精细的控制，可以自定义Spark的路由匹配逻辑，让它在匹配时忽略大小写：

// 基于默认路由匹配器扩展，实现大小写不敏感匹配
Spark.routeMatcher(new RouteMatcher() {
    private final RouteMatcher defaultMatcher = new DefaultRouteMatcher();

    @Override
    public RouteMatch match(String httpMethod, String uri) {
        // 将请求URI转小写后再交给默认匹配器处理
        return defaultMatcher.match(httpMethod, uri.toLowerCase());
    }

    @Override
    public void addRoute(String httpMethod, String path, Route route) {
        // 注册路由时也将路径转小写，确保存储的路由都是小写格式
        defaultMatcher.addRoute(httpMethod, path.toLowerCase(), route);
    }
});

这个方案的好处是，你可以在match方法里添加额外逻辑（比如只对特定前缀的URI转小写），或者调整路由注册规则，比全局过滤器更灵活。

方案3：注册多大小写变体（不推荐，仅作备选） #

如果只是个别端点需要处理大小写问题，你可以手动注册所有可能的大小写变体，但这种方式扩展性很差，一旦路径复杂就会变得繁琐：

// 统一处理逻辑
private Object handleCarStatus(Request req, Response res) {
    // 你的业务逻辑
    return "Car status OK";
}

// 注册所有大小写变体
get("/api/status/car", this::handleCarStatus);
get("/api/status/CAR", this::handleCarStatus);
get("/api/status/Car", this::handleCarStatus);
// ... 其他变体

这种方式只适合非常简单的端点，不建议在复杂项目中使用。

推荐优先使用方案1或方案2，前者简单高效，后者灵活可控，基本能覆盖大部分场景。

内容的提问来源于stack exchange，提问作者Kamil Gołąbek