Spring Boot项目Maven编译报错：package com.springapp.model不存在

问题描述 #

我在学习Spring Boot时，使用Maven编译代码出现失败，具体报错如下：

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.11.0:compile (default-compile) on project demo: Compilation failure: Compilation failure: 
[ERROR] 
/demo/src/main/java/com/springapp/controler/TutorialControler.java:[13,27] package com.springapp.model does not exist

我已确认创建并打包了com.springapp.model下的相关类，但问题仍未解决。我的pom.xml内容如下：

<?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>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.5</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.springapp</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>demo</description>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>

        <dependency>
            <groupId>org.postgresql</groupId>
            <artifactId>postgresql</artifactId>
            <version>42.2.27</version>
            <scope>runtime</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>RELEASE</version>
            <scope>compile</scope>
        </dependency>
    </dependencies>

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

</project>

我尝试修改过pom.xml中的groupId属性，但问题依旧。

排查与解决步骤 #

1. 检查目录结构与拼写 #

• 确认model类的实际存放路径是src/main/java/com/springapp/model/，注意目录名是否拼写错误（比如误写为models）。
• 检查TutorialControler中的import语句，确认包名拼写正确（比如是否写成com.springapp.models）。另外注意你的控制器类名是TutorialControler（少了一个l，正确应为Controller），虽不影响当前报错，但建议修正避免后续问题。

2. 清理Maven缓存并重新编译 #

执行以下命令，清除旧编译产物与缓存，强制重新编译：

mvn clean install

3. 同步IDE项目配置（若使用IDE开发） #

• IntelliJ IDEA：执行File -> Invalidate Caches... -> Invalidate and Restart，清除IDE缓存后重新同步项目。
• Eclipse：执行Project -> Clean，右键项目选择Maven -> Update Project，勾选Force Update of Snapshots/Releases。

4. 修正pom.xml的依赖版本问题 #

你的spring-boot-starter-web依赖指定了<version>RELEASE</version>，会自动拉取最新版本，与父pom的3.1.5版本可能不一致，建议去掉版本号继承父pom版本：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <!-- 移除version，继承父pom的3.1.5版本 -->
    <scope>compile</scope>
</dependency>

5. 确认model类的编译状态 #

检查target/classes/com/springapp/model/目录下是否存在编译后的.class文件：

• 若不存在，查看Maven完整编译日志，确认model类是否有语法错误或依赖缺失。
• 若存在，执行mvn dependency:tree查看依赖树，排查是否有依赖冲突影响类加载。

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