unsupportedencodingexceptionとは？初心者にも分かる原因と対処法ガイド共起語・同意語・対義語も併せて解説！

この記事を書いた人

高岡智則

年齢：33歳性別：男性職業：Webディレクター（兼ライティング・SNS運用担当）居住地：東京都杉並区・永福町の1LDKマンション出身地：神奈川県川崎市身長：176cm 体系：細身〜普通（最近ちょっとお腹が気になる）血液型：A型誕生日：1992年11月20日最終学歴：明治大学・情報コミュニケーション学部卒通勤：京王井の頭線で渋谷まで（通勤20分）家族構成：一人暮らし、実家には両親と2歳下の妹恋愛事情：独身。彼女は2年いない（本人は「忙しいだけ」と言い張る）

unsupportedencodingexceptionとは何か

unsupportedencodingexception は Java や Android の文字列処理 で、文字列をエンコードしたりデコードしたりする時に、指定したエンコーディングがサポートされていない場合に発生する例外です。

エンコーディングとは、文字をどのような数字の列に変換するかのルールのことです。代表的なものとして UTF-8、Shift_JIS、ISO-8859-1 などがあります。

このエラーが出るのは、エンコーディング名が間違っている、あるいは実行環境がそのエンコーディングを提供していないときです。

発生する場面

主に次のような場面で発生します。データをバイト配列から文字列に変換する処理や、文字列をバイト列にして保存する処理のとき、エンコーディングを文字列で指定するところで起きやすいです。例として getBytes(UTF-8) や new String(bytes, UTF-8) のようにエンコーディングを指定する場合が挙げられます。

原因と対処

原因	対処
誤字や未登録のエンコーディング名	正しいエンコーディング名を使い、全ての箇所で同じ名前を使用する
環境依存でサポートされていないエンコーディング	実行環境がサポートするエンコーディングを確認する。必要なら別の広く使われるエンコーディングを選ぶ
データと処理のエンコーディング不一致	データの作成時と読み出し時に同じエンコーディングを使用する
外部ライブラリの影響	ライブラリのドキュメントを確認し、推奨のエンコーディングを使用する

実務で使えるヒント

日常のプログラムでは 可能なら StandardCharsets の定数を使い、文字列としてエンコーディング名を渡さないのが安全です。例えば UTF_8 を選ぶときは UTF_8 の定数を使い、文字列のままエンコーディング名を渡すときよりもエラーが起きにくくなります。

データを扱う時は、送信側と受信側で必ず同じエンコーディングを使うルールを決めてください。Web アプリならサーバーとクライアントの双方でコンテンツタイプと文字エンコーディングを明示するのが基本です。

よくある誤解と現実

よくある誤解は、エンコーディング名が正しければエラーは起きないというものです。実際には、実行環境のサポート状況やデータの取り扱い順序、タイミングによってもエラーが生じます。UnsupportedEncodingException は名前どおりエンコーディングの不備を知らせる重要なヒントです。見慣れないエンコーディング名を発見したら、まずその名前が現在の環境で使えるかを確認しましょう。

まとめ

unsupportedencodingexception は、エンコーディング名のミスや環境差によって発生します。正しいエンコーディング名を選び、データの送受信で一貫性を保ち、標準的な手法を使うことで回避できます。将来のコードを見直す時には、エンコーディングの処理箇所を中心にエラーハンドリングとデバッグの観点でチェックしてください。

unsupportedencodingexceptionの同意語

UnsupportedEncodingException: Javaの公式クラス名。指定した文字エンコーディングがサポートされていない場合に投げられる例外です。
未対応エンコーディングの例外: 指定されたエンコーディングがプログラムで扱えないときに発生する例外を指す表現です。
サポートされていないエンコーディングの例外: エンコーディングがサポート対象外であることを示す同義表現です。
未サポートの文字エンコーディング例外: 文字エンコーディングが未サポートであることを示す表現です。
非対応エンコーディングエラー: エンコーディングが非対応であることを示すエラーを指します。
エンコーディング未対応エラー: 未対応のエンコーディングを指定した際に投げられるエラーの説明です。

unsupportedencodingexceptionの対義語・反対語

SupportedEncodingException: エンコーディングがサポートされており、エラーにならずに処理が進む状態を示す、反対の概念として使える想定名。
サポート済みエンコーディング: そのエンコーディングが公式にサポートされ、実際に利用できる状態を表します。
有効なエンコーディング: 環境がそのエンコーディングを有効と認識し、正しく文字を変換できる状態。
対応済みエンコーディング: 規格・環境がそのエンコーディングを受け入れている状態。
利用可能なエンコーディング: そのエンコーディングを用いて文字列を適切に処理できる状態。
エンコーディング互換性あり: このエンコーディングと他のエンコーディング間でデータの互換性が保たれている状態。
エンコーディングが認識済み: ランタイムがそのエンコーディング名を理解・認識している状態。
標準エンコーディング名: 多くの環境で標準として扱われるエンコーディング名を指す概念。
サポートされているエンコーディング名: 公式にサポート対象として扱われるエンコーディングの名称を指す概念。

unsupportedencodingexceptionの共起語

UnsupportedEncodingException: Javaの標準ライブラリで、指定したエンコーディング名がサポートされていない場合にスローされるチェック例外です。
文字セット: 文字を表す集合と、それをバイト表現に変換する規格・概念です。
文字エンコーディング: 文字とバイトの対応方式の総称で、データの保存や通信に使われます。
charsetName: エンコーディングの名前を表す文字列（例として UTF-8、ISO-8859-1 など）。
String#getBytes: 文字列をバイト列に変換するメソッドで、第二引数にエンコーディング名を渡すと UnsupportedEncodingException が発生することがあります。
new String(byte[], String): バイト列から文字列を作るコンストラクタで、エンコーディング名を指定する場合に例外が関係します。
byte[]: エンコーディングの結果として得られるバイトの配列です。
StandardCharsets: 標準で用意されたエンコーディングを定数として提供するクラスで、エンコーディングを安全に選ぶ手段になります。
UTF-8: Unicodeの広く使われる可変長エンコーディングで、推奨されるエンコーディングの一つです。
UTF-16: Unicodeの別の標準エンコーディングで、バイト順序マークに注意が必要な場合があります。
ISO-8859-1: Latin-1 と呼ばれる西ヨーロッパの単一バイトエンコーディングです。
Charset.forName: 文字列から Charset オブジェクトを取得するファクトリメソッド。サポート外の名前だと例外になります。
java.nio.charset.Charset: 文字エンコーディングを表す核となるクラスです。
UnsupportedCharsetException: 指定されたエンコーディングがサポートされていない場合に投げられるランタイム例外です。
IllegalCharsetNameException: エンコーディング名の形式が不正な場合に投げられるランタイム例外です。
URLEncoder: URL パラメータをエンコードするユーティリティ。第二引数でエンコーディングを指定する場合、サポート外なら例外になります。
URLDecoder: URL のデコードを行うユーティリティ。エンコーディングの指定で例外が発生することがあります。
OutputStreamWriter: エンコーディングを指定して文字を出力する際に用いるライターです。
InputStreamReader: エンコーディングを指定してストリームを文字として読み込むリーダーです。
Java標準ライブラリ: Java の基本的な機能を提供するライブラリ群で、文字エンコーディング周辺の機能も含みます。
エンコーディング指定: コード内で明示的にエンコーディングを指定する表現や慣用語です。
MS932: 日本語Windowsで使われる Shift JIS 系の実装名の一つで、環境によってはサポートされていないことがあります。
URLエンコード: URL のクエリ文字列をエンコードする処理。エンコーディングを指定する場面が多いです。

unsupportedencodingexceptionの関連用語

UnsupportedEncodingException: Java の古い IO 系で、指定した文字エンコード名がサポートされていない場合に投げられる checked 例外。主に String.getBytes(...) や new String(..., …) など、文字列とバイト列の相互変換時に発生する。
文字エンコード: 文字を表すエンコードの総称。文字をバイト列に変換・逆に変換する際の規則（名称で指定する）。
文字セット: 文字の集合と符号化の規則を表す概念。Java では Charset クラスとして表現される。
Charset: Java で文字エンコードを表すクラス。対応するエンコード名からエンコード情報を取得したり、サポート可否を判定したりする。
StandardCharsets: UTF-8 や UTF-16、US-ASCII など、よく使われるエンコーディングを定数として用意しているクラス。
UnsupportedCharsetException: java.nio.charset パッケージの未サポートの文字セットを使用した場合に投げられる実行時例外。
Charset.forName: 文字セット名から Charset オブジェクトを取得するメソッド。未知の名前を渡すと UnsupportedCharsetException が投げられる。
InputStreamReader: バイト列を文字に変換して読み取るためのクラス。指定したエンコードがサポートされていない場合、UnsupportedEncodingException が発生することがある。
OutputStreamWriter: 文字をバイト列に変換して出力するためのクラス。指定エンコードがサポートされていないと UnsupportedEncodingException が起きることがある。
String.getBytes: "String" を指定のエンコーディングでバイト列に変換するメソッド。エンコード名がサポートされていない場合に UnsupportedEncodingException が発生。
new String(byteArray, String charsetName): バイト列を指定したエンコーディング名で文字列に変換するコンストラクタ。サポート外の名称を渡すと UnsupportedEncodingException が投げられる。
UTF-8: 最も一般的で推奨される可変長の Unicode エンコーディング。多言語対応に優れ、互換性が高い。
ASCII: 英数字と基本記号のみを表すエンコーディング。日本語などの非 ASCII 文字は表現できない。
ISO-8859-1: 西欧言語向けの古典的な単一バイトのエンコーディング。日本語は表現不可。