Javaの例外処理入門 — try-catchを「おまじない」で終わらせない書き方
はじめに
Javaを学び始めた頃、誰もが一度はこんなコードを書いた経験があるのではないでしょうか?
try {
// 何か処理
} catch (Exception e) {
e.printStackTrace();
}
「エラーが出たら困るから、とりあえずtry-catchで囲んでおけばOK」
自分もそう思っていました。でも実務で先輩にレビューされて気づいたのは、try-catchには明確な意図が必要ということです。
この記事では、Java初心者が「なんとなくのtry-catch」から卒業するためのポイントを整理します。
そもそも例外とは?
例外(Exception)は、プログラム実行中に発生する予期しない事態を表すオブジェクトです。
例えば:
- ファイルが存在しない
- ネットワーク接続に失敗
- nullを参照しようとした
- 数値変換に失敗
Javaはこういった状況を「例外」として投げてきます。それを受け取って処理するのが try-catch です。
検査例外と非検査例外の違い
Javaの例外は大きく2種類あります。
検査例外(Checked Exception)
コンパイル時にtry-catchで囲むか、throwsで宣言することが強制される例外です。
// IOExceptionは検査例外
public void readFile() throws IOException {
Files.readAllLines(Paths.get("test.txt"));
}
代表例:
IOExceptionSQLExceptionClassNotFoundException
非検査例外(Unchecked Exception)
コンパイル時にチェックされない例外です。RuntimeExceptionを継承しています。
// NullPointerExceptionは非検査例外
String s = null;
s.length(); // ここで発生
代表例:
NullPointerExceptionIllegalArgumentExceptionArrayIndexOutOfBoundsException
やってはいけないtry-catchの書き方
❌ 1. すべてをExceptionでキャッチする
try {
// 処理
} catch (Exception e) {
e.printStackTrace();
}
これは「どんな例外が来ても受け止める」書き方ですが、想定外のバグも握りつぶしてしまう危険があります。
❌ 2. 何もしないcatch
try {
// 処理
} catch (IOException e) {
// 何もしない
}
通称「例外を握りつぶす」アンチパターンです。エラーが起きても気づけず、デバッグが地獄になります。
❌ 3. printStackTraceだけで終わらせる
try {
// 処理
} catch (IOException e) {
e.printStackTrace();
}
開発時のデバッグには使えますが、本番環境ではログとして残らなかったり、後から追跡できなかったりします。
良いtry-catchの書き方
⭕ 1. 具体的な例外をキャッチする
try {
Files.readAllLines(Paths.get("test.txt"));
} catch (NoSuchFileException e) {
System.err.println("ファイルが見つかりません: " + e.getFile());
} catch (IOException e) {
System.err.println("ファイル読み込みエラー: " + e.getMessage());
}
例外ごとに処理を分けることで、何が起きたかが明確になります。
⭕ 2. ログに出力する
private static final Logger logger = LoggerFactory.getLogger(MyClass.class);
try {
// 処理
} catch (IOException e) {
logger.error("ファイル読み込み失敗", e);
}
System.out.printlnではなく、ログライブラリ(Log4j、SLF4Jなど)を使うのが基本です。
⭕ 3. 上位に投げ直す
public void readFile() throws DataAccessException {
try {
// 処理
} catch (IOException e) {
throw new DataAccessException("ファイルアクセスエラー", e);
}
}
自分の層で処理できない例外は、上位の層に投げ直すのも大切な判断です。
try-catchを書く前に考えること
try-catchを書く前に、自分に問いかけてみてください:
- どんな例外が起きうるか?
- その例外が起きたら、どう対処したいか?(リトライ?ユーザーに通知?ログだけ?)
- この層で処理すべきか、上位に投げるべきか?
この3つが答えられるなら、もう「おまじないのtry-catch」からは卒業できています。
まとめ
| ポイント | やること |
|---|---|
| Exceptionで全部キャッチしない | 具体的な例外型を指定する |
| 例外を握りつぶさない | 最低でもログに残す |
| printStackTraceで終わらせない | ロガーを使う |
| 意図を持つ | 「なぜここでcatchするか」を説明できるように |
例外処理は、動くコードを書くためではなく、バグが起きた時に素早く原因を突き止めるためにあります。
おわりに
自分も最初は「エラーが出たら怖いからとりあえずtry-catch」でした。でも先輩に「なぜここでcatchしたの?」と聞かれた時に答えられず、例外処理の意味を考え直すきっかけになりました。
この記事が、同じように「なんとなく書いていた」人の参考になれば嬉しいです。