Spring Boot中@Import配置触发ClassNotFoundException的解决方法

针对你遇到的导入外部Jar包中PostGresAppConfig类时触发ClassNotFoundException的问题，以下是具体排查方向和解决方案：

1. 检查Maven依赖的Scope配置 #

外部Jar的依赖如果设置为provided或test，运行时不会被包含在项目的classpath中，直接导致类找不到。确保依赖的Scope为默认的compile（可省略不写）：

<dependency>
    <groupId>com.company.dept</groupId>
    <artifactId>postgres-config</artifactId>
    <version>x.x.x</version>
    <!-- 不要添加scope="provided"或scope="test" -->
</dependency>

2. 确认外部Jar的打包方式正确 #

如果外部Jar是用spring-boot-maven-plugin打包的Spring Boot应用Jar（带内嵌容器的可执行Jar），其内部结构和普通依赖Jar不同，会导致类无法被加载。外部配置Jar应该打包为普通Jar：

• 若外部项目必须用Spring Boot插件，需配置生成可附加的普通Jar：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                    <configuration>
                        <attach>true</attach>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

• 或者直接使用普通的maven-jar-plugin打包外部项目。

3. 验证本地仓库中的Jar包含目标类 #

找到本地Maven仓库中该依赖的Jar包，解压后检查是否存在com/company/dept/postgres/PostGresAppConfig.class文件。如果缺失，说明外部Jar打包不完整，需要重新构建外部项目。

4. 检查启动时的Classpath是否包含该Jar #

你已经通过System.getProperty("java.class.path")打印了classpath，仔细查看输出中是否存在外部Jar的路径。如果没有，执行mvn dependency:tree命令，检查依赖是否被正确引入，是否存在被意外排除的情况。

5. 核对@Import的类路径拼写 #

确认@Import(PostGresAppConfig.class)中的类全限定名和外部Jar中的类完全一致，避免出现包名大小写、拼写错误等问题。

额外优化建议 #

外部配置类中的@Bean方法返回自身是冗余的，Spring会自动管理PostGresAppConfig配置类的实例，建议删除该方法避免重复实例化：

@Configuration
@ComponentScan(basePackages = {"com.company.dept.postgres.configuration"})
public class PostGresAppConfig {

    @Autowired
    Environment env;

    // 删除以下冗余方法
    // @Bean
    // public PostGresAppConfig postGresAppConfig(){
    //     return new PostGresAppConfig();
    // }
}

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