Spring Boot 3多模块项目跨应用引用JPA实体与仓库报错问题

核心问题分析 #

你遇到的Not a managed type: class com.acme.app2.entity.Stock（注：报错提及的Stock与代码中的Home可能是笔误），本质是App1的Spring容器未正确识别App2的JPA实体类，同时Repository Bean也未被正常创建。

解决方案步骤 #

1. 修正Maven依赖与打包配置 #

首先确保App1的pom.xml已正确引入App2模块依赖：

<dependency>
    <groupId>com.acme</groupId>
    <artifactId>app2</artifactId>
    <version>${project.version}</version>
</dependency>

关键注意：Spring Boot应用默认打包为可执行Jar，这种Jar无法被其他模块依赖。需修改App2的pom.xml打包配置：

• 若无需App2单独可执行，直接跳过Spring Boot打包插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <skip>true</skip>
            </configuration>
        </plugin>
    </plugins>
</build>

• 若需保留App2的可执行性，添加分类器生成普通Jar：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <executions>
        <execution>
            <id>repackage</id>
            <goals>
                <goal>repackage</goal>
            </goals>
            <configuration>
                <classifier>exec</classifier>
            </configuration>
        </execution>
    </executions>
</plugin>

此时App1依赖需指定分类器：

<dependency>
    <groupId>com.acme</groupId>
    <artifactId>app2</artifactId>
    <version>${project.version}</version>
    <classifier>exec</classifier>
</dependency>

2. 确保JPA扫描注解路径正确 #

在App1的启动类上，确认@EntityScan和@EnableJpaRepositories的扫描范围完全覆盖App2的包路径：

@SpringBootApplication
@EntityScan(basePackages = {"com.acme.app1.entity", "com.acme.app2.entity"})
@EnableJpaRepositories(basePackages = {"com.acme.app1.repository", "com.acme.app2.repository"})
public class App1Application {
    public static void main(String[] args) {
        SpringApplication.run(App1Application.class, args);
    }
}

若担心包名写错，可直接指定类来扫描，更准确：

@EntityScan(basePackageClasses = {com.acme.app1.entity.YourApp1Entity.class, com.acme.app2.entity.Home.class})
@EnableJpaRepositories(basePackageClasses = {com.acme.app1.repository.YourApp1Repo.class, com.acme.app2.repository.HomeRepository.class})

3. 检查实体类的JPA注解版本 #

Spring Boot 3使用Jakarta EE API，确保App2的Home实体导入的是Jakarta下的JPA注解，而非旧的javax包：

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import jakarta.persistence.Column;
// 其他必要的Jakarta注解

误用旧javax注解会导致Spring无法识别该实体为JPA管理类型。

4. 修复IntelliJ IDEA的缓存问题 #

IDE提示找不到Bean大概率是缓存异常，执行以下操作：

• 点击菜单栏File -> Invalidate Caches...，选择Invalidate and Restart重启IDE
• 重新构建Maven项目：执行Maven -> Lifecycle -> clean后再执行compile

5. 验证数据源配置一致性 #

如果两个应用共用同一数据源，确保App1的数据库配置（URL、用户名、密码等）与App2一致；若为不同数据源，需配置多数据源并为每个数据源指定对应的实体和Repository扫描范围。

额外建议 #

跨应用直接引用JPA实体和Repository并非Spring Boot的常规实践，更推荐将共享的实体、Repository抽离到单独的公共模块（可基于你现有的DTO库扩展），这样架构更清晰，能避免多数依赖冲突问题。

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