Spring如何将请求参数绑定到Java Record并支持别名与默认值？

我尝试将多个请求参数绑定到Java Record，当参数名称与Record字段完全一致时可正常绑定。请问是否有办法将参数绑定到不同名称的字段，同时支持设置默认值？

示例控制器代码：

@GetMapping("/invoices")
public InvoicesResponseDto queryInvoiceByDate(InvoicesByDateRequestDto requestDto) {
   ...
}

我在Java Record中尝试的写法：

public record InvoicesByDateRequestDto(
        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate from,
        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate to,
        @RequestParam(value = "restricted", defaultValue = "true") Boolean isRestricted)
{}

此时to和from字段可正常绑定，但传入名为restricted的参数时，isRestricted字段无法绑定，仅传入isRestricted时可行，且默认值不生效。我猜测@RequestParam不适用于该场景，请问有没有替代方案可实现字段别名映射并支持默认值？

方案一：显式声明构造函数并在参数上添加@RequestParam #

Java Record的隐式构造函数不会自动识别组件上的@RequestParam注解，显式写出构造函数并在对应参数上标注注解，即可指定别名和默认值：

public record InvoicesByDateRequestDto(
        LocalDate from,
        LocalDate to,
        Boolean isRestricted) {

    public InvoicesByDateRequestDto(
            @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate from,
            @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate to,
            @RequestParam(value = "restricted", defaultValue = "true") Boolean isRestricted) {
        this.from = from;
        this.to = to;
        this.isRestricted = isRestricted;
    }
}

这样Spring MVC就能通过构造函数参数上的注解，将请求参数restricted绑定到isRestricted字段，默认值true也会正常生效。

方案二：使用@JsonProperty配合@DefaultValue（兼容JSON与表单参数） #

如果接口同时支持JSON请求体和表单参数绑定，可在Record组件上用@JsonProperty指定别名，搭配@DefaultValue设置默认值（需引入jackson-module-parameter-names依赖）：

import com.fasterxml.jackson.annotation.JsonProperty;
import org.springframework.web.bind.annotation.DefaultValue;

public record InvoicesByDateRequestDto(
        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate from,
        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate to,
        @JsonProperty("restricted") @DefaultValue("true") Boolean isRestricted)
{}

注意：需确保Spring MVC参数绑定配置启用了Jackson的参数解析支持。

方案三：自定义参数绑定器（复杂定制场景） #

如果上述方案无法满足需求，可自定义HandlerMethodArgumentResolver实现Record的参数别名映射和默认值处理，该方式适合有特殊定制需求的场景，但实现相对复杂。

内容的提问来源于stack exchange，提问作者TryThis