Akka Http 是否支持识别 JVM 全局代理配置？

核心结论 #

Akka Http 默认不会识别JVM的全局代理系统属性，这是你配置http.proxyHost、http.socksProxyHost等参数后仍然抛出java.net.NoRouteToHostException的根本原因。

原因说明 #

Akka Http客户端底层基于独立的Netty网络栈实现，没有复用JDK内置的HttpURLConnection相关网络逻辑，因此JDK层面的全局代理配置对其完全不生效。你遇到的无路由错误本质是请求没有走代理、直接尝试直连目标地址导致的网络连通失败。

解决方案 #

方案1：通过Akka配置文件设置代理（无需修改业务代码） #

你可以直接在项目的application.conf配置文件中添加Akka Http客户端的代理规则，无需调整业务逻辑代码，配置示例如下：

akka.http.client.proxy {
  # HTTP请求代理配置
  http {
    host = "你的代理服务地址"
    port = 代理服务端口
  }
  # HTTPS请求代理配置
  https {
    host = "你的代理服务地址"
    port = 代理服务端口
  }
  # SOCKS代理配置（需要用SOCKS代理时开启）
  # socks {
  #   host = "你的SOCKS代理地址"
  #   port = 代理服务端口
  # }
  # 配置不需要走代理的地址列表，支持通配符
  non-proxy-hosts = ["localhost", "127.0.0.1", "*.your-internal-domain.com"]
}

方案2：代码中读取JVM系统参数自动注入Akka配置 #

如果你希望直接复用已设置的JVM全局代理参数，可以在初始化ActorSystem时统一读取系统属性，注入到Akka配置中，仅需修改启动逻辑、无需调整业务请求代码，Scala示例如下：

// 读取JVM全局代理参数
val httpProxyHost = System.getProperty("http.proxyHost")
val httpProxyPort = System.getProperty("http.proxyPort", "8080").toInt
val httpsProxyHost = System.getProperty("https.proxyHost", httpProxyHost)
val httpsProxyPort = System.getProperty("https.proxyPort", httpProxyPort.toString).toInt

// 拼装Akka代理配置
val proxyConfig = ConfigFactory.parseString(s"""
  akka.http.client.proxy.http.host = "$httpProxyHost"
  akka.http.client.proxy.http.port = $httpProxyPort
  akka.http.client.proxy.https.host = "$httpsProxyHost"
  akka.http.client.proxy.https.port = $httpsProxyPort
""")

// 初始化ActorSystem时加载配置
val system = ActorSystem("your-app-system", proxyConfig.withFallback(ConfigFactory.load()))

Java实现逻辑完全一致，读取系统属性后拼装配置即可。

注意：如果使用的Akka Http版本低于10.1.x，部分代理配置键可能存在差异，可对照对应版本的配置规则做调整。

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