SpringBoot迁移SpringDoc-OpenAPI-UI后接口正则验证失效解决方案咨询

问题根源在于：SpringDoc会自动将Java的@Pattern注解转换为OpenAPI规范的正则约束，但Java正则中的\p{IsAlphabetic}这类语法是Java特有的，OpenAPI依赖的JSON Schema正则并不支持，导致Swagger UI的前端验证误判——即使参数符合Java正则规则，也会抛出验证错误。

以下两种方案可以解决问题，满足你的需求：

方案1：不修改正则，调整SpringDoc的参数约束生成逻辑 #

通过自定义SpringDoc的参数构建插件，让它忽略@Pattern注解的正则约束，避免同步到OpenAPI规范中，这样Swagger UI就不会执行前端验证，完全由后端的Spring Validation处理。

创建一个自定义插件类：

import io.swagger.v3.oas.models.parameters.Parameter;
import org.springdoc.core.customizers.ParameterBuilderPlugin;
import org.springdoc.core.providers.ParameterBuilderContext;
import org.springframework.stereotype.Component;
import javax.validation.constraints.Pattern;
import java.util.Optional;

@Component
public class IgnorePatternForSwaggerPlugin implements ParameterBuilderPlugin {
    @Override
    public void apply(ParameterBuilderContext context) {
        Optional<Pattern> patternAnn = context.getMethodParameter().findParameterAnnotation(Pattern.class);
        if (patternAnn.isPresent()) {
            // 移除OpenAPI参数中的pattern约束
            Parameter param = context.getParameterBuilder().build();
            param.setPattern(null);
            context.getParameterBuilder().from(param);
        }
    }

    @Override
    public boolean supports(io.swagger.v3.oas.models.media.Schema.Type type) {
        // 仅处理字符串类型参数
        return io.swagger.v3.oas.models.media.Schema.Type.STRING.equals(type);
    }
}

启动应用后，SpringDoc会自动加载这个插件，不再将@Pattern的正则同步到Swagger UI的参数约束中，前端验证会被跳过，参数直接提交到后端由@Pattern验证，失败时返回400错误。

方案2：直接禁用Swagger UI的前端验证 #

如果不想编写自定义代码，最简单的方式是直接关闭Swagger UI的请求验证功能，让所有参数验证逻辑完全由后端处理，和SpringFox的原有行为一致。

在配置文件中添加以下配置：

application.properties #

springdoc.swagger-ui.validate-request=false

application.yml #

springdoc:
  swagger-ui:
    validate-request: false

配置生效后，Swagger UI不会再对请求参数做前端验证，所有参数都会直接发送到后端，由你的@Pattern注解完成校验，验证失败时返回400响应。

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