Quarkus接口返回200 OK但响应体不完整问题排查求助

排查方向 #

• 检查Vertx分块编码相关配置
  确认application.yml中Vertx HTTP的分块参数，比如quarkus.vertx.http.max-chunk-size，默认值可能过小导致大响应被截断；同时检查是否开启了响应压缩（quarkus.http.compress.enabled），压缩后的分块处理是否存在缓冲区不足的情况。
• 验证响应体生成逻辑
  排查接口JSON生成代码：如果使用OutputStream或Vertx的HttpServerResponse写数据，确认是否存在提前关闭流、未完成flush的情况；如果用了Reactive类型（Uni/Multi），检查数据流是否正常完成，没有中途取消或抛出异常。
• 核对版本兼容性
  查看当前Quarkus版本对应的Vertx版本是否存在分块编码的已知问题，比如旧版本中处理大分块时的截断bug，可参考官方版本发布记录或问题追踪信息。
• 排查网络中间件限制
  虽然Postman、curl测试正常，但要确认部署环境中是否有反向代理、网关（如Nginx）等组件，这些中间件可能对分块响应设置了额外的大小限制，需检查其分块相关配置。

调试建议 #

• 开启Vertx调试日志
  在application.yml中添加日志配置，捕捉响应处理的细节：

  quarkus.log.category."io.vertx".level=DEBUG
  quarkus.log.category."io.quarkus.vertx".level=DEBUG
  

  查看日志中关于分块生成、缓冲区写入、flush操作的记录，排查是否有溢出、中断等异常提示。
• 本地模拟分块响应测试
  编写测试接口返回固定大小的大JSON（如10K、20K），强制开启分块编码，用代码模拟客户端请求（如Java HttpClient、Vertx WebClient），对比Postman的测试结果，定位问题是否出在服务端逻辑。
• 监听响应写入过程
  自定义Vertx响应拦截器，在数据写入前后记录字节数、分块数量，确认实际写入的总字节数是否与响应体实际大小一致，排查是否存在写入中断的情况。
• 调试底层分块逻辑
  若熟悉Vertx源码，可在本地构建Quarkus项目，断点调试VertxHttpResponse类中分块编码的处理流程，查看分块生成、发送的具体过程，定位截断发生的环节。

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