如何配置Jetty Server v12以提供CSS和JavaScript文件服务

你遇到的核心问题是：自定义Handler对所有请求强制返回text/html的Content-Type，导致CSS/JS等静态资源被浏览器识别为HTML文件，触发MIME类型不匹配的错误。

Jetty提供了专门处理静态资源的组件，推荐优先使用官方组件来托管CSS/JS，避免手动处理MIME类型和文件读取逻辑。

方案1：使用ResourceHandler托管静态资源目录 #

这是最简洁的方式，专门用于处理静态文件请求：

import org.eclipse.jetty.server.Server;
import org.eclipse.jetty.server.handler.HandlerList;
import org.eclipse.jetty.server.handler.ResourceHandler;
import org.eclipse.jetty.util.resource.Resource;
import java.nio.file.Paths;

public class JettyServerSetup {
    public static void main(String[] args) throws Exception {
        // 1. 配置静态资源处理器
        ResourceHandler resourceHandler = new ResourceHandler();
        // 设置静态文件所在的根目录（替换为你的实际路径，比如src/main/resources/static）
        resourceHandler.setBaseResource(Resource.newResource(Paths.get("path/to/your/static/files")));
        // 可选：设置默认欢迎页
        resourceHandler.setWelcomeFiles(new String[]{"index.html"});

        // 2. 你的自定义业务Handler（处理HTML路由或业务请求）
        Handler customHandler = new YourCustomHandler();

        // 3. 组合处理器：先尝试静态资源请求，再交给自定义Handler
        HandlerList handlerList = new HandlerList();
        handlerList.addHandler(resourceHandler);
        handlerList.addHandler(customHandler);

        // 4. 启动Server
        Server server = new Server(8080);
        server.setHandler(handlerList);
        server.start();
        server.join();
    }
}

方案2：用ContextHandler划分路径（适用于多路径场景） #

如果静态资源和业务请求分属不同路径（比如静态资源在/app/static/*，业务在/app/*），可以用上下文隔离：

import org.eclipse.jetty.server.Server;
import org.eclipse.jetty.server.handler.ContextHandler;
import org.eclipse.jetty.server.handler.HandlerCollection;
import org.eclipse.jetty.server.handler.ResourceHandler;
import org.eclipse.jetty.util.resource.Resource;
import java.nio.file.Paths;

public class JettyContextSetup {
    public static void main(String[] args) throws Exception {
        // 静态资源上下文
        ContextHandler staticContext = new ContextHandler("/app/static");
        ResourceHandler staticHandler = new ResourceHandler();
        staticHandler.setBaseResource(Resource.newResource(Paths.get("path/to/static/files")));
        staticContext.setHandler(staticHandler);

        // 业务请求上下文
        ContextHandler customContext = new ContextHandler("/app");
        customContext.setHandler(new YourCustomHandler());

        // 组合上下文
        HandlerCollection handlers = new HandlerCollection();
        handlers.addHandler(staticContext);
        handlers.addHandler(customContext);

        // 启动Server
        Server server = new Server(8080);
        server.setHandler(handlers);
        server.start();
        server.join();
    }
}

方案3：在自定义Handler中手动处理MIME类型（不推荐） #

如果必须在自定义Handler中处理静态资源，需要根据文件后缀匹配正确的MIME类型：

import org.eclipse.jetty.http.HttpHeader;
import org.eclipse.jetty.http.MimeTypes;
import org.eclipse.jetty.server.Request;
import org.eclipse.jetty.server.Response;
import org.eclipse.jetty.server.handler.AbstractHandler;
import jakarta.servlet.ServletException;
import java.io.IOException;

public class YourCustomHandler extends AbstractHandler {
    @Override
    public void handle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException {
        baseRequest.setHandled(true);
        
        // 根据文件后缀设置正确的Content-Type
        if (target.endsWith(".css")) {
            response.setContentType(MimeTypes.Type.TEXT_CSS_UTF_8.toString());
        } else if (target.endsWith(".js")) {
            response.setContentType(MimeTypes.Type.APPLICATION_JAVASCRIPT_UTF_8.toString());
        } else {
            // 默认返回HTML类型
            response.setContentType(MimeTypes.Type.TEXT_HTML_UTF_8.toString());
        }
        
        response.setStatus(200);
        // 读取对应文件内容写入响应（此处需自行实现文件读取逻辑）
        // Content.Sink.write(response, true, fileContent, callback);
    }
}

• 优先使用Jetty官方提供的ResourceHandler，它会自动处理MIME类型、缓存、文件读取等细节，减少出错概率。
• 确保静态资源路径配置正确，Jetty会根据setBaseResource的路径去查找文件。

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