Jetty 12 ResourceHandler配置与MIME类型问题求助

问题1：/robots.txt和/sitemap.xml 301重定向后404 #

问题根源在于单个文件的ContextHandler配置逻辑：ContextHandler默认会将匹配路径视为目录，当请求不带斜杠的文件路径时，会自动重定向到带斜杠的路径（认为是目录访问），但你的baseResource指向的是单个文件，因此重定向后返回404。

修复步骤：

• 在singleFileHandler方法中，给ContextHandler设置setAllowNullPathInfo(true)，允许请求路径无额外path info（直接匹配文件路径）；
• 给ResourceHandler设置setFilesOnly(true)，明确只处理文件，拒绝目录访问；
• 确保ContextHandler的contextPath与映射的PathSpec一致，避免路径匹配混乱。

修改后的singleFileHandler方法：

private Handler singleFileHandler(String contextPath, String filePath) {
    ResourceHandler handler = new ResourceHandler();
    handler.setServer(jettyServer);
    handler.setFilesOnly(true); // 仅处理文件，禁止目录访问

    ContextHandler result = new ContextHandler(handler, contextPath);
    result.setAllowNullPathInfo(true); // 允许请求路径不带额外path info
    result.setBaseResourceAsString(filePath);

    return result;
}

映射代码保持原逻辑即可：

mapHandler.addMapping(PathSpec.from("/robots.txt"), singleFileHandler("/robots.txt", "resources/private/robots.txt"));
mapHandler.addMapping(PathSpec.from("/sitemap.xml"), singleFileHandler("/sitemap.xml", "resources/private/sitemap.xml"));

问题2：/files/ 无法返回Content-Type响应头 #

Jetty 12中ContextHandler会接管MIME类型的配置逻辑，你之前将MimeTypes设置在ResourceHandler上不会生效，需要将MIME配置直接绑定到ContextHandler。

修复步骤：

• 将MimeTypes.Mutable实例设置到ContextHandler的setMimeTypes方法；
• 开启ResourceHandler的setUseFileMapping(true)，让它根据文件名后缀匹配MIME类型。

修改后的/files/配置代码：

// 处理/public文件夹下的资源
ResourceHandler publicFilesHandler = new ResourceHandler();
publicFilesHandler.setServer(jettyServer);
publicFilesHandler.setDirAllowed(true);
publicFilesHandler.setUseFileMapping(true); // 开启文件后缀匹配MIME类型

MimeTypes.Mutable types = new MimeTypes.Mutable();
types.addMimeMapping("js", "text/javascript; charset=utf-8");
types.addMimeMapping("css", "text/css; charset=utf-8");
types.addMimeMapping("svg", "image/svg+xml");

ContextHandler h = new ContextHandler(publicFilesHandler, "/files");
h.setBaseResourceAsString("resources/public/");
h.setMimeTypes(types); // 将MIME配置绑定到ContextHandler
mapHandler.addMapping(PathSpec.from("/files/*"), h);

额外配置误区说明 #

1. ResourceHandler必须被ContextHandler包裹：Jetty 12重构了Handler体系，ResourceHandler依赖ContextHandler提供的资源上下文（如baseResource、MIME配置等），直接使用ResourceHandler会因缺少上下文引发空指针或资源找不到，这也是你EDIT中最简配置返回404的原因。
2. ResourceHandler#setBaseResourceAsString不生效：同样因为上下文依赖，ResourceHandler的baseResource必须通过ContextHandler设置，直接调用ResourceHandler的该方法不会生效，因为它未关联有效的资源上下文环境。

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