@RequestParamのエラーは、必須欠落・型変換・制約違反を分けて確認します。Boot 3.5.16の10URLの実習で入力が拒否される段階を確認します。クラスに@Validatedを付けると、同じ空白でも例外の型が変わる場合があります。


Spring Bootの検索APIや一覧画面では、@RequestParamでキーワード、ページ番号、期間などを受け取ります。必須チェックや範囲チェックを付けたのに動かない、エラーがBindingResultへ入らない、環境を更新したら例外型が変わった、といった問題が起こりやすい箇所です。
特にWeb上には、クラスへ@Validatedを付ける古い解説と、付けない新しい解説が混在しています。この記事では、若手が現場のSpringバージョンを確認しながら判断できるよう、現在のSpring MVCと旧来方式を分けて説明します。
@RequestParamへ制約を付ける基本形
検索キーワードの空白チェックと、ページ番号の最小値チェックを行う例です。
@RestController
@RequestMapping("/api/employees")
public class EmployeeSearchController {
@GetMapping
public List<EmployeeResponse> search(
@RequestParam @NotBlank @Size(max = 50) String keyword,
@RequestParam(defaultValue = "0") @Min(0) int page) {
return employeeService.search(keyword, page);
}
}ここではjakarta.validation.constraints.NotBlankなどをimportします。古いSpring Boot 2系ではjavax.validationを使うため、別世代のimportを混ぜないようにします。
requiredと@NotBlankは役割が違う
| 指定 | 確認すること | 例 |
|---|---|---|
@RequestParam(required = true) | パラメータ自体が存在するか | ?keyword=は存在している |
@NotNull | nullではないか | 空文字は通る |
@NotEmpty | nullまたは長さ0でないか | 半角空白だけは通る |
@NotBlank | null、空文字、空白だけでないか | 検索語の必須チェック向き |
@RequestParamのrequiredは既定でtrueですが、?keyword=のようにパラメータが存在して値だけ空の場合は、存在チェックを通ることがあります。空白を拒否したいならBean Validationの制約が必要です。
「パラメータがない」と「値が空」は別のエラーとして切り分けます。
@Validだけ付けても必須チェックにはならない
// @Valid自体は「空文字禁止」という制約ではない
@GetMapping
public List<EmployeeResponse> search(
@RequestParam @Valid String keyword) {
return employeeService.search(keyword);
}@Validは、FormやDTOの中にある制約を連鎖的に検証するときに使います。文字列そのものを空白禁止にしたいなら@NotBlank、長さなら@Sizeのように、確認したい条件を直接指定します。
Spring Framework 6.1以降ではMVCがメソッド検証を行う
Spring Framework 6.1以降のSpring MVCは、Controllerメソッド引数へ直接付けた@NotBlankや@Minなどを検証できます。Spring Bootでは、おおむね3.2以降でこの世代のSpring Frameworkが使われます。
@RestController
@RequestMapping("/api/orders")
public class OrderController {
@GetMapping
public List<OrderResponse> find(
@RequestParam @NotBlank String customerCode,
@RequestParam @Min(1) int limit) {
return orderService.find(customerCode, limit);
}
}MVC標準のメソッド検証を使う場合、旧来のAOP方式を有効にするクラスレベルの@Validatedは外すよう、Springの公式リファレンスで案内されています。Controllerをプロキシ経由で検証する方式と、MVC自身の方式を混ぜないためです。
既存Controllerから一括で@Validatedを削除してはいけません。Springのバージョン、Validationグループ、独自設定、テスト結果を確認し、プロジェクトの移行方針に従ってください。
クラスの@Validatedで、同じ空白でも例外が変わる
商品検索の GET /items で keyword に半角空白を3文字渡します。条件は両方とも @RequestParam @NotBlank です。Spring Boot 3.5.16で、テストにControllerを1つずつ登録し、クラスレベルの @Validated の有無を比較します。
クラスに@ValidatedがないMVC標準の検証で HandlerMethodValidationException。今回の InputValidationAdvice がHTTP 400と code=INVALID_PARAMETER を返します。
クラスに@Validatedがあるこの構成ではAOPが検証し、同じAdviceでは拾えません。MockMvcが投げた ServletException の最深原因は ConstraintViolationException です。
MockMvcの比較では、例外の型とAdviceが使われたかを見ています。AOP側のHTTP応答は、実サーバーの例外処理や追加のAdviceによって決まります。正常値 java を渡す対照では、両方のControllerが200を返します。
Spring MVCの組み込み検証を使う構成なら、対象Controllerのクラスレベルの @Validated を外し、同じ空白で既存の400形式へ戻ることを確認します。Validationグループを使っているControllerでは、そのグループの期待値もテストで確認します。Spring Framework 6.2のMVC検証
同じ検索条件で、例外と応答を比べる
10URLの実習とは別のZIPです。Controller2つ、共通のAdvice、実行設定、JUnit、READMEを収録しています。JDK 17とMavenで展開し、mvn clean test で4件を確認します。下の実測欄は、テストの観測行を検証経路で並べたものです。
AOP keyword=java status=200 bodyKeyword=java
AOP keyword=spaces outcome=ServletException root=ConstraintViolationException httpStatus=not-observed
MVC keyword=java status=200 bodyKeyword=java
MVC keyword=spaces status=400 exception=HandlerMethodValidationException code=INVALID_PARAMETERItemsController.java の全文を表示する
package example.requestparam;
import java.util.Map;
import jakarta.validation.constraints.NotBlank;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class ItemsController {
@GetMapping("/items")
public Map<String, String> items(@RequestParam("keyword") @NotBlank String keyword) {
return Map.of("keyword", keyword);
}
}ValidatedItemsController.java の全文を表示する
package example.requestparam;
import java.util.Map;
import jakarta.validation.constraints.NotBlank;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.validation.annotation.Validated;
@RestController
@Validated
public class ValidatedItemsController {
@GetMapping("/items")
public Map<String, String> items(@RequestParam("keyword") @NotBlank String keyword) {
return Map.of("keyword", keyword);
}
}InputValidationAdvice.java の全文を表示する
package example.requestparam;
import java.util.Map;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.method.annotation.HandlerMethodValidationException;
@RestControllerAdvice
public class InputValidationAdvice {
@ExceptionHandler(HandlerMethodValidationException.class)
public ResponseEntity<Map<String, String>> invalidParameter(HandlerMethodValidationException failure) {
if (failure.isForReturnValue()) {
throw failure;
}
return ResponseEntity.badRequest().body(Map.of("code", "INVALID_PARAMETER"));
}
}MvcValidationTest.java の全文を表示する
package example.requestparam;
import org.junit.jupiter.api.Test;
import org.springframework.aop.support.AopUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import static org.junit.jupiter.api.Assertions.*;
import org.springframework.web.method.annotation.HandlerMethodValidationException;
@SpringBootTest(classes = MvcValidationTest.Context.class, webEnvironment = SpringBootTest.WebEnvironment.MOCK)
@AutoConfigureMockMvc
class MvcValidationTest {
@Configuration(proxyBeanMethods = false)
@EnableAutoConfiguration
@Import({ItemsController.class, InputValidationAdvice.class})
static class Context {}
@Autowired MockMvc mvc;
@Autowired ItemsController controller;
@Test
void blankKeywordUsesMvcExceptionHandledByTheNarrowAdvice() throws Exception {
assertFalse(AopUtils.isAopProxy(controller));
var result = mvc.perform(get("/items").param("keyword", " "))
.andExpect(status().isBadRequest())
.andExpect(content().json("{\"code\":\"INVALID_PARAMETER\"}"))
.andReturn();
var failure = assertInstanceOf(HandlerMethodValidationException.class,
result.getResolvedException());
assertFalse(failure.isForReturnValue());
assertEquals(1, failure.getAllValidationResults().size());
assertEquals(" ", failure.getAllValidationResults().get(0).getArgument());
System.out.println("MVC keyword=spaces status=400 exception=HandlerMethodValidationException code=INVALID_PARAMETER");
}
@Test
void validKeywordReachesTheController() throws Exception {
mvc.perform(get("/items").param("keyword", "java"))
.andExpect(status().isOk()).andExpect(content().json("{\"keyword\":\"java\"}"));
System.out.println("MVC keyword=java status=200 bodyKeyword=java");
}
}AopValidationTest.java の全文を表示する
package example.requestparam;
import org.junit.jupiter.api.Test;
import org.springframework.aop.support.AopUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import static org.junit.jupiter.api.Assertions.*;
import jakarta.servlet.ServletException;
import jakarta.validation.ConstraintViolationException;
import jakarta.validation.constraints.NotBlank;
@SpringBootTest(classes = AopValidationTest.Context.class, webEnvironment = SpringBootTest.WebEnvironment.MOCK)
@AutoConfigureMockMvc
class AopValidationTest {
@Configuration(proxyBeanMethods = false)
@EnableAutoConfiguration
@Import({ValidatedItemsController.class, InputValidationAdvice.class})
static class Context {}
@Autowired MockMvc mvc;
@Autowired ValidatedItemsController controller;
@Test
void blankKeywordUsesAopExceptionNotHandledByTheMvcOnlyAdvice() {
assertTrue(AopUtils.isAopProxy(controller));
var wrapped = assertThrows(ServletException.class,
() -> mvc.perform(get("/items").param("keyword", " ")));
Throwable root = wrapped;
while (root.getCause() != null) {
root = root.getCause();
}
var failure = assertInstanceOf(ConstraintViolationException.class, root);
assertEquals(1, failure.getConstraintViolations().size());
var violation = failure.getConstraintViolations().iterator().next();
assertEquals(" ", violation.getInvalidValue());
assertEquals(NotBlank.class, violation.getConstraintDescriptor().getAnnotation().annotationType());
System.out.println("AOP keyword=spaces outcome=ServletException root=ConstraintViolationException httpStatus=not-observed");
}
@Test
void validKeywordAlsoReachesTheControllerThroughTheAopProxy() throws Exception {
mvc.perform(get("/items").param("keyword", "java"))
.andExpect(status().isOk()).andExpect(content().json("{\"keyword\":\"java\"}"));
System.out.println("AOP keyword=java status=200 bodyKeyword=java");
}
}レビューで「制約を追加したのに既存の400にならない」と言われたら、Controllerのクラス宣言とAdviceが受ける例外型を並べます。テストでは空白の検証結果と、正常値がControllerまで届くことをそれぞれ確かめます。
古いSpringでは@Validatedが必要な構成がある
Spring Framework 6.1より前のControllerメソッド検証では、クラスに@Validatedを付け、Method Validationの仕組みを通す構成が広く使われていました。
@Validated
@RestController
@RequestMapping("/api/employees")
public class EmployeeSearchController {
@GetMapping
public List<EmployeeResponse> search(
@RequestParam @NotBlank String keyword) {
return employeeService.search(keyword);
}
}この方式では、制約違反がConstraintViolationExceptionとして扱われる構成があります。Webの記事をそのまま貼り付ける前に、pom.xmlまたはbuild.gradleでSpring Bootのバージョンを確認し、同じ世代の公式ドキュメントを見ます。
Validationの依存関係を確認する
制約アノテーションを書けても、実行に必要なValidation実装が依存関係へ入っていなければ期待どおり動きません。Spring Bootでは通常、Validation Starterを追加します。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>親プロジェクトの依存関係管理で入っている場合もあるため、重複追加する前に依存ツリーと既存モジュールを確認します。
BindingResultへ入らないのはなぜか
BindingResultは、@Valid @ModelAttributeなどでバインドしたオブジェクトの検証エラーを、Controller内で受け取るときに使います。単純な@RequestParamへ付けた制約の違反を、次のように受け取るものではありません。
// RequestParamの制約違反をBindingResultで処理する考え方ではない
@GetMapping
public List<EmployeeResponse> search(
@RequestParam @NotBlank String keyword,
BindingResult bindingResult) {
// ...
}Spring MVC 6.1以降のメソッド検証では、主にHandlerMethodValidationExceptionとして処理されます。一方、Formや@RequestBodyのオブジェクト検証ではMethodArgumentNotValidExceptionが使われる場面があります。入力方法によって例外処理を分けます。
例外ハンドラを用意する
REST APIで独自のエラー形式へ揃えるなら、@RestControllerAdviceでメソッド検証の例外を変換します。
@RestControllerAdvice
public class ApiValidationExceptionHandler {
@ExceptionHandler(HandlerMethodValidationException.class)
public ResponseEntity<ApiError> handleMethodValidation(
HandlerMethodValidationException ex) {
ApiError error = new ApiError(
"INVALID_PARAMETER",
"リクエストパラメータを確認してください");
return ResponseEntity.badRequest().body(error);
}
}利用者向けメッセージだけでなく、どのパラメータが何の制約に違反したかをレスポンスへ含める場合は、プロジェクトの共通エラー形式へ合わせます。例外メッセージをそのまま外部へ返さないようにします。
必須不足と型変換エラーはValidationより前に起きる
以下は、Spring Boot 3.5.16(Spring Framework 6.2.19)で、引数をkeyword、pageの順に宣言した社員検索の結果です。必須のkeywordがないリクエストでは、その引数の解決で止まります。pageの変換や制約まで試すときは、keyword=Aを付けます。
| GETするURL | 結果 |
|---|---|
http://localhost:8174/api/employees | 400 必須のkeywordがない |
http://localhost:8174/api/employees | 400 必須のkeywordがない |
http://localhost:8174/api/employees | 400 必須のkeywordがない |
http://localhost:8174/api/employees | 400 pageをintにできない |
http://localhost:8174/api/employees | 400 pageをintにできない |
http://localhost:8174/api/employees | 400 pageが@Min(0)に違反 |
http://localhost:8174/api/employees | 400 keywordが@NotBlankに違反 |
http://localhost:8174/api/employees | 200 pageの省略で本文A:0 |
http://localhost:8174/api/employees | 200 pageの空文字で本文A:0 |
http://localhost:8174/api/employees | 200 page=0で本文A:0 |
空白のkeywordと数値にできないpage=abcを一緒に送ると、型変換で止まります。引数をすべて解決してから制約を評価するためです。pageの省略とpage=の両方が0になるのは、このコードでdefaultValue = "0"を指定しているためです。
パラメータが増えたらFormクラスを検討する
検索条件が2、3個なら@RequestParamでも読みやすいですが、条件が増えるとアノテーションと引数が並び、検証も複雑になります。
public class EmployeeSearchForm {
@Size(max = 50)
private String keyword;
private String departmentCode;
@Min(0)
private int page = 0;
@Min(1)
@Max(100)
private int size = 20;
// getter / setter
}
@GetMapping
public List<EmployeeResponse> search(
@Valid @ModelAttribute EmployeeSearchForm form,
BindingResult bindingResult) {
// ...
}FormへまとめるとBindingResultでエラーを受け取りやすくなります。ただし、単一のIDを受け取るだけなのに毎回クラスを作る必要はありません。条件数、再利用性、項目間チェックの有無で判断します。
MockMvcで実際のレスポンスを確認する
クラスレベルの@Validatedを付けないMVC標準の検証です。keywordの欠落はMissingServletRequestParameterException、pageの変換失敗はMethodArgumentTypeMismatchExceptionです。引数を解決した後に@NotBlankや@Minへ違反するとHandlerMethodValidationExceptionになります。いずれもHTTP 400なので、MockMvcでは例外型とどの引数で止まったかも確認します。
実行用サンプル
JDK 17とMaven 3.9系で mvn test を実行します。ZIPにはソース全文・テスト・pom.xml・READMEを収録しています。
同じ社員検索に10種類のURLを送る
この追試ZIPは、上の固定版と同じEmployeeSearchController.java、起動クラス、RequestParamOrderTest.java、pom.xml、手順書、ライセンスを収録しています。JDK 17とMaven 3.9系で展開し、mvn testを実行すると10件の例外型・引数名・成功時の本文を確認できます。
表のURLを実HTTPで試すには、追試ZIPのフォルダでmvn spring-boot:run -Dspring-boot.run.arguments=--server.port=8174を実行し、別の端末から送ります。既定のHTTP応答では400の内訳を読み分けられない場合があります。例外の型はmvn testで照合します。
curl -i 'http://localhost:8174/api/employees?page=abc'
curl -i 'http://localhost:8174/api/employees?keyword=A&page=abc'
curl -i 'http://localhost:8174/api/employees?keyword=A&page=-1'
curl -i 'http://localhost:8174/api/employees?keyword=A&page='EmployeeSearchController.java の全文
package info.syachiku.auditvalidation;
import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/api/employees")
class EmployeeSearchController {
@GetMapping
String search(
@RequestParam("keyword") @NotBlank @Size(max = 50) String keyword,
@RequestParam(value = "page", defaultValue = "0") @Min(0) int page) {
return keyword + ":" + page;
}
@GetMapping("/{code}")
String find(@PathVariable("code") @Size(min = 32, max = 32) String code) {
return code;
}
}ValidationContractsTest.java の全文
package info.syachiku.auditvalidation;
import java.util.stream.Stream;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.Arguments;
import org.junit.jupiter.params.provider.MethodSource;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.http.MediaType;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.ResultActions;
import org.springframework.web.bind.MissingServletRequestParameterException;
import org.springframework.web.method.annotation.HandlerMethodValidationException;
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
import static org.junit.jupiter.api.Assertions.assertInstanceOf;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
@SpringBootTest
@AutoConfigureMockMvc
class ValidationContractsTest {
@Autowired
private MockMvc mvc;
@Test
void 件名必須と壊れたJSONでは異なるエラーコードになる() throws Exception {
json("/tasks", "{\"title\":\"確認\"}").andExpect(status().isNoContent());
json("/tasks", "{\"title\":\"\"}").andExpect(status().isBadRequest())
.andExpect(jsonPath("$.code").value("VALIDATION_ERROR"))
.andExpect(jsonPath("$.fields.title").value("件名を入力してください"))
.andExpect(jsonPath("$.globalErrors").isEmpty());
json("/tasks", "{\"title\":").andExpect(status().isBadRequest())
.andExpect(jsonPath("$.code").value("INVALID_JSON"));
}
@Test
void 相関制約が項目名を持たない場合もJSONへ入る() throws Exception {
json("/tasks", """
{"title":"確認","startDate":"2026-11-05","endDate":"2026-11-04"}
""").andExpect(status().isBadRequest())
.andExpect(jsonPath("$.fields").isEmpty())
.andExpect(jsonPath("$.globalErrors[0]").value("開始日と終了日の順序を確認してください"));
}
@Test
void 子へのValidを外すと子の入力値が検証されない() throws Exception {
String invalid = """
{"customerName":"田中","items":[{"sku":"A-001","quantity":2},{"sku":"","quantity":0}]}
""";
json("/orders/no-cascade", invalid).andExpect(status().isNoContent());
json("/orders", invalid).andExpect(status().isBadRequest())
.andExpect(jsonPath("$.fields['items[1].sku']").exists())
.andExpect(jsonPath("$.fields['items[1].quantity']").exists());
json("/orders", "{\"customerName\":\"田中\",\"items\":[null]}")
.andExpect(status().isBadRequest())
.andExpect(jsonPath("$.fields['items[0]']").exists());
}
@Test
void 同日を許可し逆転と終了日未入力を終了日のエラーへ変換する() throws Exception {
json("/request-dates", "{\"startDate\":\"2026-11-04\",\"endDate\":\"2026-11-04\"}")
.andExpect(status().isNoContent());
json("/request-dates", "{\"startDate\":\"2026-11-04\",\"endDate\":\"2026-11-03\"}")
.andExpect(status().isBadRequest())
.andExpect(jsonPath("$.fields.endDate").value("終了日は開始日以降を指定してください"));
json("/request-dates", "{\"startDate\":\"2026-11-04\"}")
.andExpect(status().isBadRequest())
.andExpect(jsonPath("$.fields.endDate").exists());
}
@Test
void クエリの欠落と空白と型変換で例外型が変わる() throws Exception {
mvc.perform(get("/api/employees").param("keyword", "田中").param("page", "0"))
.andExpect(status().isOk()).andExpect(content().string("田中:0"));
mvc.perform(get("/api/employees"))
.andExpect(status().isBadRequest())
.andExpect(result -> assertInstanceOf(MissingServletRequestParameterException.class,
result.getResolvedException()));
mvc.perform(get("/api/employees").param("keyword", " "))
.andExpect(status().isBadRequest())
.andExpect(result -> assertInstanceOf(HandlerMethodValidationException.class,
result.getResolvedException()));
mvc.perform(get("/api/employees").param("keyword", "田中").param("page", "bad"))
.andExpect(status().isBadRequest())
.andExpect(result -> assertInstanceOf(MethodArgumentTypeMismatchException.class,
result.getResolvedException()));
}
@ParameterizedTest
@MethodSource("pathLengths")
void 文字数制約とルーティングを分けて確認する(String path, int code) throws Exception {
mvc.perform(get(path)).andExpect(status().is(code));
}
static Stream<Arguments> pathLengths() {
return Stream.of(
Arguments.of("/api/employees/" + "a".repeat(31), 400),
Arguments.of("/api/employees/" + "a".repeat(32), 200),
Arguments.of("/api/employees/" + "a".repeat(33), 400),
Arguments.of("/api/employees/" + "a".repeat(32) + "/extra", 404));
}
private ResultActions json(String path, String content) throws Exception {
return mvc.perform(post(path).contentType(MediaType.APPLICATION_JSON).content(content));
}
}「アノテーションが付いている」ことではなく、無効な入力を送ったときのHTTPステータスとエラー形式をテストします。バージョン更新時に例外処理が変わっても、外部仕様の変化を検知できます。
効かないときの確認順
- Validation Starterが依存関係へ入っているか確認する
jakarta.validationとjavax.validationの世代を確認する@Validではなく、必要な制約が付いているか確認する- Spring BootとSpring Frameworkのバージョンを確認する
- クラスレベルの
@Validated有無と既存方式を確認する - 発生した例外型を確認し、対応するハンドラを用意する
- MockMvcで実際の無効入力を送って再現する
現場レビューでよくある指摘
// レビューコメント例 @Validだけでは空文字チェックになりません。 要件に合わせて@NotBlankや@Sizeを指定してください。 // レビューコメント例 このプロジェクトはSpring MVC 6.1以降のメソッド検証を使っています。 クラスレベルの@Validatedを追加する前に、既存Controllerの方式へ揃えてください。 // レビューコメント例 RequestParamの制約違反をBindingResultで受けようとしています。 発生する例外型を確認し、共通例外ハンドラ側で処理してください。
提出前のセルフチェック
- 存在、空白、文字数、数値範囲を区別して制約を選んだか
- Validationの依存関係とimportの世代が合っているか
- 利用中のSpring Frameworkバージョンを確認したか
@Validatedを既存方針なしに追加していないか- 発生する例外を共通エラー形式へ変換しているか
- 無効な値を送るMockMvcテストがあるか
Springの検証処理を深める参考書
アノテーションの暗記ではなく、Spring MVCが引数を解決し、検証し、例外へ変換する流れを学ぶと、バージョン差にも対応しやすくなります。
Spring徹底入門 第2版
アプリを作った後に、DIやDB更新の仕組みを調べる。
DI、MVC、データアクセス、テスト、セキュリティまで幅広く確認できます。小さなWebアプリを一通り作り、Springの仕組みを詳しく学びたい人に向く参考書です。
- Springで小さなWebアプリを作ったことがある
- DIやトランザクションの仕組みを確認したい
Spring Framework 5向けです。Boot 3の実装に使うコード・設定は、採用している版の公式資料と照合してください。
当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。
この記事とあわせて読みたい
まとめ
@RequestParamの検証が効かないときは、制約の種類、Validation依存関係、import、Springのバージョンを順番に確認します。@Validだけでは空白チェックにならず、BindingResultも単純なRequestParam制約違反の受け皿ではありません。
Spring Framework 6.1以降はMVC標準のメソッド検証が使えますが、古い案件ではクラスレベルの@Validatedを使う方式があります。検索で見つけた実装をそのまま混ぜず、プロジェクトのバージョンと既存Controllerを確認し、無効入力のテストで動作を確定させましょう。



