Jetty 9迁移至Jetty 12后MockServerHandler测试失败求助

核心问题定位 #

Jetty 12对Handler的调用契约做了根本性调整，和Jetty 9的异步模型差异极大，你遇到的超时、编码问题大概率出自以下几个点：

• 未明确声明Handler支持的InvocationType，导致Jetty用默认的NON_BLOCKING模式调度，但你的实现是同步逻辑，未处理非阻塞回调，请求一直挂起超时。
• 响应体写入时未正确绑定UTF-8编码，或未在响应头中显式声明charset，导致客户端解析时编码不一致。
• 响应未通过Callback正确通知容器处理完成，连接长期处于半开状态引发超时。

具体解决建议 #

1. 明确指定Handler的InvocationType #

Jetty 12要求Handler必须主动告知容器自身支持的调用类型，不能依赖默认行为。如果你的MockServerHandler是同步处理请求，直接在实现中指定BLOCKING类型：

public class MockServerHandler extends Handler.Abstract {
    @Override
    public InvocationType getInvocationType() {
        return InvocationType.BLOCKING; // 明确声明同步阻塞处理
    }

    @Override
    public boolean handle(Request request, Response response, Callback callback) throws Exception {
        try {
            // 显式设置响应类型与编码
            response.getHeaders().put(HttpHeader.CONTENT_TYPE, "application/json;charset=UTF-8");
            
            // 用UTF-8编码写入响应体
            String responseBody = "{\"msg\":\"测试内容\"}";
            byte[] bodyBytes = responseBody.getBytes(StandardCharsets.UTF_8);
            response.getHeaders().put(HttpHeader.CONTENT_LENGTH, bodyBytes.length);
            
            OutputStream output = response.getOutputStream();
            output.write(bodyBytes);
            output.flush();
            
            callback.succeeded(); // 通知容器请求处理完成
        } catch (Exception e) {
            callback.failed(e); // 处理失败时触发错误回调
        }
        return true;
    }
}

如果必须使用NON_BLOCKING模式，需确保响应写入是异步操作，且全程通过Callback触发状态变更，否则请求会一直处于等待状态。

2. 修复UTF-8编码校验问题 #

• 必须在响应头中显式设置Content-Type的charset=UTF-8，Jetty 12不会像旧版本那样默认补全编码信息。
• 写入响应体时，强制使用StandardCharsets.UTF_8编码字符串，绝对不能依赖平台默认编码。
• 若使用ResponseWriter，需明确指定编码：

ResponseWriter writer = ResponseWriter.get(response);
writer.setEncoding(StandardCharsets.UTF_8.name());
writer.write("UTF-8编码的响应内容");
writer.flush();

3. 严格遵守请求完成契约 #

Jetty 12中所有请求处理必须通过Callback通知容器完成状态：

• 处理成功时调用callback.succeeded()
• 处理失败时调用callback.failed(Throwable)
  如果遗漏这一步，容器会判定请求仍在处理中，连接会挂起直至超时。

4. 超时问题额外排查点 #

• 检查测试链路中是否有过滤器或其他Handler拦截请求，导致响应未正确传递。
• 若测试用了HttpClient，确保客户端的读取超时设置与服务器端处理逻辑匹配，避免客户端超时阈值过短。

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