Spring Boot项目中antMatchers报错咨询（含SSO登录场景）

报错场景 #

开发带谷歌、GitHub单点登录的Spring Boot登录注册页面时，遇到两个相关报错：

• 方法antMatchers(String)对于类型ExpressionUrlAuthorizationConfigurer<HttpSecurity>.ExpressionInterceptUrlRegistry未定义
• antmatchers无法解析为类型，antMatchers未被识别

核心原因与解决方案 #

1. Spring Security版本API变更（最常见原因）

从Spring Security 6.x开始，原有的antMatchers、mvcMatchers、regexMatchers等方法被统一替换为requestMatchers。如果你的项目使用Spring Boot 3.x（默认依赖Spring Security 6+），直接调用antMatchers就会触发上述报错。

解决步骤：
将代码中所有的antMatchers替换为requestMatchers，示例代码如下：

// 旧代码（Spring Security 5及以下）
http.authorizeRequests()
    .antMatchers("/login/**", "/oauth2/**").permitAll()
    .anyRequest().authenticated();

// 新代码（Spring Security 6+）
http.authorizeHttpRequests(auth -> auth
    .requestMatchers("/login/**", "/oauth2/**").permitAll()
    .anyRequest().authenticated()
);

2. 拼写或上下文调用错误

• 检查是否误写为全小写的antmatchers，正确的方法名是驼峰式的antMatchers（仅适用于Spring Security 5及以下版本）
• 确认antMatchers/requestMatchers是在正确的链式调用中使用：必须在authorizeRequests()（Spring Security 5）或authorizeHttpRequests()（Spring Security 6）的配置块内调用。

3. 依赖或导入错误

• 确保pom.xml（Maven）或build.gradle（Gradle）中引入了正确的Spring Security依赖，且版本与Spring Boot匹配
• 检查代码中是否导入了正确的类：确保配置类中导入的是org.springframework.security.config.annotation.web.builders.HttpSecurity，而非其他同名类

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