Javalin设置1XX系列HTTP状态码时出现挂起问题求助

Javalin并非禁止使用1XX状态码，但这类状态码的HTTP语义特性和你当前的代码逻辑冲突，才导致了无响应、套接字挂起的问题。

核心原因：1XX状态码的HTTP规范特性 #

1XX属于信息性临时响应，它的设计目的是告诉客户端"服务器已收到请求，正在处理中"，但它并不是最终响应——HTTP规范要求发送1XX状态码后，必须继续发送一个最终的非1XX响应（2XX/4XX/5XX等），且连接需要保持打开以等待后续响应。

你的代码中仅设置ctx.status(102)就直接return，相当于只发送了临时响应就中断了处理，没有后续的最终响应。这会导致：

• 服务器端的响应流未被正确关闭，连接保持挂起
• 客户端（如Postman）会一直等待最终响应，直到超时触发"套接字挂起"提示

正确使用102状态码的方式 #

如果确实需要用102表示"请求正在处理"，不能直接return，必须在异步任务完成后发送最终响应。示例代码如下：

if (!someFuture.isDone()) {
    // 发送102临时响应告知客户端
    ctx.status(102);
    // 监听异步任务完成事件，发送最终响应
    someFuture.whenComplete((result, exception) -> {
        if (exception != null) {
            ctx.status(500).result("请求处理失败");
        } else {
            ctx.status(200).result(result.toString());
        }
        // 强制刷新并关闭响应流
        ctx.res().flushBuffer();
    });
    return;
}
// 处理任务已完成的场景
ctx.status(200).result(someFuture.get().toString());

替代方案：使用符合场景的非1XX状态码 #

如果你的需求只是告知客户端"请求已接受，将异步处理"，不需要实时等待处理结果，更推荐使用202 Accepted状态码。这是HTTP规范中专门用于此类场景的最终响应，Javalin可以正常处理，不会出现挂起问题：

if (!someFuture.isDone()) {
    ctx.status(202).result("请求已接受，正在处理");
    return;
}

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