使用Databricks Java SDK创建WorkspaceClient时代理配置未生效的问题排查

我之前在企业代理环境下用Databricks Java SDK时也碰到过一模一样的问题——设置了系统的http/https代理属性，但SDK完全没理会，照样报UnknownHost或者连接超时。后来才搞明白，Databricks Java SDK默认不会自动读取系统的代理属性，必须显式在DatabricksConfig里配置代理信息才行，咱们一步步来解决：

1. 关键问题：SDK不自动读取系统代理属性 #

你当前只设置了http.proxyHost这类系统属性，但Databricks Java SDK的底层请求客户端并不会自动拾取这些配置，包括初始化时的OIDC端点请求（就是你错误日志里提到的GET /oidc/.well-known/oauth-authorization-server），所以必须把代理配置直接传入SDK的配置对象中。

2. 修正后的代码示例 #

你需要创建ProxyConfig对象，把代理的主机、端口（如果有认证的话还要加用户名密码）显式设置到DatabricksConfig里，替代单纯依赖系统属性的方式：

public static WorkspaceClient getWorkspaceClient() throws Exception {
    // 1. 配置代理信息
    ProxyConfig proxyConfig = new ProxyConfig()
        .setHost("xyz.com")
        .setPort(8888);
    // 如果代理需要用户名密码认证，添加以下两行
    // .setUsername("your-proxy-username")
    // .setPassword("your-proxy-password");

    // 2. 配置Databricks客户端，显式传入代理
    DatabricksConfig cfg = new DatabricksConfig()
        .setHost("https://<your-databricks-workspace-host>")
        .setToken("xxx")
        .setProxy(proxyConfig); // 这一步是核心，让SDK所有请求走代理

    // 3. 初始化客户端并测试
    WorkspaceClient w = new WorkspaceClient(cfg);
    // 注意：jobs().list(null)返回的是迭代器，直接打印看不到具体内容，可遍历统计数量验证
    System.out.println("#Jobs: " + w.jobs().list(null).stream().count());
    return w;
}

3. 额外排查点 #

• 确认代理的协议：如果你的代理是HTTP协议（即使目标Databricks是HTTPS），ProxyConfig.setHost只需要填主机名，不需要加http://前缀，SDK会自动处理。
• 检查代理白名单：有些企业代理会限制外部域名，需要确认你的Databricks workspace主机已经被加入代理的允许访问列表。
• OIDC请求验证：修正配置后，初始化时的OIDC端点请求会通过代理发送，错误日志里的Failed to get OpenID Connect endpoints应该会消失，这是代理生效的第一个信号。

为什么系统属性不生效？ #

Databricks Java SDK使用自己封装的ApiClient处理所有HTTP请求，这个客户端默认不会读取JVM的系统代理属性，必须通过DatabricksConfig.setProxy()显式注入代理配置，才能让所有请求（包括初始化阶段的OIDC请求、后续的Jobs/Pipelines操作请求）都走指定的代理。

内容来源于stack exchange