ローカルデバッグ — Java
注釈:本資料はAI技術を用いて翻訳されています。
このガイドでは、Java で書かれた Extend アプリのデバッグに固有の内容を説明します。 すべての Extend アプリと言語に共通する概念(環境変数、VS Code のデバッグワークフロー、ログの読み方、よくある問題)については、 Extend ローカルデバッグガイドを参照してください。
前提条件
-
Java 17 以降 — 次のコマンドで確認します。
java --version
# 期待される結果: openjdk 17.x.x ... または以降のバージョン -
VS Code Extension Pack for Java(
vscjava.vscode-java-pack) — VS Code マーケットプレイスからインストールしてください。 -
AccelByte の認証情報 —
AB_BASE_URL、AB_CLIENT_ID、AB_CLIENT_SECRET。 メインガイドの環境設定を参照してください。
JVM リモートデバッグ
Java のテンプレートには .vscode/ フォルダーが同梱されていません。デバッグするには、ポート 5005 で待ち受ける
JVM デバッグエージェントを使ってアプリを起動します。
export $(grep -v '^#' .env | xargs)
./gradlew bootRun --debug-jvm
デバッガーが接続するまでプロセスは一時停止します。IDE のリモート JVM デバッガーを localhost:5005 にアタッチしてください。
条件付きブレークポイントの構文
ブレークポイントを右クリック → Edit Breakpoint → Java の式を入力します。例:
request.getUserId().equals("user_001")
デバッガーは条件が true の場合にのみ一時停止します。
jq を使ったログの読み方
# すべてを整形して表示
./gradlew bootRun 2>&1 | jq '.'
# ERROR 行のみ表示
./gradlew bootRun 2>&1 | jq 'select(.level == "ERROR")'
ログの形式やログレベルの概要については、メインガイドの ログの読み方と理解を参照してください。
Java 固有のトラブルシューティング
Gradle デーモンの問題
実行ごとにサービスの動作が一貫しない場合は、Gradle デーモンを停止して再試行してください。
./gradlew --stop
./gradlew bootRun
リモートデバッグ用の JVM ポート競合
--debug-jvm を実行した際にポート 5005 が既に使用されている場合:
ss -tlnp | grep 5005
使用中のプロセスを終了するか、build.gradle でデバッグポートを変更してください。
bootRun {
jvmArgs = ["-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5006"]
}
ポート競合の確認(サービスポート)
ss -tlnp | grep -E '6565|8000|8080'
古いプロセスを終了して、再度起動してください。