如何消除ActorSystem启动时的Akka 501 PROXY请求警告？

问题原因 #

这条警告是因为你的Akka HTTP服务器收到了使用PROXY方法的HTTP请求，而Akka HTTP默认不支持这个非标准HTTP方法，因此返回501状态码并输出警告日志。你提到开启AWS ACL所有端口后问题消失，说明之前的ACL规则限制了正常流量路径，导致某些流量（比如AWS内部健康检查、反向代理探测请求）以异常的PROXY请求形式发送到你的服务端口。

解决方案 #

1. 直接过滤该特定警告日志 #

如果不需要处理PROXY请求，只是想消除这条日志，可以通过Akka的日志过滤配置直接丢弃该WARN级消息。在你的Akka配置中添加以下内容：

akka {
  # 保留原有配置，新增日志过滤规则
  event-filter {
    warn {
      message = "Illegal request, responding with status '501 Not Implemented': Unsupported HTTP method: PROXY"
      action = "drop"
    }
  }
}

2. 为Akka HTTP添加PROXY方法支持 #

如果你的业务场景需要处理PROXY方法请求，可以扩展Akka HTTP的方法支持：
首先定义自定义的PROXY方法：

import akka.http.scaladsl.model.HttpMethods

val PROXY = HttpMethods.registerCustom("PROXY")

然后在路由中添加对应的处理逻辑：

import akka.http.scaladsl.server.Directives._
import akka.http.scaladsl.model.StatusCodes

val serviceRoute = route {
  // 匹配需要处理PROXY请求的路径
  path("your-target-path") {
    method(PROXY) {
      // 自定义处理逻辑，示例返回200 OK
      complete(StatusCodes.OK)
    }
  } ~
  // 保留原有路由规则
  get {
    complete("Service is running")
  }
}

配置后Akka HTTP会正常处理PROXY请求，不再输出501警告。

3. 从根源排查AWS流量（推荐） #

开启所有ACL端口只是临时解决，更合理的方式是定位流量来源并调整ACL规则：

• 检查AWS负载均衡器的健康检查配置，确保使用的是你的服务支持的HTTP方法（如GET、POST），而非PROXY
• 开启VPC流量日志，定位发送PROXY请求的来源IP，确认是AWS内部服务还是外部流量，然后调整ACL规则仅开放必要端口和合法流量

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