バリデーション

実装・エラー解決

2026/10/13

Spring Bootのフォーム入力・バリデーション実践ガイド｜実装からテストまで

フォームを作って終わりにしない。入力の約束からエラー時の再表示、Serviceの業務判断、MockMvcでの確認まで、既存記事を読む順と確認する問いをまとめました。

実装・エラー解決

2026/10/1

Spring BootでバリデーションエラーをJSONで返す方法｜RestControllerAdviceの実装例

APIで空の件名を送ると400になる。ところが画面側では、どの欄を直せばよいか分からない。ステータスコードだけ合っていても、入力画面を作る側には足りません。私なら、エラー応答を利用者が修正できる項目名とメッセージだけに絞った契約にします。スタックトレース、例外クラス名、送信された秘密値を返す必要はありません。ここでは Java 21、Spring Boot 3.5系、Spring MVC の @Valid @RequestBody を例にします。応答形式を先に決める APIのエラー応答に必要な要素。A ...

実装・エラー解決

2026/10/1

Spring BootでネストしたDTOのバリデーションが効かない原因｜Listの中まで検証する方法

注文APIで、注文者名が空なら400になるのに、明細の品番が空でも保存される。コントローラー引数に @Valid があるのを確認しても、原因が見えないことがあります。私なら最初に見るのは、親から子へ検証を進める指定があるかです。親の検証は、子の中身を自動で全部たどるわけではありません。注文と複数明細を例に、検証する階層を見える形にします。以下は Java 21、Spring Boot 3.5系と spring-boot-starter-validation の例です。症状を一つのJSONで再現する { ...

実装・エラー解決

2026/10/6

Spring Bootで開始日と終了日をチェックする方法｜相関バリデーションの実装例

申請フォームに開始日と終了日を追加した。両方に @NotNull を付けたのに、「終了日が開始日より前」の申請が保存されてしまう。これはアノテーションが壊れたのではありません。@NotNull が確認するのは一つの値で、二つの日付の関係は別の仕様だからです。ここでは「開始日・終了日は両端を含み、同じ日でも申請可能」と決めます。二つの値を持つDTOにクラス単位の制約を付け、エラーは終了日へ返します。題材は架空の申請アプリです。コード例は Java 21、Spring Boot 3.5系、spring-bo ...

実装・エラー解決

2026/10/14

Spring Bootでバリデーションメッセージが表示されない｜Thymeleafの原因と修正

AIによる要約Spring Bootでバリデーションメッセージが表示されないときは、まずBindingResultのエラーを確認します。nameにエラーがあっても、Thymeleafのth:errorsが正常なemailを参照すれば、名前の文言は表示されません。この記事では同じ空欄入力で故障版と修正版を比べ、項目名を直すだけで日本語表示が戻ることをMockMvcで確認します。 Spring BootとThymeleafの入力画面では、Formに@NotBlankを付けただけではメッセージは自動表示されませ ...

実装・エラー解決

2026/10/15

Spring Bootで@RequestParamのバリデーションが効かない原因｜@Validatedは必要？

AIによる要約@RequestParamへ@NotBlankや@Minを付けても効かないときは、Validation依存関係、Springのバージョン、例外の受け取り方を確認します。Spring Framework 6.1以降のSpring MVCにはControllerメソッドの検証機能があり、旧来のAOP方式で使うクラスレベルの@Validatedを外す方が適切な構成もあります。@Validだけでは制約にならず、BindingResultも単純なRequestParam検証の受け皿ではありません。 S ...

実装・エラー解決

2026/10/15

Spring Bootの@Validと@Validatedの違い｜必須チェックが効かない原因と使い分け

AIによる要約Spring Bootの@Validと@Validatedは、通常の入力検証とグループ指定で使い分けます。特に「@Validated(CreateGroup.class)へ変えたら@NotBlankが効かない」場合は、共通制約のDefaultグループが検証対象に含まれているかを確認してください。登録・更新の入力例と実行結果で違いを確かめます。 Spring Bootで入力チェックを調べると、@Validと@Validatedの両方が出てきます。普通のFormやRequest DTOを検証す ...

実装・エラー解決

2026/10/15

BindingResultの使い方と注意点｜@Validの直後に置く理由

AIによる要約BindingResultは、@Validで検出した入力エラーをControllerで受け取るための引数です。重要なのは、@Validを付けたFormの直後に置くことです。順番を間違えると、期待通りにエラー処理できません。 Spring MVCで入力チェックを実装すると、@Validと一緒にBindingResultが出てきます。新人のうちは、サンプルコードを写して動かすことはできても、なぜその順番で書くのかまでは分かりにくいです。この記事では、現場でよくレビューされる注意点に絞って整理し ...

設計・テスト・レビュー

2026/10/15

Spring Bootで入力チェックが重複する｜ControllerとServiceの分け方

先に結論画面とAPIの両方に同じ重複チェックを書いているなら、メール重複などの業務判断をServiceへ集約します。必須・文字数・形式は各入口のForm／Requestで検証し、Controllerは結果をHTMLやJSONへ返します。同じ業務エラーでも、画面の項目エラーとAPIの409応答は分けて扱えます。登録画面とAPIを作ったら、メール重複のif文が両方にできた。Serviceへ移すと、今度は例外が画面へ表示されず500になる。この記事は、そのような入力チェックの重複とエラー応答の分け方を整理しま ...

実装・エラー解決

2026/9/6

Spring MVCの@PathVariableをバリデーションする方法

この記事の内容 Spring MVCで@PathVariableを使っている受け取った値のバリデーションを実施するポイント hibernateのBean生成コードを明示的に記述する環境 Java11Spring MVC 5.3.21 pom(抜粋) <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.3.21< ...