2026-05-19 · 読了目安 1 分
DB 挿入前に UUID を検証する
不正な ID を DB エラーログではなくエッジで捕捉する。
UUID検証API
重要ポイント
- ドライバ例外のデバッグより検証は安い。
- レガシー CSV 移行時は貼り付けリストを一括検証。
エッジで検証
リクエストハンドラーで無効 ID を明確な 400 メッセージで拒否。
本番で検証失敗時はフィールド名をログし、ペイロード全体はログしない。
よくある質問
大文字 UUID は有効ですか？
多くのバリデーターは hex の大文字小文字を無視; バージョンニブルとセグメント長に集中。
ダッシュなし UUID は？
一部システムは 32 hex 形式を受け入れる — API 契約で明示的に正規化。