KotlinのAPI通信ログ出力とデバッグ方法を初心者向けに完全解説！

KotlinのAPI通信のログ出力・デバッグ方法

先生と生徒の会話形式で理解しよう

生徒

「KotlinでAPI通信をしているときに、うまくいかないことがあるんですが、原因を調べるにはどうすればいいんですか？」

先生

「そういうときは、通信の内容をログに出力して、どこで問題が起きているかを確認するのが基本です。ログを見ることで、APIのリクエストやレスポンスがどのように動いているかが分かりますよ。」

生徒

「ログってどうやって出すんですか？難しい設定が必要ですか？」

先生

「大丈夫、初心者でも簡単にできる方法があります。今回はその基本的なやり方を一緒に学んでいきましょう！」

1. API通信とログ出力の重要性とは？

API通信とは、アプリと外部サービスがデータをやり取りする仕組みのことです。例えば、天気アプリが天気情報を取得する場合、その情報はAPIを通じて取得されます。

この通信がうまくいかないとき、何が原因かを知るために使うのがログ出力（ろぐしゅつりょく）です。ログとは、通信の記録やメッセージをアプリ内に表示する仕組みです。

2. OkHttpのログ出力を有効にする方法

Kotlinでよく使われる通信ライブラリにOkHttp（オーケーエイチティーティーピー）があります。OkHttpには、リクエストやレスポンスをログに表示するLogging Interceptor（ロギング・インターセプター）という便利な機能があります。

まずは、build.gradleファイルに依存関係を追加しましょう。


implementation("com.squareup.okhttp3:logging-interceptor:4.12.0")

次に、ログを表示させるための設定を追加します。


val logging = HttpLoggingInterceptor()
logging.setLevel(HttpLoggingInterceptor.Level.BODY)

val client = OkHttpClient.Builder()
    .addInterceptor(logging)
    .build()

これで、APIの送信内容（リクエスト）や受信内容（レスポンス）がログに出力されるようになります。ログは、実行時にコンソールに表示されます。

3. ログ出力レベルの種類と意味

ログの出力レベルにはいくつか種類があり、setLevel()メソッドで設定できます。

NONE：ログ出力なし
BASIC：リクエストとレスポンスのステータスライン（成功したかどうか）だけ出力
HEADERS：ヘッダー情報も出力
BODY：ヘッダーに加えて本文（データ内容）まで全て出力

初心者のうちはBODYを使うことで、通信内容をすべて確認できて安心です。ただし、パスワードやトークンなどの機密情報も表示されるので、注意してください。

4. 実際のログ出力例

たとえば、以下のようなログが表示されます。


--> GET https://example.com/api/user
Headers:
Authorization: Bearer abcdef123456
Content-Type: application/json

<-- 200 OK https://example.com/api/user (500ms)
Content-Type: application/json
Response Body: {"name":"Taro","age":25}

このログを見ることで、どのURLにアクセスして、どんなデータを送って、何の結果が返ってきたのかを確認できます。

5. エラー時のログを使ったデバッグ方法

通信がうまくいかないとき、ログにはヒントがたくさんあります。たとえば、404 Not Foundという表示が出たら「存在しないURLにアクセスしている」という意味です。

また、401 Unauthorizedは「認証が必要なのにトークンが間違っている」などのエラーです。エラーの数字にはそれぞれ意味があるので、ログを読むだけで多くの原因がわかります。

つまり、ログはエラーメッセージの宝庫なのです。

6. Android Studioでログを確認するには？

Kotlinの開発では、Android Studio（アンドロイド・スタジオ）という開発ツールを使うことが多いです。ログは、画面下のLogcat（ログキャット）という部分に出力されます。

Logcatの左上にあるフィルターを「Verbose」にすると、全てのログが見えます。また、キーワードで絞り込み検索も可能です。

7. 自作ログ出力も取り入れてみよう

必要に応じて、自分でログを出すこともできます。Log.dやprintlnなどを使えば、好きなタイミングで情報を出力できます。


Log.d("MyApp", "通信開始")
Log.d("MyApp", "取得したデータ: $responseData")

これにより、自分が気になるポイントだけログを出してデバッグしやすくなります。

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

8. 実際にログを活用してAPI通信を確認しよう

API通信の挙動は目に見えないため、ログは「アプリの目」として非常に重要です。慣れてくると、ログを見るだけで問題の場所がすぐに分かるようになります。

KotlinでのAPI連携において、ログ出力とデバッグの技術を身につけることで、アプリ開発のミスを減らし、より安全で使いやすいサービスを作れるようになります。

【未経験OK】Kotlinで始めるプログラミング入門｜ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと？」という基本から、世界中で使われている最新言語Kotlin（コトリン）を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。