部署Spring Boot应用时遭遇BeanCreationException问题求助

一、优先解决类路径重复依赖问题 #

报错中提到的org.json.JSONObject重复是核心诱因之一——不同版本的JSON库会导致类加载冲突，进而引发初始化阶段的NPE。

• 分析依赖树：执行Maven命令找出所有引入org.json的依赖：

  mvn dependency:tree -Dincludes=org.json:json
  

  查看输出，定位重复引入的来源（通常是第三方依赖间接引入的旧版本）。

• 排除重复依赖：在pom.xml中对间接引入org.json的依赖添加排除规则，示例：

  <dependency>
      <groupId>第三方依赖groupId</groupId>
      <artifactId>第三方依赖artifactId</artifactId>
      <version>版本号</version>
      <exclusions>
          <exclusion>
              <groupId>org.json</groupId>
              <artifactId>json</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 锁定单一版本：如果业务确实需要org.json，在pom.xml中明确声明固定的稳定版本，避免依赖自动解析带来的版本不一致：

  <dependency>
      <groupId>org.json</groupId>
      <artifactId>json</artifactId>
      <version>20240303</version> <!-- 使用最新稳定版 -->
  </dependency>
  

二、排查PropsService初始化NPE根源 #

本地正常、服务器/Docker异常，大概率是初始化逻辑依赖的环境资源存在差异：

• 添加初始化日志：在PropsService的构造方法、@PostConstruct方法中打印关键变量状态，定位null对象：

  @Slf4j
  @Service
  public class PropsService {
      private final SomeConfigBean configBean;
  
      public PropsService(SomeConfigBean configBean) {
          this.configBean = configBean;
          log.info("ConfigBean初始化状态: {}", configBean);
          // 其他初始化逻辑
      }
  
      @PostConstruct
      public void init() {
          log.info("开始执行初始化逻辑");
          // 打印所有依赖对象的状态，排查null来源
      }
  }
  

• 核对环境配置差异：

  • 检查服务器/Docker的application.properties/application.yml是否和本地一致，重点关注PropsService依赖的配置项是否存在、值是否合法。
  • 确认Docker镜像构建时是否正确复制了配置文件，比如Dockerfile中是否包含COPY src/main/resources/application.yml /app/之类的指令。

• 检查Bean依赖顺序：如果PropsService依赖其他Bean，确保依赖的Bean已经完成初始化。可通过@DependsOn注解明确指定依赖顺序。

三、消除环境版本差异影响 #

本地与服务器的Maven、Java版本差异可能导致依赖解析或字节码兼容性问题：

• 统一Maven版本：在EC2服务器上安装与本地一致的Maven 3.9.4，使用指定路径执行构建命令：

  /path/to/maven-3.9.4/bin/mvn clean package -DskipTests
  

• 统一Java版本：Docker构建时使用与本地一致的Java镜像，示例Dockerfile基础镜像：

  FROM openjdk:17.0.7-jdk-slim
  COPY target/your-app.jar app.jar
  CMD ["java", "-jar", "app.jar"]
  

四、验证解决方案 #

1. 先在本地Docker容器中测试修改后的代码，确认能正常启动。
2. 构建后执行mvn dependency:analyze检查依赖是否存在未使用或缺失的情况。
3. 启动时添加JVM参数-verbose:class，查看org.json.JSONObject的加载来源，确认重复依赖已解决。

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