導入
Javaのシステム開発において、分散キャッシュ（RedisやHazelcastなど）やメッセージキュー、あるいはセッションの永続化を行う際、オブジェクトをバイト列に変換する「シリアライズ」は避けて通れません。しかし、ListやMapの中に「シリアライズ不可能な要素」が含まれていると、実行時に NotSerializableException が発生し、システムが停止するリスクがあります。本記事では、コレクションを扱う際に直面するシリアライズの問題と、その安全な回避策を解説します。
基礎知識
Javaでオブジェクトをシリアライズするには、クラスが java.io.Serializable インターフェースを実装している必要があります。
ここで重要なのは、「コレクション自体がSerializableを実装していても、その中に格納されている要素がSerializableでなければならない」という点です。例えば、ArrayList自体はシリアライズ可能ですが、その中にシリアライズ不可能な自作クラス（DTOなど）を格納してネットワーク経由で送信しようとすると、例外が発生します。これは、Stream APIで処理した結果や、Java 21から導入されたSequenced Collections（LinkedHashSet等）でも同様です。
実装/解決策
最も効果的な解決策は、コンパイル時ではなく「実行時」にチェックする仕組みを作ることです。実務では、以下のように「シリアライズ可否を検証するユーティリティメソッド」を用意し、外部へデータを送出する直前にバリデーションを行うアプローチが推奨されます。
サンプルプログラム
以下のコードは、コレクション内の全要素がシリアライズ可能かどうかを事前にチェックする実用的なユーティリティ例です。
import java.io.ObjectOutputStream;
import java.io.OutputStream;
import java.io.Serializable;
import java.util.Collection;
public class SerializationValidator {
/
- コレクション内の全要素がシリアライズ可能か検証する
/
public static void validateCollection(Collection collection) {
for (Object item : collection) {
if (!(item instanceof Serializable)) {
throw new IllegalStateException(“シリアライズ不可能な要素が含まれています: ” + item.getClass().getName());
}
}
}
// ダミーのテスト用クラス
static class UserDto implements Serializable { private String name; }
static class UnsafeObject { private String data; }
public static void main(String[] args) {
// 安全なリスト
var safeList = java.util.List.of(new UserDto());
validateCollection(safeList); // 問題なし
// 危険なリスト（UnsafeObjectはSerializableを実装していない）
var unsafeList = java.util.List.of(new UnsafeObject());
try {
validateCollection(unsafeList);
} catch (IllegalStateException e) {
System.err.println(“エラー検出: ” + e.getMessage());
}
}
}
応用・注意点
現場でこの問題に直面した際、以下のポイントに注意してください。
1. ラムダ式と匿名クラスの罠
Stream APIを使用する際、filterやmapに渡すラムダ式がシリアライズ可能なコンテキストをキャプチャしているか注意が必要です。ラムダ式自体をシリアライズしようとすると、期待以上に複雑なオブジェクトグラフを抱え込み、予期せぬエラーになることがあります。
2. フィールドの修飾子
シリアライズ対象外にしたいフィールドには transient キーワードを付与しましょう。コレクションの一部だけを無視したい場合や、一時的な計算結果を保持するフィールドには必須のテクニックです。
3. 不変コレクションの利用
List.of() や Map.of() で作成される不変コレクションは、シリアライズ可能ですが、要素の追加・削除ができません。シリアライズの要件と、不変性の要件を適切に使い分けることが、堅牢なコードへの第一歩です。
シリアライズは目に見えにくい部分ですが、障害発生時の影響範囲が大きくなりがちです。設計段階から「このデータはネットワークを渡るか？」を意識し、早めのバリデーションを組み込んでおきましょう。
コメント