从 Play 2.4 转换到 Play 2.5 时异步操作中出现 NullPointerException

Question

我正在将 Play 2.4 项目移植到 Play 2.5(.18)。我遇到了一个虚假的NullPointerException 我找不到原因。这是堆栈跟踪：

! @76g5ina3j - Internal server error, for (POST) [/.../tokens] ->

play.api.http.HttpErrorHandlerExceptions$$anon$1: Execution exception[[CompletionException: java.lang.NullPointerException]]
    at play.api.http.HttpErrorHandlerExceptions$.throwableToUsefulException(HttpErrorHandler.scala:293)
    at play.api.http.DefaultHttpErrorHandler.onServerError(HttpErrorHandler.scala:220)
    at play.api.GlobalSettings$class.onError(GlobalSettings.scala:160)
    at play.api.DefaultGlobal$.onError(GlobalSettings.scala:188)
    at play.api.http.GlobalSettingsHttpErrorHandler.onServerError(HttpErrorHandler.scala:100)
Caused by: java.util.concurrent.CompletionException: java.lang.NullPointerException
    at java.util.concurrent.CompletableFuture.encodeThrowable(CompletableFuture.java:273)
    at java.util.concurrent.CompletableFuture.completeThrowable(CompletableFuture.java:280)
    at java.util.concurrent.CompletableFuture.uniApply(CompletableFuture.java:604)
    at java.util.concurrent.CompletableFuture$UniApply.tryFire(CompletableFuture.java:577)
    at java.util.concurrent.CompletableFuture$Completion.exec(CompletableFuture.java:443)
Caused by: java.lang.NullPointerException: null
    at akka.stream.scaladsl.RunnableGraph.run(Flow.scala:350)
    at akka.stream.scaladsl.Source.runWith(Source.scala:81)
    at akka.stream.javadsl.Source.runWith(Source.scala:528)
    at akka.stream.javadsl.Source.runFold(Source.scala:539)
    at play.http.HttpEntity.consumeData(HttpEntity.java:58)

如您所见，堆栈跟踪没有对我的程序中的代码行进行任何引用，只提到了框架。我已经尽我所能追踪了。 Play 操作是使用 CompletableFuture 与 supplyAsync 和几个 thenApply() 阶段异步实现的。辅助类最终通过调用组装Result

return Controller.status(some_resultcode);

最终的 NPE 原因始于 HttpEntity.consumeData()，并在 Play 的 Scala 部分和 Akka 框架中结束。 RunnableGraph.run() 方法读取

def run()(implicit materializer: Materializer): Mat = materializer.materialize(this)

虽然这绝对超出了我对 Scala 的了解，但我的结论是，这里唯一的 null 可能是神秘的 materializer，不管它是什么。它从何而来？到底有什么好处呢？怎么可能是空的？

我试图用一个非常简单的操作重现问题：

public CompletionStage<Result> version() {
  return CompletableFuture
    .supplyAsync(()->"2")
    .thenApplyAsync(version->ok("Server v"+version));
}

不幸的是，这个操作没有问题，所以到目前为止我还没有这个问题的简化证明。

我现在有点迷茫。谁能向我解释发生了什么以及如何解决这个问题？

Answer 1

好的，找到了这个。经过深入调查后，情况有所不同。实际上，行动本身并不是问题。控制器看起来像这样：

@With(OurLogger.class)
public class OurController extends Controller {

  public CompletionStage<Result> ourAction() {
    return CompletableFuture.supplyAsync(()->...);
  }
}

问题在于包装 OurLogger。它的特点是：

public class OurLogger extends Action.Simple {
  private Result logResult(Result result) {
    System.err.println("Result body: "+
      JavaResultExtractor.getBody(result,1,null).utf8String());
  }
  public CompletionStage<Result> call(Context ctx) {
    return delegate.call(ctx)
      .thenApplyAsync(answer->logResult(answer));
  }
}

问题在于对JavaResultExtractor.getBody() 的调用。在 Play 2.4 中，它只获取两个参数。 Play 2.5 添加了第三个——这个神秘的Materializer，据我所知，它包含了一些 Akka 管道概念。在使代码在 Play 2.5 中可编译时，一位同事刚刚添加了 null 作为第三个参数 - 而正是 null 正是框架深处的 Akka 代码后来偶然发现的。

解决方案位于How to extract result content from play.mvc.Result object in play application? 的答案部分，并导致OurLogger 发生以下更改：

public class OurLogger extends Action.Simple {

  @Inject Materializer materializer;

  private Result logResult(Result result) {
    System.err.println("Result body: "+
      JavaResultExtractor.getBody(result,1,materializer).utf8String());
  }

  // call() method unchanged
}

如果 (a) Play 迁移文档提到了这个 Materializer 的东西和/或 (b) 在错误堆栈中只有最轻微的这个 getBody() 调用的提示，我会更快地发现问题首先追踪。所以这是两天的大海捞针......