Javaのプログラミングを学び始めの頃に、必ずといっていいほど耳にするこの教え。
「Javaの文字列比較には == ではなく equals() を使え!」
頭では分かっているし、基本事項だから自分は絶対に大丈夫――そう思っていませんでしたか?
しかし、テスト環境やローカルでの単体テストではなぜか正常に動いていたコードが、本番環境や外部連携のテストに入った途端に突如として条件分岐をスルーし、「設定値が反映されない」「ステータス判定が永遠に false になる」という奇妙なバグを引き起こすことがあります。
今回は、うっかり == で文字列を比較してしまったことでハマった罠と、なぜテストでは動いてしまったのかの原因についてまとめます。
事故の全貌:テストでは動いたのに本番でバグった理由
状況
ステータスコード(例: "SUCCESS" や "ERROR")を判定する業務ロジックを実装していた時のことです。
直感的な書き方に流されてしまい、以下のようなコードを書いてしまいました。
public class StatusChecker {
public void checkStatus(String status) {
// うっかり == 演算子で文字列を比較してしまった!
if (status == "SUCCESS") {
// 成功時の処理
processSuccess();
} else {
// 失敗・それ以外の処理
processFailure();
}
}
}
このコードを書き、ローカル環境で "SUCCESS" という文字列を渡して単体テストを実行したところ、何の問題もなく「成功時の処理」へとルート分岐し、テストは一発でグリーン(成功)になりました。
発生した悲劇
しかし、本番リリース前の結合テストにおいて、外部APIやデータベースから取得したステータス文字列をそのままこのメソッドに渡したところ、「ステータスが SUCCESS なのに、なぜか else 側の失敗処理に落ちる」という現象が発生しました。
デバッグで確認すると、変数 status の中身は間違いなく文字通り "SUCCESS" です。
それにもかかわらず、status == "SUCCESS" の結果が false になり、意図したルートに入らなくなっていたのです。
考察:なぜテストでは動いて、本番で失敗したのか?
この現象を引き起こしている原因は、Javaのメモリ管理と 「参照の比較(==)」 の仕様にあります。
1. 文字列プール(String Pool)の罠
Javaでは、メモリ効率を高めるために 文字列プール(String Pool) という仕組みを持っています。
ソースコード内に直接書いた文字列リテラル(例: "SUCCESS")は、JVMによって自動的に文字列プール内にキャッシュされます。
そのため、ローカルテストなどで "SUCCESS" と直接指定した文字列やリテラル同士を比較した場合、JVMはメモリ上の「全く同じオブジェクトの参照(メモリアドレス)」を指している と判断します。
そのため、たまたま ==(参照の比較)であっても true になってしまい、テストがスルスルと通ってしまっていたのです。
2. 別インスタンスの文字列と比較された瞬間に破綻する
一方、外部API、データベース、あるいはファイルや画面入力から動的に取得・生成された文字列は、文字列プールとは別の新しいヒープ領域に別インスタンスとして生成されます。
- メモリ上のアドレス(参照先): 異なる
- 文字列が持つ値: 同じ "SUCCESS"
この状態で == 演算子を使って比較すると、「中身の文字は同じだが、別の場所にある別物のオブジェクトである」とみなされ、判定結果が非情にも false になってしまうのです。
これが、「テストでは動いたのに、本番(外部データ)でバグった」の正体です。
対策:安全な文字列比較の鉄則
Javaにおける文字列の比較は、以下のルールを徹底することで完全に防ぐことができます。
対策1:値の比較には必ず equals() を使用する
文字列の内容(値)が等しいかを比較したい場合は、必ず equals() メソッドを使用します。これにより、オブジェクトの参照先が違っていても、中身の文字が一致していれば正しく true を返してくれます。
// 正しい書き方
if ("SUCCESS".equals(status)) {
// ...
}
対策2:定数を左側に置く「ヨーダ記式(Yoda conditions)」の活用
もし status 変数が万が一 null である可能性がある場合、status.equals("SUCCESS") と書くと NullPointerException(NPE) が発生してしまいます。
これを安全に防ぐため、確実に非 null であることが保証されている定数(文字列リテラル)を左側に置く 書き方が広く使われています。
| 書き方 | status が null の場合の挙動 | 評価 |
|---|---|---|
| status.equals("SUCCESS") | NullPointerException 発生 ⚠️ | 危険 |
| "SUCCESS".equals(status) | 安全に false を返す ⭕ | 推奨 |
定数を左側に置くことで、status が null であっても例外を出さずに安全に判定をスルーさせることができます。
失敗から得た教訓・まとめ
| 比較演算子・メソッド | 比較している対象 | 「中身が同じ別インスタンス」の比較結果 |
|---|---|---|
| == 演算子 | メモリ上の参照先(アドレス) | false(別インスタンスなら不一致) |
| equals() メソッド | 文字列の中身(値) | true(文字が同じなら一致) |
「Javaの基本だから分かっている」という油断や、ちょっとしたタイポ・手グセで == を使ってしまうと、文字列プールの仕様に救われてテストは通ってしまい、本番で痛い目を見ることになります。
- 文字列の値の比較には絶対に == を使わず、equals() を使う
- null 安全のために、定数を左側に置く("CONST".equals(variable))
この2つを徹底して、文字列比較の思わぬ罠からコードを守っていきましょう!
株式会社ONE WEDGE
【ITエンジニアに、IT業界に貢献する企業】
株式会社ONE WEDGEは、Webシステム開発・SES・AI/DX支援を行うIT企業です。生成AIを活用した業務効率化や次世代システム開発にも注力しており、企業の課題解決だけでなく、エンジニア一人ひとりの成長にも本気で向き合っています。また、技術は「一人で学ぶもの」ではなく「仲間と成長するもの」と考え、社内外でのコミュニティづくりにも力を入れています。
https://onewedge.co.jp/