サービスの拡張性と保守性を高めるために共通レスポンスオブジェクトを改善し、ユーザーが直接自分のアイデンティティを表現できるプロフィール画像管理機能を実装しました。この過程で経験した技術的解決方案を共有します。

共通レスポンスオブジェクトのジェネリックタイプ推論改善

既存のResponseDtoはLombokの@Builderを通じて生成されました。しかし、ジェネリックタイプを使用する構造上、ビルダー使用時に明示的なタイプ指定がないとコンパイラがタイプを正確に推論できない問題が発生しました。これを解決するため、静的ファクトリメソッドパターンを導入しました。ResponseDto.ok()のような明確な名前を持つメソッドを提供することで可読性を高め、内部的にタイプをカプセル化して使用する側でのコード重複とミスを防止しました。

セキュリティを考慮したプロフィール画像アップロードの実装

ユーザープロフィール画像アップロード機能は、クライアントの非同期リクエストとサーバーのセキュリティポリシーが絡み合う地点です。特にSpring Security環境でREST APIを呼び出す際に発生するCSRFトークン欠落問題を解決するため、メタタグを活用したトークン伝達方式を適用しました。また、Cloudflare R2ストレージとの連携を通じて画像データを安定的に保管し、運用環境別プロファイル設定を分離してインフラ管理の柔軟性を確保しました。