カテゴリ: Kotlin 更新日: 2026/07/02

Kotlinのrethrow(例外の再送出)の使い方を初心者向けに解説!catchで処理してから再度スローする方法

Kotlinの例外処理におけるrethrow(例外の再送出)の使い方
Kotlinの例外処理におけるrethrow(例外の再送出)の使い方

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

生徒

「Kotlinのcatchってエラーを捕まえて終わりですよね?」

先生

「たしかに普通はそうですが、一度処理してから再び投げることもできるんですよ。それをrethrow(リスロー)といいます。」

生徒

「えっ、投げるってどういう意味ですか?」

先生

「プログラムに『このエラーを上の処理に戻して!』と伝えることを“投げる”と言います。詳しく説明しますね!」

1. Kotlinのrethrow(例外の再送出)とは?初心者向けに概念を解説

1. Kotlinのrethrow(例外の再送出)とは?初心者向けに概念を解説
1. Kotlinのrethrow(例外の再送出)とは?初心者向けに概念を解説

Kotlin(コトリン)でプログラミングをしていると、予期せぬエラー(例外)が発生してアプリが止まってしまうことがあります。通常はtry-catchを使ってそのエラーを捕まえ、アプリが落ちないように「安全に処理」します。

しかし、中には「ここでエラーが起きたことを記録(ログ出力)だけしておいて、実際の解決策はもっと詳しい別の場所に任せたい」という場面が出てきます。これを、一度キャッチしたボールを再び投げる様子に例えて、rethrow(リスロー:例外の再送出)と呼びます。

イメージで理解しよう!
料理中に「コンロの火がつかない」というトラブル(例外)が起きたとします。
1. catch: 自分で説明書を読んで直そうとする(その場で解決)。
2. rethrow: 「火がつかない!」とメモに残したあと、専門の修理業者(上位のプログラム)に連絡して任せる。

まずは、プログラミングが初めての方でも分かりやすい簡単なイメージコードを見てみましょう。


fun checkStove() {
    try {
        // エラーが発生する可能性がある処理(例:火がつかない)
        throw Exception("コンロが故障しています")
    } catch (e: Exception) {
        // 一度ここでエラーを捕まえて、メモ(ログ)を書く
        println("【現場のメモ】エラーが発生しました: ${e.message}")

        // 再びエラーを投げて(rethrow)、修理業者(上の処理)に知らせる
        throw e
    }
}

この仕組みを使うことで、「エラーの記録」と「エラーの解決」を役割分担できるようになります。コードの品質を高め、大規模なアプリ開発でもミスを防ぐために欠かせない、プロの現場でも必須のテクニックです。

2. 例外を再送出(rethrow)する基本構文とメリット

2. 例外を再送出(rethrow)する基本構文とメリット
2. 例外を再送出(rethrow)する基本構文とメリット

Kotlinでエラーが発生した際、その場でログを記録しつつ、さらに上位の処理へエラーを通知したい場合があります。これを「例外の再送出(リスロー)」と呼びます。やり方は非常にシンプルで、catchブロックの中で受け取った例外オブジェクトを再びthrowするだけです。

初心者向けのポイント:
「ここでは一旦メモだけ取っておくから、実際の解決(アプリを止めるか等)はリーダー(呼び出し元)に任せるよ!」という役割分担ができるようになります。

プログラミングが初めての方でも分かりやすいよう、数字の変換エラーを例に見てみましょう。


fun riskyOperation() {
    try {
        // 文字列 "abc" は数字に変換できないためエラーが発生します
        val number = "abc".toInt()
    } catch (e: NumberFormatException) {
        // 1. まずはこの場所でエラーが起きたことを記録(ログ出力)
        println("【ログ】変換に失敗しました。詳細: ${e.message}")

        // 2. 発生したエラーをそのまま外側(呼び出し元)へ投げ返す
        throw e 
    }
}

このコードの動きは以下の通りです。まずtoInt()で失敗すると、catchブロックが動いてエラー内容を表示します。その直後、throw eを実行することで、この関数を呼び出した側の処理に「やっぱりエラーだったよ」とバトンを渡しています。これにより、特定の関数だけで問題を隠さず、システム全体で正しくエラー管理ができるようになります。

3. 実行例:上位の関数で再送出された例外をキャッチする

3. 実行例:上位の関数で再送出された例外をキャッチする
3. 実行例:上位の関数で再送出された例外をキャッチする

「例外を再送出(スロー)する」とは、発生したエラーをその場で解決せず、呼び出し元の関数へバトンタッチすることを指します。これにより、エラーの記録(ログ出力)は現場で行い、具体的な後始末(ユーザーへの通知など)は上位の関数で行うといった、役割分担が可能になります。

プログラミング未経験の方でも分かりやすいよう、文字列を数字に変換しようとして失敗する(NumberFormatException)ケースを例に、具体的なコードを見てみましょう。


// エラーが発生する可能性がある関数
fun riskyOperation() {
    try {
        // 文字列 "abc" は数字に変換できないため、ここでエラーが発生します
        val number = "abc".toInt()
    } catch (e: NumberFormatException) {
        // ① まずは関数の中でエラーを検知し、ログを記録します
        println("ログ出力:riskyOperation内でエラーを検知しました -> ${e.message}")
        
        // ② 「throw」を使って、エラーを呼び出し元のmain関数へ投げ返します(再送出)
        throw e
    }
}

fun main() {
    try {
        // 関数を呼び出します
        riskyOperation()
    } catch (e: NumberFormatException) {
        // ③ 再送出されたエラーをここで最終的にキャッチします
        println("main関数:再送出されたエラーを受け取り、適切に処理しました。")
    }
}

ログ出力:riskyOperation内でエラーを検知しました -> For input string: "abc"
main関数:再送出されたエラーを受け取り、適切に処理しました。

このサンプルでは、riskyOperationの中で一度エラーを捕まえてログを表示したあと、throw eを実行してエラーを外側に放り出しています。それを外側のmain関数がしっかりと受け止めているのが分かりますね。

このように例外の再送出を活用することで、プログラムのどこで問題が起きても、「どこで記録し、どこで解決するか」を柔軟にコントロールできるようになります。これが、大規模な開発でもエラーに強いシステムを作るための第一歩です。

4. なぜrethrow(例外の再送出)が必要なのか?

4. なぜrethrow(例外の再送出)が必要なのか?
4. なぜrethrow(例外の再送出)が必要なのか?

例外を再送出(rethrow)する最大の理由は、「エラーが起きたことだけは記録したいけれど、どう対処するかはもっと上の立場の人に決めてほしい」という状況があるからです。

これを日常生活に例えると、会社の「受付窓口」のようなイメージです。

  • 現場(関数内):「トラブルが起きました!」という事実をログ(日記)にメモする。
  • rethrow:そのトラブルの内容を、そのまま上司(呼び出し元)へ報告する。
  • 上司(上位の処理):報告を受けて、「お客様に謝罪する」か「もう一度やり直す」かを最終判断する。

もしrethrowを使わずにその場で無理やり処理を終わらせてしまうと、上の処理は「すべて順調に進んだ」と勘違いしてしまい、後から大きな矛盾が生じる原因になります。特に大規模なアプリでは、「エラー記録は現場で、ユーザーへの通知は最上位で」という役割分担が、コードを綺麗に保つための鉄則です。

プログラミング未経験の方でも分かりやすい、簡単なSwiftのサンプルを見てみましょう。


func checkInventory() throws {
    do {
        // ここでエラーが起きたと想定
        try processOrder()
    } catch {
        print("現場:在庫エラーのログを記録しました。")
        // ここでrethrow!エラーを上司(呼び出し元)に投げ返す
        throw error
    }
}

// 最終的な判断をする「上の処理」
do {
    try checkInventory()
} catch {
    print("上司:エラー報告を受けたので、画面に『在庫不足です』と表示します。")
}

このように、rethrowを使うことで「エラーの記録」と「エラーへの対策」を別々の場所で賢く分担できるようになります。これが、保守性の高い(修正しやすい)プログラムを作るための第一歩です。

5. rethrowを使うときの注意点と安全な実装方法

5. rethrowを使うときの注意点と安全な実装方法
5. rethrowを使うときの注意点と安全な実装方法

例外の再送出(rethrow)は非常に便利ですが、初心者が陥りやすい落とし穴がいくつかあります。まず大前提として、throw(投げる)対象は必ず例外オブジェクト(Exception)でなければなりません。

例えば、catchブロックで受け取った変数 e 以外の文字列や数値を間違えて投げようとすると、コンパイルエラーが発生してプログラムが動きません。あくまで「発生したエラーをそのまま上に渡す」という役割を意識しましょう。

未経験者向けポイント: rethrowした例外は、さらに「外側」の処理でキャッチされない限り、最終的にプログラムを強制終了させてしまいます。そのため、呼び出し元の関数でもtry-catchを準備しておくのが、安全なプログラミングの鉄則です。

具体的な失敗例と正しい対策を、Kotlinのサンプルコードで見てみましょう。


fun main() {
    try {
        validateAge(-5) // ここでエラーが発生
    } catch (e: Exception) {
        // rethrowされた例外を最終的にここで安全にキャッチする
        println("最終的なエラー処理: ${e.message}")
    }
}

fun validateAge(age: Int) {
    try {
        if (age < 0) {
            throw IllegalArgumentException("年齢に負の数は入力できません")
        }
    } catch (e: Exception) {
        println("ログ記録: エラーが発生しました")
        // 注意:e以外のものを投げるとエラーになります
        throw e // これが正しいrethrow
    }
}

このように、エラーを「報告(ログ出力)」しつつ、解決自体は「より適切な場所(呼び出し元)」に任せることで、プログラム全体の信頼性がグッと高まります。

6. rethrowの実用例:ファイル処理の中で使う

6. rethrowの実用例:ファイル処理の中で使う
6. rethrowの実用例:ファイル処理の中で使う

たとえば、ファイルを開くときにエラーが出る可能性がある場合、ログを残してから再送出する例です。


fun readFile() {
    try {
        throw java.io.IOException("ファイルが見つかりません")
    } catch (e: java.io.IOException) {
        println("エラーログ:${e.message}")
        throw e
    }
}

fun main() {
    try {
        readFile()
    } catch (e: java.io.IOException) {
        println("mainでファイルエラーを処理しました")
    }
}

エラーログ:ファイルが見つかりません
mainでファイルエラーを処理しました

このように、rethrowはエラーログを残しつつ、処理を上位に任せるためのテクニックとして使えます。

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

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

※ Amazon広告リンク

7. Kotlinの例外処理とrethrowを正しく使い分けよう

7. Kotlinの例外処理とrethrowを正しく使い分けよう
7. Kotlinの例外処理とrethrowを正しく使い分けよう

Kotlinでは、エラーをその場で処理するだけでなく、throwを使って再び投げることで、柔軟にエラーハンドリングができるようになります。

初心者でも使えるように、まずはログ出力 → throw → 上位でcatch、という流れを理解しておくと安心です。

関連セミナーのご案内

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

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

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

具体的な体験内容と環境

【つくるもの】
簡単な言葉を入力すると自動で返答してくれる「対話型ミニプログラム」や、計算を自動化する「便利ツール」をゼロから作成します。黒い画面に自分の書いた文字が表示される瞬間は、最高の感動体験です。

【開発環境】
プロのエンジニアが実際に使っている開発ツールIntelliJ IDEA(インテリジェイ)をインストールします。ボタン一つで日本語化し、初心者でも迷わず操作できる「魔法の設定」を一緒に行います。

この60分で得られる3つの体験

1. 自分のパソコンが「開発基地」に

プロと同じ道具を揃えることで、明日から一人でもプログラミングを続けられる環境が整います。

2. プログラミングの「仕組み」がスッキリ

「変数」や「型」といった難しい言葉も、身近な例え話で解説。モヤモヤをゼロにします。

3. 「読みやすい」から「直せる」へ

Kotlinは英語に近くて読みやすいのが特徴。自分でコードを読んで、間違いを見つけるコツも伝授します。

※本講座は、パソコン操作が不安な方でも安心して受講いただける完全マンツーマンです。あなたのペースに合わせて、一つずつ丁寧に進めていきます。

セミナー画像

Kotlinで始めるプログラミング入門|ゼロから「動く喜び」を体験

カテゴリの一覧へ
新着記事
New1
Go言語
Go言語のswitchで複雑な条件分岐を整理するテクニック
New2
Go言語
Go言語の構造体の初期化パターンとコンストラクタ的関数の書き方を徹底解説!初心者でもわかる基本と実用例
New3
Go言語
Go言語のスライスを引数に渡す際の注意点!値渡しと参照渡しをわかりやすく解説
New4
Go言語
Go言語の構造体タグ(jsonタグなど)の使い方と活用例を初心者向けにやさしく解説
人気記事
No.1
Java&Spring記事人気No1
Kotlin
Android Studioのインストール手順と初期設定を初心者向けに完全解説!
No.2
Java&Spring記事人気No2
Kotlin
Gradleファイル(build.gradle.kts)の書き方と役割をやさしく解説!Kotlin初心者向け完全ガイド
No.3
Java&Spring記事人気No3
C#
C#の歴史とは?初心者向けに誕生理由と進化の流れをわかりやすく解説
No.4
Java&Spring記事人気No4
Swift
Swift StoryboardとAuto Layout|レスポンシブUIの作り方
No.5
Java&Spring記事人気No5
Swift
Swift入門ガイド|基本構文と書き方をマスターしよう
No.6
Java&Spring記事人気No6
Go言語
Go言語で条件式を1行で書くコツ!三項演算子の代替と短縮記法
No.7
Java&Spring記事人気No7
C#
C#の開発環境構築を完全ガイド!初心者でもわかる.NET SDKのインストール方法
No.8
Java&Spring記事人気No8
Kotlin
KotlinのRoomでデータベースマイグレーションを行う基本手順を初心者向けに解説!

💻 作業効率アップに

ノートPCを縦置きしてデスクを広く。
省スペースで片づく定番スタンド

UGREEN 縦型スタンドをAmazonで見る

※ Amazon広告リンク