Rubyの例外処理とエラーハンドリング

JPKODA 編集部 May 10, 2026

プログラミングにおいてエラーは避けて通れない要素です。ユーザーが無効なデータを入力したり、存在しないファイルを読み込もうとしたり、ネットワーク接続が突然切断されたりするなど、こうした予期せぬ事態はプログラムのクラッシュや予測不能な挙動を引き起こす原因となります。

堅牢（ロバスト）なアプリケーションは、これらの問題を事前に予測し、エレガントに処理できるように設計されています。これにより、プログラムの突然の終了を防ぎ、ユーザーに有益なフィードバックを提供することが可能になります。本章では、Rubyにおけるランタイムの問題を処理するためのコアメカニズムである begin...rescue ブロックについて紹介します。begin...rescue を学ぶことで、エラーが発生した瞬間にそれを「キャッチ（捕捉）」し、プログラムを直接クラッシュさせるのではなく、制御された方法で復旧させたり応答させたりする能力を身につけることができます。これは、特に前章で学んだファイルなどの外部リソースとインタラクトする際に、より弾力性がありユーザーフレンドリーなRubyアプリケーションを作成するための重要なステップです。

1. 例外（Exceptions）を理解する

エラーの処理方法を深く掘り下げる前に、私たちが「エラー」と呼んでいるものの正体を理解する必要があります。Rubyや他の多くのプログラミング言語では、これらの実行中に発生するエラーは「例外（Exceptions）」と呼ばれます。

例外とは、プログラムの実行中に発生し、通常のインストラクション（命令）の流れを中断させるイベントのことです。これはプログラムが遭遇した予期せぬ問題と言い換えられます。コードの実行自体を妨げる構文エラー（シンタックスエラー：例えば end キーワードの欠落など）とは異なり、例外はコードの実行中に発生します。例外が適切に処理されない場合、通常はプログラムが停止し、コンソールにエラーメッセージ（スタックトレースと呼ばれます）が表示されます。

よくあるシナリオをいくつか見てみましょう：

1.1 ゼロ除算

result = 10 / 0 # これにより ZeroDivisionError (ゼロ除算エラー) が発生します
puts result

このコードを実行すると、Rubyは 10 / 0 の箇所で停止し、ZeroDivisionError: divided by 0 と表示します。次の行の puts result が実行されることはありません。

1.2 無効な配列インデックスへのアクセス

my_array = [1, 2, 3]
puts my_array[5] # これは例外を発生させず、nil を返します。しかし、言語によっては境界外エラーを発生させます。
puts my_array.fetch(5) # これは IndexError (インデックスエラー) を *発生させます*

my_array[5] はエレガントに nil を返しますが、インデックス 5 が存在しない状態で fetch(5) を使用すると、IndexError: index 5 outside of array bounds: -3...3 が発生します。

1.3 存在しないファイルを開く

（これは以前学習したファイル I/O に直接関連します）

# このシナリオはファイルを扱う際によく発生します
file = File.open("non_existent_file.txt", "r")
puts file.read
file.close

もし non_existent_file.txt が存在しない場合、File.open メソッドは Errno::ENOENT: No such file or directory という例外を発生させます。これは、特にユーザーが指定したファイルパスを扱う際に、処理が必須となる極めて重要な例外です。

Rubyには例外カテゴリの階層構造があります。遭遇する可能性のある一般的な例外のほとんど、および begin...rescue がデフォルトで処理する例外は、StandardError（標準エラー）を継承しています。これには ZeroDivisionError、ArgumentError、IOError、Errno::ENOENT などが含まれます。

2. begin...rescue ブロック

begin...rescue ブロックは、Rubyが例外を処理するための基礎的な構造です。これにより、潜在的な例外を「監視（モニター）」したいコード範囲を指定できます。そのコード内で例外が発生した場合、プログラムの実行フローはクラッシュせず、特別な rescue ブロックへとジャンプします。そこでエラーに対する応答方法を定義できます。

2.1 基本的なシンタックス

最もシンプルな begin...rescue の形式は以下の通りです：

begin
  # 例外が発生する可能性のあるコード
  # ここは「保護された」エリアです
  puts "リスクのある操作を実行しようとしています..."
  result = 10 / 0 # この行で ZeroDivisionError が発生します
  puts "操作成功：#{result}" # この行は実行されません
rescue
  # 'begin' ブロック内で例外が発生した場合、ここが実行されます
  puts "エラーが発生しました！"
end

puts "エラー処理が完了し、プログラムは続行されます。"

実行フローを分解してみましょう：

Rubyインタプリタが begin ブロックに入ります。
begin ブロック内のコードを順番に実行しようとします。
例外が発生しなかった場合、rescue ブロックは完全にスキップされ、プログラムは end キーワードの後から続行されます。
begin ブロック内の任意の地点で例外が発生した場合（例：ここでの 10 / 0）、begin ブロック内の残りのコードは直ちに停止します。
Rubyインタプリタはその後ダイレクトに rescue ブロックへジャンプし、その中のコードを実行します。
rescue ブロックの実行が終わると、プログラムは end キーワード以降のコードを続行します。

上記の例では、10 / 0 が ZeroDivisionError を引き起こしました。puts "操作成功..." の行はスキップされます。プログラムは rescue ブロックへジャンプし、「エラーが発生しました！」とプリントした後、続けて「エラー処理が完了し、プログラムは続行されます。」とプリントします。

3. 例外オブジェクトへのアクセス

例外がキャッチ（rescue）されたとき、Rubyはその例外オブジェクトを利用可能な状態にします。このオブジェクトには、エラーのクラス（エラータイプ）や説明的なメッセージなど、エラーに関する貴重な情報が含まれています。rescue => e を使用することで、このオブジェクトをキャプチャできます。e は例外オブジェクトを表すための一般的な慣習ですが、任意の変数名を使用できます。

begin
  puts "除算を実行しようとしています..."
  # 存在しないファイルを開こうとしてエラーをシミュレート
  File.open("non_existent.txt", "r") # これにより Errno::ENOENT が発生します
  puts "ファイルオープン成功！"
rescue => e # 'e' に例外オブジェクトが保持されます
  puts "例外をキャッチしました！"
  puts "エラータイプ：#{e.class}"      # 例外のクラスをプリント (例: Errno::ENOENT)
  puts "エラーメッセージ：#{e.message}" # 具体的なエラー説明メッセージをプリント
end

puts "エラー処理エリアを通過し、プログラムは続行されます。"

この例では、non_existent.txt が存在しない場合、Errno::ENOENT 例外が発生します。rescue => e ブロックがそれをキャッチし、e.class と e.message を使ってエラーの詳細情報を表示できます。これらの情報は、コードのデバッグ（Debugging）やユーザーに有益なフィードバックを提供するために極めて重要です。

4. 特定のタイプの例外をキャッチする

デフォルトでは、例外クラスを指定しない rescue 句は、StandardError および StandardError を継承するすべてのクラスをキャッチします。これには一般的なランタイム例外のほとんどが含まれます。しかし、キャッチしたい例外のタイプを指定することで、エラーハンドリングをより精密にすることができます。これは、異なるタイプのエラーに対して異なる方法で対応したい場合に非常に有効です。

rescue キーワードの後に、1つ（または複数）の例外クラスを指定できます：

begin
  puts "数字を入力してください："
  input = gets.chomp
  num = Integer(input) # 入力が有効な整数でない場合、ArgumentError が発生する可能性があります
    
  puts "除数として別の数字を入力してください："
  divisor_input = gets.chomp
  divisor = Integer(divisor_input)
    
  result = num / divisor # 除数が 0 の場合、ZeroDivisionError が発生する可能性があります
  puts "結果：#{result}"
  
rescue ZeroDivisionError
  puts "エラー：ゼロで割ることはできません！"
rescue ArgumentError => e
  # ArgumentError を専門にキャッチし、そのエラー情報を取得
  puts "エラー：無効な入力です。有効な整数を入力してください。詳細：#{e.message}"
rescue => e
  # この汎用的な rescue は、上記でキャッチされなかった他のすべての StandardError をキャッチします
  puts "未知のエラーが発生しました：#{e.class} - #{e.message}"
end

puts "プログラム終了。"

この統合的なサンプルでは：

ユーザーが最初の数字の入力で "hello" と入力した場合、Integer(input) は ArgumentError を発生させます。このとき rescue ArgumentError ブロックが実行されます。
ユーザーが "5" を入力し、次に "0" を入力した場合、num / divisor は ZeroDivisionError を発生させます。このとき rescue ZeroDivisionError ブロックが実行されます。
その他の StandardError（ZeroDivisionError でも ArgumentError でもないもの）が発生した場合、汎用的な rescue => e ブロックがそれをキャッチします。予期せぬ問題をキャッチしておくことは、良いプログラミング習慣です。

重要なヒント： Rubyは rescue ブロックを上から順番にマッチングさせます。例外がより早い段階の rescue 句にマッチした場合、その句によって処理され、後続のより汎用的な例外に対する rescue 句はスキップされます。したがって、より具体的な例外タイプを前に、汎用的なものを後に配置するのが標準的なプラクティスです。

5. 実戦例とデモンストレーション

begin...rescue を実際のシナリオに適用してみましょう。特にエラーが発生しやすいファイル操作やユーザー入力のシーンです。

5.1 例 1：欠落しているファイルの処理

これまでのモジュールで、ファイルの読み書きを学びました。非常に一般的な問題は、存在しないファイルを開こうとすることです。これは Errno::ENOENT 例外を発生させます。

def read_file_content(filename)
  begin
    file = File.open(filename, "r") # 読み込み用にファイルを開く
    content = file.read            # ファイル内容を読み込む
    file.close                     # ファイルを閉じる
    puts "'#{filename}' からの読み込みに成功しました："
    puts content
    return content
  rescue Errno::ENOENT => e
    # 「ファイルまたはディレクトリが見つからない」エラー専用の rescue
    puts "エラー：ファイル '#{filename}' が見つかりませんでした。パスを確認してください。"
    puts "詳細：#{e.message}"
    return nil # 失敗を示す
  rescue IOError => e
    # 権限拒否や既にファイルが開いている状態などの一般的な I/O エラーをキャッチ
    puts "エラー：'#{filename}' の読み込み中に I/O 問題が発生しました。"
    puts "詳細：#{e.message}"
    return nil
  rescue => e
    # その他の予期せぬ StandardError をキャッチ
    puts "'#{filename}' の処理中に予期せぬエラーが発生しました："
    puts "エラータイプ：#{e.class}"
    puts "エラーメッセージ：#{e.message}"
    return nil
  end
end

puts "--- 存在するファイルを読み込もうとする ---"
# デモンストレーション用のテストファイルを作成
File.write("my_data.txt", "こんにちは、Ruby！\nこれはテストファイルです。")
read_file_content("my_data.txt")
puts "\n"

puts "--- 存在しないファイルを読み込もうとする ---"
read_file_content("non_existent_file.txt")
puts "\n"

puts "--- 権限が制限されたファイルを読み込もうとする (シミュレーション) ---"
# 'restricted.txt' は存在するが、Rubyに読み取り権限がない状況を想定します
# デモンストレーションのため、IOError の出力を手動でシミュレートします
puts "'restricted.txt' を読み込もうとしています (権限拒否による IOError の発生をシミュレート)..."
puts "権限の問題により、ファイル 'restricted.txt' (擬似) は読み込めませんでした。"

この例の read_file_content メソッドは、ファイル欠落時の Errno::ENOENT 処理、およびその他のファイル関連の問題に対する IOError 処理の方法を示しています。ファイルが存在しなくてもプログラムはクラッシュせず、エレガントにエラーメッセージをプリントします。

5.2 例 2：簡易計算機のための堅牢なユーザー入力

ユーザー入力（第七モジュール）と整数変換を再確認し、無効な入力やゼロ除算でクラッシュしない、より堅牢（堅牢）な計算機を作成してみましょう。

def perform_division
  begin
    puts "1番目の数字を入力してください："
    num1_str = gets.chomp
    num1 = Integer(num1_str) # ArgumentError の可能性があります
        
    puts "2番目の数字を入力してください："
    num2_str = gets.chomp
    num2 = Integer(num2_str) # ArgumentError の可能性があります
        
    result = num1 / num2     # ZeroDivisionError の可能性があります
    puts "#{num1} / #{num2} の結果は：#{result}"
      
  rescue ArgumentError => e
    # Integer() 変換に失敗した場合の処理 (例: 入力が "abc" など)
    puts "無効な入力です！整数のみを入力するようにしてください。"
    puts "具体的なエラー：#{e.message}"
  rescue ZeroDivisionError
    # ゼロ除算の処理
    puts "ゼロで割ることはできません！2番目の数字にはゼロ以外を入力してください。"
  rescue => e
    # その他の予期せぬ StandardError をキャッチ
    puts "計算中に予期せぬエラーが発生しました：#{e.class} - #{e.message}"
  end
end

puts "--- 1回目の試行：有効な入力 ---"
# ユーザー入力：10, 2
perform_division
puts "\n"

puts "--- 2回目の試行：無効な入力 (非整数) ---"
# ユーザー入力：hello, 5
perform_division
puts "\n"

puts "--- 3回目の試行：ゼロ除算 ---"
# ユーザー入力：10, 0
perform_division
puts "\n"

puts "--- 4回目の試行：別の有効な入力 ---"
# ユーザー入力：20, 4
perform_division
puts "\n"

このアプローチにより、プログラムはより弾力性（レジリエンス）があり、ユーザーフレンドリーなものになります。クラッシュを避けるだけでなく、問題が発生した際にユーザーに明確なガイドを提供できるためです。