Rubyのエラー『Encoding::UndefinedConversionError: ‘X’ to ‘Y’』の解決方法

Rubyで文字エンコーディングの変換を行う際に発生する『Encoding::UndefinedConversionError: ‘X’ to ‘Y’』のエラーについて、発生条件と解決策を詳しく説明する。

このエラーは、あるエンコーディングから別のエンコーディングに変換する際に、変換できない文字が含まれている場合に発生する。

str = "こんにちは"
puts str.encode("ISO-8859-1")
# Encoding::UndefinedConversionError: "こんにちは" from UTF-8 to ISO-8859-1

対象の文字列のエンコーディングを確認することで、問題の原因を特定できる。

str = "こんにちは"
puts str.encoding # => UTF-8

UTF-8 から ISO-8859-1 への変換はできないが、UTF-8 から Shift_JIS や EUC-JP なら変換できる。

str = "こんにちは"
puts str.encode("Shift_JIS")
puts str.encode("EUC-JP")

変換できない文字を「?」や「_」などに置き換える方法。

str = "こんにちは"
puts str.encode("ISO-8859-1", invalid: :replace, undef: :replace, replace: "?")

バイナリデータとして扱い、一旦 ASCII-8BIT に変換して処理する方法。

str = "こんにちは"
binary_str = str.encode("ASCII-8BIT")
puts binary_str.force_encoding("ISO-8859-1")

ファイルのエンコーディングを統一することで、エラーを回避できる。

File.open("example.txt", "w:utf-8") { |f| f.write("こんにちは") }

複数の異なるエンコーディングが混在している場合、全体を UTF-8 に統一する。

str = File.read("example.txt", encoding: "UTF-8")
puts str.encode("UTF-8")

システムのデフォルトエンコーディングが影響していることがある。

puts ENV['LANG']

ファイルや API から取得したデータを適切なエンコーディングに変換する。

data = File.read("example.txt", encoding: "Windows-31J").encode("UTF-8")
puts data