Java：プロキシ経由でREST APIを呼び出す方法

社内ネットワークや閉域環境では、インターネット通信は必ずプロキシサーバ経由というケースが多くあります。
そのため、JavaでREST APIを呼び出そうとしても、

接続できない
タイムアウトする
認証エラーになる

といったトラブルに遭遇しがちです。

この記事では、Javaでプロキシ経由でREST APIを呼び出す代表的な方法を、実務向けに分かりやすく解説します。

プロキシ経由通信の仕組み（全体像）

通常の通信では、Javaアプリは直接APIサーバに接続します。
しかしプロキシ環境では、Java → プロキシ → REST API という経路になります。

そのため Java 側で、

プロキシの ホスト名
ポート番号
（必要に応じて）認証情報

を正しく設定する必要があります。

方法①：Javaのシステムプロパティで設定する（最も簡単）

HTTP / HTTPS プロキシ設定

System.setProperty("http.proxyHost", "proxy.example.co.jp");
System.setProperty("http.proxyPort", "8080");

System.setProperty("https.proxyHost", "proxy.example.co.jp");
System.setProperty("https.proxyPort", "8080");

System.setProperty("http.proxyHost", "proxy.example.co.jp");

System.setProperty("http.proxyPort", "8080");

System.setProperty("https.proxyHost", "proxy.example.co.jp");

System.setProperty("https.proxyPort", "8080");

この設定を行うと、HttpURLConnection や HttpClient など、
JVM全体の通信がプロキシ経由になります。

特徴

✅ 実装が簡単
❌ JVM全体に影響する
❌ 個別の通信で切り替えられない

方法②：HttpURLConnection でプロキシを明示指定する

サンプルコード

import java.net.*;

URL url = new URL("https://api.example.com/data");

Proxy proxy = new Proxy(
    Proxy.Type.HTTP,
    new InetSocketAddress("proxy.example.co.jp", 8080)
);

HttpURLConnection con = (HttpURLConnection) url.openConnection(proxy);
con.setRequestMethod("GET");
con.setConnectTimeout(10000);
con.setReadTimeout(10000);

int status = con.getResponseCode();
System.out.println(status);

import java.net.*;

URL url = new URL("https://api.example.com/data");

Proxy proxy = new Proxy(

Proxy.Type.HTTP,

new InetSocketAddress("proxy.example.co.jp", 8080)

);

HttpURLConnection con = (HttpURLConnection) url.openConnection(proxy);

con.setRequestMethod("GET");

con.setConnectTimeout(10000);

con.setReadTimeout(10000);

int status = con.getResponseCode();

System.out.println(status);

特徴

✅ 特定の通信だけプロキシを使える
✅ 既存コードへの影響が少ない
❌ 記述量がやや多い

方法③：Java 11 HttpClient でプロキシ設定（推奨）

Java 11 以降では HttpClient が標準化され、
モダンで読みやすいコードが書けます。

サンプルコード

import java.net.*;
import java.net.http.*;

HttpClient client = HttpClient.newBuilder()
        .proxy(ProxySelector.of(
                new InetSocketAddress("proxy.example.co.jp", 8080)))
        .build();

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://api.example.com/data"))
        .GET()
        .build();

HttpResponse<String> response =
        client.send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

import java.net.*;

import java.net.http.*;

HttpClient client = HttpClient.newBuilder()

.proxy(ProxySelector.of(

new InetSocketAddress("proxy.example.co.jp", 8080)))

.build();

HttpRequest request = HttpRequest.newBuilder()

.uri(URI.create("https://api.example.com/data"))

.GET()

.build();

HttpResponse<String> response =

client.send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

特徴

✅ 現在の主流
✅ 非同期通信も可能
✅ プロキシ指定が明確
🔥 新規開発では最有力

プロキシ認証（ID / パスワード）が必要な場合

Basic認証付きプロキシ対応例

Authenticator.setDefault(new Authenticator() {
    @Override
    protected PasswordAuthentication getPasswordAuthentication() {
        return new PasswordAuthentication(
                "proxyUser",
                "proxyPassword".toCharArray()
        );
    }
});

Authenticator.setDefault(new Authenticator() {

@Override

protected PasswordAuthentication getPasswordAuthentication() {

return new PasswordAuthentication(

"proxyUser",

"proxyPassword".toCharArray()

);

}

});

※ 社内プロキシでは必須になることが非常に多い設定です。

よくあるエラーと原因

エラー内容	主な原因
Connection timed out	プロキシ未設定 / ポート違い
407 Proxy Authentication Required	認証情報未設定
SSLHandshakeException	HTTPSプロキシ or 証明書問題
UnknownHostException	DNSがプロキシ経由で解決されていない

社内・閉域環境での実務ポイント

プロキシ設定は OS / JVM / Javaコード のどこで行っているか整理する
HTTPS通信時は 社内証明書 のインポートが必要な場合あり
バッチサーバ・JP1実行時は 起動ユーザーの環境変数にも注意

まとめ

Javaでプロキシ経由のREST API通信は 正しい設定が必須
Java 11以降なら HttpClient + ProxySelector が最もおすすめ
認証付きプロキシは Authenticator設定を忘れない
社内ネットワークでは 証明書・実行環境差分 に要注意

日	月	火	水	木	金	土
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

プロキシ経由通信の仕組み（全体像）

方法①：Javaのシステムプロパティで設定する（最も簡単）

HTTP / HTTPS プロキシ設定

特徴

方法②：HttpURLConnection でプロキシを明示指定する

サンプルコード

特徴

方法③：Java 11 HttpClient でプロキシ設定（推奨）

サンプルコード

特徴

プロキシ認証（ID / パスワード）が必要な場合

Basic認証付きプロキシ対応例

よくあるエラーと原因

社内・閉域環境での実務ポイント

まとめ

関連記事

Ads by Google

　関連記事