SpringBoot主应用无法扫描到依赖Jar中的ServiceImpl Bean问题

我开发了一个可复用的Spring Boot依赖库，包含独立的Service、Repository和Entity类，发布到mavenLocal后供主应用调用，但遇到两个核心问题：

1. 主应用启动时找不到AppIntegrationService类型的Bean
2. 调整扫描配置后，又出现Not a managed type: class xx.xx.xxx.alerts.model.AppIntegration错误

依赖库核心代码 #

Entity实体类

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Table;
import lombok.*;
import lombok.experimental.FieldDefaults;
import org.hibernate.annotations.UuidGenerator;

import java.util.UUID;

@Entity
@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
@FieldDefaults(level = lombok.AccessLevel.PRIVATE)
@Builder
@Table(name = "alert_app_integration")
public class AppIntegration {
    @Id
    @UuidGenerator
    UUID id;

    @Column(name = "workspace_id", nullable = false, columnDefinition = "VARCHAR(150)")
    String workspaceId;

    @Column(name = "channel", nullable = false, columnDefinition = "VARCHAR(50)")
    String channel;

    @Column(name = "config", nullable = false, columnDefinition = "TEXT")
    String config;

    @Column(name = "active", nullable = false, columnDefinition = "BOOLEAN")
    boolean active;
}

Service与Repository实现

public interface AppIntegrationService {
}

@Service
@Slf4j
public class AppIntegrationServiceImpl implements AppIntegrationService {

    private final AppIntegrationRepository repository;

    @Autowired
    public AppIntegrationServiceImpl(AppIntegrationRepository repository) {
        this.repository = repository;
    }
}

@Repository
public interface AppIntegrationRepository extends JpaRepository<AppIntegration, UUID> {
}

依赖库Gradle配置

plugins {
    id 'java'
    id 'maven-publish'
    id 'org.springframework.boot' version '3.2.5'
    id 'io.spring.dependency-management' version '1.1.4'
}

group = 'xx.xx.xxx'
version = '0.0.14'

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

repositories {
    mavenCentral()
}
publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
        }
    }
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter'
    implementation('org.springframework.boot:spring-boot-starter-web')
    implementation("org.springframework.boot:spring-boot-starter-data-jpa")
    implementation 'org.projectlombok:lombok:1.18.24'
    annotationProcessor 'org.projectlombok:lombok:1.18.24'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
    compileOnly 'org.springframework.boot:spring-boot-autoconfigure'
    annotationProcessor 'org.springframework.boot:spring-boot-autoconfigure-processor'
}

tasks.named('test') {
    useJUnitPlatform()
}

bootJar {
    enabled = false
}

jar {
    enabled = true
}

依赖库自动配置尝试

自定义配置类：

package xx.xx.xxx;

import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@Configuration
@EnableJpaRepositories(basePackages = "xx.xx.xxx.alerts.repository")
@ComponentScan(basePackages = "xx.xx.xxx")
@EntityScan(basePackages = "xx.xx.xxx.alerts.model")
public class PlatformUtilConfig {
}

META-INF/spring.factories配置：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ xx.xx.xxx.PlatformUtilConfig

主应用调用代码 #

@Service
@Slf4j
public class AlertServiceImpl  implements AlertService {
    private final AppIntegrationService appIntegrationService;
    private final UserConfig userConfig;

    @Autowired
    public AlertServiceImpl(AppIntegrationService appIntegrationService, UserConfig userConfig) {
        this.appIntegrationService = appIntegrationService;
        this.userConfig = userConfig;
    }
}

1. 修复spring.factories格式错误 #

配置文件中等号后存在多余空格，Spring无法正确识别配置类，修正为：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=xx.xx.xxx.PlatformUtilConfig

2. 验证自动配置类的扫描路径 #

确认PlatformUtilConfig中的包路径与实际代码结构完全一致：

• @ComponentScan(basePackages = "xx.xx.xxx")需覆盖AppIntegrationServiceImpl所在的xx.xx.xxx.alerts.service包
• @EnableJpaRepositories的basePackages必须准确指向xx.xx.xxx.alerts.repository
• @EntityScan的basePackages必须准确指向xx.xx.xxx.alerts.model

3. 移除主应用的重复扫描配置 #

如果主应用MainApplication上添加了@EnableJpaRepositories或@EntityScan，会覆盖依赖库的自动配置，导致扫描范围冲突，直接移除这些重复注解。

4. 调整依赖库的依赖范围 #

将spring-boot-autoconfigure的依赖从compileOnly改为implementation，确保主应用能加载到自动配置相关类：

implementation 'org.springframework.boot:spring-boot-autoconfigure'

5. 验证Jar包完整性 #

检查mavenLocal中发布的依赖库Jar包，确认：

• META-INF/spring.factories文件存在且内容正确
• PlatformUtilConfig类已被正确打包进Jar

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