为什么 Akka HTTP 默认使用尽可能少的诊断信息？

Question

更多的哲学问题

我正在用 Java 中的 Akka HTTP 构建一个新的 HTTP 服务，在我的单元测试中我回来了

java.lang.AssertionError: Unexpected status code!
Expected :200 OK
Actual   :400 Bad Request
 <Click to see difference>


at akka.http.javadsl.testkit.JUnitRouteTestBase$$anon$1.reportDetails(JUnitRouteTest.scala:47)
at akka.http.javadsl.testkit.JUnitRouteTestBase$$anon$1.assertEquals(JUnitRouteTest.scala:30)
at akka.http.javadsl.testkit.TestRouteResult.assertEqualsKind(TestRouteResult.scala:227)
at akka.http.javadsl.testkit.TestRouteResult.assertStatusCode(TestRouteResult.scala:136)
at com.mastercard.pci.enclave.ServerTest.testTokenize(ServerTest.java:48)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at org.junit.runners.model.FrameworkMethod$1.runReflectiveCall(FrameworkMethod.java:50)
at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
at org.junit.runners.model.FrameworkMethod.invokeExplosively(FrameworkMethod.java:47)
at org.junit.internal.runners.statements.InvokeMethod.evaluate(InvokeMethod.java:17)
at org.junit.internal.runners.statements.RunBefores.evaluate(RunBefores.java:26)
at org.junit.rules.ExternalResource$1.evaluate(ExternalResource.java:48)
at org.junit.rules.RunRules.evaluate(RunRules.java:20)
at org.junit.runners.ParentRunner.runLeaf(ParentRunner.java:325)
at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:78)
at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:57)
at org.junit.runners.ParentRunner$3.run(ParentRunner.java:290)
at org.junit.runners.ParentRunner$1.schedule(ParentRunner.java:71)
at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
at org.junit.runners.ParentRunner.access$000(ParentRunner.java:58)
at org.junit.runners.ParentRunner$2.evaluate(ParentRunner.java:268)
at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
at org.junit.runner.JUnitCore.run(JUnitCore.java:137)
at com.intellij.junit4.JUnit4IdeaTestRunner.startRunnerWithArgs(JUnit4IdeaTestRunner.java:68)
at com.intellij.rt.execution.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:47)
at com.intellij.rt.execution.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:242)
at com.intellij.rt.execution.junit.JUnitStarter.main(JUnitStarter.java:70)
Caused by: java.lang.AssertionError: Unexpected status code! expected:<200 OK> but was:<400 Bad Request>
at org.junit.Assert.fail(Assert.java:88)
at org.junit.Assert.failNotEquals(Assert.java:834)
at org.junit.Assert.assertEquals(Assert.java:118)
at akka.http.javadsl.testkit.JUnitRouteTestBase$$anon$1.$anonfun$assertEquals$1(JUnitRouteTest.scala:30)
at scala.runtime.java8.JFunction0$mcV$sp.apply(JFunction0$mcV$sp.java:12)
at akka.http.javadsl.testkit.JUnitRouteTestBase$$anon$1.reportDetails(JUnitRouteTest.scala:44)
... 29 more

这绝不解决为什么这是Bad Request 的问题？

在研究了 Akka HTTP 'Rejections' 之后，似乎没有简单的方法可以说“Akka，告诉我你为什么拒绝请求！”

在我看来，启动 Akka 项目的默认操作应该是最大诊断，并且随着您接近生产状态，您配置的诊断越少。但是，Akka 的默认设置是提供最低限度的诊断，让您无休止地研究以找出问题所在。

很抱歉，这看起来有点啰嗦，但我真正的问题是为什么 Akka 开箱即用地提供如此少的诊断？

Answer 1

我认为除了图书馆的主要贡献者之外，任何人都无法准确回答此类问题。 “为什么”需要创造者的意图。但是，我会尝试破解它......

“为什么这是一个错误的请求？”

特定的HttpRequest 与akka 中指定的Route 不匹配的原因有很多。举几个例子：

1. 请求的Path 可能不匹配任何路径匹配器。
2. 请求的"Accept Encoding" 标头可能不匹配 服务器能够执行的压缩方案。
3. request method 可能有误。
4. ...

更糟糕的是，Route 创建者可以通过多种方式组合需求。例如，如果路由定义为

val route = 
  post {
    path("only" / "match" / "post" / "request") {
      complete("good post request")
    }
  } ~ 
  get {
    path("only" / "match" / "get / "request") {
      complete("good get request")
    }
  }

如果客户端发送带有路径"/only/match/post/request" 的GET 怎么办？那么诊断信息应该说请求的方法错误或路径错误吗？两个都是真的，两个都是假的！

诊断信息

服务器创建者有责任提供“诊断”信息：

val route = 
  get {
    complete("good user, only get requests are matched")
  } ~ 
  complete(405 -> "bad user, only get requests are matched")

我同意你的说法，即这个问题“有点啰嗦”。这个问题似乎类似于以下问题：“为什么 akka 不为我编写服务器？”