Thymeleafでnullエラーを回避する実装方法：安全なプロパティアクセスと条件分岐の活用
山崎講師こんにちは。ゆうせいです。
新人研修中に受講者から以下の質問をいただきました。
Thymeleafのnull対策を教えてください
今回はこの質問に答えたいと思います。
Javaのプログラムから画面へデータを渡す際、特定の項目が空（null）であることは珍しくありません。しかし、Thymeleafで空のデータに対して無理にアクセスを試みると、NullPointerExceptionというエラーが発生し、画面全体が表示されなくなってしまいます。今回は、この問題を未然に防ぐための代表的な手法について解説します。
nullが引き起こすエラーの仕組み
プログラムにおけるnullは、中身が何も入っていない空の封筒に例えることができます。封筒の中に手紙（データ）が入っていることを前提に「手紙を読んでください」と命令を出した場合、中身が空であれば命令を実行できず、プログラムは混乱して停止してしまいます。
Thymeleafでオブジェクトの階層を辿る際、途中のオブジェクトがnullであればエラーとなります。これを防ぐために、データの存在を確認しながら処理を進める工夫が必要になります。
セーフナビゲーション演算子による安全なアクセス
最も簡潔な対策は、セーフナビゲーション演算子（?.）を使用することです。この記法を用いると、データがnullであった場合に、それ以上の探索を自動的に中断し、エラーの発生を抑えることができます。
これは、封筒を開ける前に「中に何か入っているか」を外側から軽く触って確認する動作に似ています。中身がなければ、開ける作業そのものを中止するため、失敗することがありません。
<p th:text="${user.address?.city}">都市名が表示されます</p>
この記述では、addressがnullであった場合、cityを参照しようとせずに処理を終了します。
エルビス演算子によるデフォルト値の設定
データがnullであった場合に、単に空欄にするのではなく、特定の代替文字を表示させたい場合には、エルビス演算子（?:）が有効です。
この演算子は、予備の備品を用意しておくルールのようなものです。もしメインの道具が壊れていたり見つからなかったりした場合には、あらかじめ決めておいた予備の道具を差し出すことで、作業を継続させます。
<p th:text="${user.address?.city} ?: '住所未登録'">都市名、または未登録という文字が表示されます</p>
th:if属性を用いた要素の制御
データがnullの場合に、項目そのものを画面から消してしまいたい場合は、th:if属性を使用します。条件に合致しない限り、HTMLのタグごと出力されないため、不要な空白や枠線が残ることを防げます。
これは、在庫がない商品については棚から商品タグごと取り外してしまうような、表示の根本的な切り替えを行う手法です。
<div th:if="${user.address != null}">
<p th:text="${user.address.city}">住所が存在する場合のみ表示されます</p>
</div>
null対策を導入するメリットとデメリット
これらの対策を適切に使い分けることには、事実として以下の側面があります。
メリット
- システムの安定稼働：データの一部に欠損があっても、画面全体の表示が止まる致命的なエラーを回避できます。
- 柔軟な表示管理：未登録時のメッセージ表示など、ユーザーにとって分かりやすい画面構成を容易に実現できます。
- コードの簡略化：Java側で複雑なnullチェックを繰り返す必要がなくなり、画面側の記述だけで安全性を確保できます。
デメリット
- バグの潜在化：本来データが入っているべき箇所がnullであってもエラーが出ないため、データ作成側の不備に気づきにくくなる場合があります。
- テンプレートの複雑化：演算子や条件分岐を多用しすぎると、HTMLファイルの構造が複雑になり、視認性が低下する傾向があります。
まとめ
Thymeleafでのnull対策は、ユーザーにエラー画面を見せないための必須の技能です。学習を深めるためのステップを以下に示します。
- セーフナビゲーション演算子（?.）を使用して、ネストされたプロパティへのアクセスでエラーが出ないことを確認する。
- エルビス演算子（?:）を組み合わせ、データ不足時の代替表示を実装する。
- th:ifやth:unlessを用い、データの有無によって画面のレイアウトを動的に変更する練習を行う。
- プログラム全体の設計として、どのレイヤーでnullを許容し、どこでバリデーションを行うべきかという方針を整理する。
グループでは新人エンジニア研修のアシスタント講師を募集しています。
投稿者プロフィール
