• SpringBoot自动配置的坑。我的API突然就404了

SpringBoot凭借其“约定比更好配置”的理念和强大的自动配置能力，极大地简化了Java应用的开发流程。只是正是这种“开箱即用”的特性，也可能带来一些隐蔽的问题。你是否遇到过这样的场景：昨天还正常运行的API，今天突然返回404？没有修改代码，没有调整配置，但服务就是“神秘失踪”了。

这种问题的根源往往与SpringBoot的自动配置机制有关。不过，

主体

自动配置的“魔法”与潜在风险

SpringBoot的自动配置通过@EnableAutoConfiguration和一系列META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件实现。它根据类方法依赖、环境变量等因素动态加载配置。例如这方面，

• 引入spring-boot-starter-web会自动配置嵌入式Tomcat和DispatcherServlet。怎么说呢，
• 引入spring-boot-starter-data-jpa会自动配置DataSource和Hibernate。

这种自动化虽然方便，但也可能因为以下原因引发问题：

• 依赖冲突不同版本的库可能导致自动配置行为不一致。按理说，
• 条件注解的误判如@ConditionalOnClass@ConditionalOnMissingBean等可能因类加载顺序或环境差异而失效。
• 默认方法覆盖自动配置可能覆盖开发者自定义的配置，且不易察觉。

API 404 的常见原因分析

控制器未被扫描

• 问题现象：控制器类存在但请求返回404。怎么说呢，

• 根本原因：SprintBoot 默认只扫描主类所在包及其子包。 如果控制器不在这些包中，则不会被加载。

• 示例：

@SpringBootApplication
public class MyApp { // 主类在 com.example.myapp 包
public static void main {
SpringApplication.run;}
}
@RestController
public class DemoController { // 控制器在 com.example.controller 包
@GetMapping
public String demo {
return "Hello";}
}

• 方法：

• 显式指定扫描方法：

  @SpringBootApplication

• 或将控制器移动到主类子包下。

自动配置冲突

• 问题现象：自定义的@WebMvcConfigurer未生效，或静态资源方法错误导致 API 404。

• 根本原因：SprintBoot 的@WebMvcConfigurer*实现如果缺少@Configuration*注解。会被默认的 WebMvcAutoConfiguration 覆盖，从而导致自定义逻辑失效。

// 错误的配置：缺少 @Configuration 注解
public class MyWebConfig implements WebMvcConfigurer {
@Override
public void addViewControllers {
registry.addViewController.setViewName;}
}

• 方法：

• a) 为自定义类添加@Configuration.
• b) 如需完全接管 MVC 配置，可使用@EnableWebMvc。

方法匹配策略变更

• 问题现象：SprintBoot 升级后原有 API 方法无法访问，返回 404。

Sprint Boot 在新版本中默认启用基于`PathPatternParser` 的解析器，而旧版使用`AntPathMatcher`。两者对通配符和多层次方法处理方式不同，导致匹配失败。

ul>

li> 方法 : - 显式指定匹配策略: properties spring.mvc.pathmatch.matching-strategy=ant_path_matcher - 或者调整 API 方法，使之符合新的规则。老实说，

h4 id = “static-resource-priority”> 静态资源优先级高于 API 方法

ul>