Spring Boot 2.0自定义EnvironmentPostProcessor注册失败排查

我之前也踩过一模一样的坑！咱们一步步拆解可能的原因：

• 检查spring.factories的位置是否正确
  你提到解压JAR能看到META-INF/spring.factories，但要确认它是不是在JAR的根目录下，而不是BOOT-INF/classes/META-INF里！Spring Boot的fat jar结构中，只有根目录META-INF下的spring.factories才会被Boot的启动类扫描到。如果你的spring.factories是在BOOT-INF/classes/META-INF里，那肯定不会被识别。
  解决方法：调整打包配置，把spring.factories复制到JAR根目录的META-INF下。比如Maven可以用maven-resources-plugin配置额外的资源复制，Gradle可以在bootJar任务里添加资源处理逻辑。

• 核对类名和实现细节

  1. 确保spring.factories里的全类名com.mygroup.myapp.CustomEnvironmentPostProcessor和实际类的完全一致，包名、大小写都不能错；
  2. 检查CustomEnvironmentPostProcessor是否正确重写了postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application)方法——别写错方法名或者参数了；
  3. Ordered接口的getOrder()方法返回值要合理，比如返回Ordered.HIGHEST_PRECEDENCE（最高优先级），确保你的处理器能在其他默认处理器之前执行，避免被后续逻辑覆盖。

• 调整日志级别查看加载过程
  EnvironmentPostProcessor的执行时机非常早，默认日志级别可能看不到相关加载日志。你可以在启动时添加参数：

  --logging.level.org.springframework.boot.env=DEBUG
  

  这样就能看到Spring Boot加载所有EnvironmentPostProcessor的详细日志，看看你的CustomEnvironmentPostProcessor有没有被扫描到、初始化。

• 排查版本和类路径冲突
  你用的是Spring Boot 1.5.x-SNAPSHOT，这个版本的EnvironmentPostProcessor有没有特殊的依赖或限制？另外，检查JAR里有没有其他第三方依赖也包含了META-INF/spring.factories，会不会覆盖了你的配置条目？可以解压后把所有spring.factories的内容合并看看，有没有重复或冲突的地方。

• IDE运行和打包的差异
  如果是在IDE中运行没问题，但打包后失效，大概率是打包时spring.factories的位置不对。IDE运行时，src/main/resources/META-INF/spring.factories会被放到类路径根目录的META-INF，但打包成fat jar时默认会把资源放到BOOT-INF/classes下，这时候就需要手动调整打包配置让它出现在根目录的META-INF。

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