Spring Bootで@RequestParamのバリデーションが効かない原因を解説する記事のアイキャッチ。Java道場風の空間で若手エンジニアがValidationとSpring MVCを学ぶイラスト。

実装・エラー解決

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

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

新人SE
新人SE
@RequestParamに@NotBlankを付けたのに、空文字が通りました。@Validatedを足せば直りますか?
ポンコツSE
ポンコツSE
プロジェクトのSpringバージョンで答えが変わります。まず依存関係と実際に発生する例外を確認し、闇雲にアノテーションを足さないことが大切です。

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=は存在している
@NotNullnullではないか空文字は通る
@NotEmptynullまたは長さ0でないか半角空白だけは通る
@NotBlanknull、空文字、空白だけでないか検索語の必須チェック向き

@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_PARAMETER
ItemsController.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/employees400 必須のkeywordがない
http://localhost:8174/api/employees?page=abc400 必須のkeywordがない
http://localhost:8174/api/employees?page=-1400 必須のkeywordがない
http://localhost:8174/api/employees?keyword=A&page=abc400 pageをintにできない
http://localhost:8174/api/employees?keyword=%20&page=abc400 pageをintにできない
http://localhost:8174/api/employees?keyword=A&page=-1400 pageが@Min(0)に違反
http://localhost:8174/api/employees?keyword=%20&page=0400 keywordが@NotBlankに違反
http://localhost:8174/api/employees?keyword=A200 pageの省略で本文A:0
http://localhost:8174/api/employees?keyword=A&page=200 pageの空文字で本文A:0
http://localhost:8174/api/employees?keyword=A&page=0200 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ステータスとエラー形式をテストします。バージョン更新時に例外処理が変わっても、外部仕様の変化を検知できます。

効かないときの確認順

  1. Validation Starterが依存関係へ入っているか確認する
  2. jakarta.validationとjavax.validationの世代を確認する
  3. @Validではなく、必要な制約が付いているか確認する
  4. Spring BootとSpring Frameworkのバージョンを確認する
  5. クラスレベルの@Validated有無と既存方式を確認する
  6. 発生した例外型を確認し、対応するハンドラを用意する
  7. MockMvcで実際の無効入力を送って再現する

現場レビューでよくある指摘

// レビューコメント例
@Validだけでは空文字チェックになりません。
要件に合わせて@NotBlankや@Sizeを指定してください。

// レビューコメント例
このプロジェクトはSpring MVC 6.1以降のメソッド検証を使っています。
クラスレベルの@Validatedを追加する前に、既存Controllerの方式へ揃えてください。

// レビューコメント例
RequestParamの制約違反をBindingResultで受けようとしています。
発生する例外型を確認し、共通例外ハンドラ側で処理してください。

提出前のセルフチェック

  • 存在、空白、文字数、数値範囲を区別して制約を選んだか
  • Validationの依存関係とimportの世代が合っているか
  • 利用中のSpring Frameworkバージョンを確認したか
  • @Validatedを既存方針なしに追加していないか
  • 発生する例外を共通エラー形式へ変換しているか
  • 無効な値を送るMockMvcテストがあるか

Springの検証処理を深める参考書

アノテーションの暗記ではなく、Spring MVCが引数を解決し、検証し、例外へ変換する流れを学ぶと、バージョン差にも対応しやすくなります。

書籍「Spring徹底入門 第2版」の表紙
商品画像:Amazon.co.jp
PR 入門後の参考書|Spring Framework 5向け

Spring徹底入門 第2版

株式会社NTTデータ (著), 株式会社NTTデータグループ (編集)

アプリを作った後に、DIやDB更新の仕組みを調べる。

DI、MVC、データアクセス、テスト、セキュリティまで幅広く確認できます。小さなWebアプリを一通り作り、Springの仕組みを詳しく学びたい人に向く参考書です。

  • Springで小さなWebアプリを作ったことがある
  • DIやトランザクションの仕組みを確認したい

Spring Framework 5向けです。Boot 3の実装に使うコード・設定は、採用している版の公式資料と照合してください。

当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。

この記事とあわせて読みたい

関連記事Spring Bootの@Validと@Validatedの違い|必須チェックが効かない原因と使い分け 基本的な用途、Validationグループ、現場での選び方を整理します。 記事を読む 関連記事BindingResultの使い方と注意点|@Validの直後に置く理由 Form検証での引数順と、画面へエラーを戻す実装を確認できます。 記事を読む 関連記事Spring Bootの入力値はどこで受ける?@RequestParam・@PathVariable・@RequestBodyの使い分け RequestParam、Form、RequestBodyをどの場面で選ぶかを解説します。 記事を読む

まとめ

@RequestParamの検証が効かないときは、制約の種類、Validation依存関係、import、Springのバージョンを順番に確認します。@Validだけでは空白チェックにならず、BindingResultも単純なRequestParam制約違反の受け皿ではありません。

Spring Framework 6.1以降はMVC標準のメソッド検証が使えますが、古い案件ではクラスレベルの@Validatedを使う方式があります。検索で見つけた実装をそのまま混ぜず、プロジェクトのバージョンと既存Controllerを確認し、無効入力のテストで動作を確定させましょう。

-実装・エラー解決
-,