Maven无法找到含JPA实体的包问题求助

问题背景 #

我正在构建一个收容所管理应用，包含以下组件：

• external-service：处理外部接口（控制器、授权逻辑）
• cats/owners服务：负责实体数据访问
• models模块：统一存放所有JPA实体和DTO

微服务通过RabbitMQ通信，数据库使用PostgreSQL。本地运行一切正常，但推送到GitHub后触发**"package [含JPA实体的包]不存在"**错误。已在服务中添加models模块依赖，代码也正确导入了对应包，尝试过重新分配包、清理缓存、调整应用结构、更换CI等操作，均未解决问题。

以下是owner-service的pom文件：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <artifactId>owner-service</artifactId>
    <packaging>pom</packaging>
    <dependencies>
        <dependency>
            <groupId>com.pllenxx</groupId>
            <artifactId>models</artifactId>
            <version>0.0.1-SNAPSHOT</version>
            <scope>compile</scope>
        </dependency>
    </dependencies>
    <version>0.0.1-SNAPSHOT</version>
    <parent>
        <groupId>com.pllenxx</groupId>
        <artifactId>shelter-service</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <properties>
        <maven.compiler.source>19</maven.compiler.source>
        <maven.compiler.target>19</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.22.2</version>
                <configuration>
                    <skipTests>true</skipTests>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

可能的解决方案 #

1. 修正owner-service的打包类型 #

你的owner-service pom中设置了<packaging>pom</packaging>，这种打包类型仅用于聚合模块，不会生成包含编译后class的jar文件，导致CI环境下服务无法正确加载models模块的依赖。将其改为：

<packaging>jar</packaging>

如果是Spring Boot服务，保持jar即可（Spring Boot默认打包类型为jar）。

2. 调整CI构建顺序 #

CI流程需要按模块依赖优先级构建：先构建models模块，再构建依赖它的cats、owners、external-service。以GitHub Actions为例，Maven命令应改为：

mvn clean install -pl models,owner-service -am

其中-pl指定要构建的模块，-am会自动构建这些模块依赖的所有前置模块。

3. 验证models模块的配置 #

• 确认models模块的pom中<packaging>为jar，且groupId、artifactId、version与owner-service的依赖配置完全一致。
• 本地执行mvn clean install后，检查models模块的target/classes目录，确认JPA实体对应的包和class文件存在。

4. 清理CI环境的Maven缓存 #

CI环境可能残留旧的依赖缓存，导致模块依赖无法正确更新。在CI脚本中添加mvn clean命令，或配置Maven缓存仅缓存远程仓库依赖，避免本地模块的缓存冲突。

5. 检查包名大小写一致性 #

Linux环境（CI通常使用Linux镜像）对文件名和包名大小写敏感，而本地Windows环境不敏感。确认代码中导入JPA实体的包名与models模块的实际包名完全一致，包括大小写。

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