VS Code无法识别Spring Boot等依赖包但项目可运行的问题求助

从GitHub克隆朋友初始化的Spring Boot项目后，VS Code编辑器无法识别Spring Boot、Jakarta、Hibernate、Lombok等依赖，显示红色波浪线，但点击「Run Java」后项目能正常运行。需要解决依赖识别异常，避免影响后续调试。

已尝试的解决方法 #

• 检查pom.xml确认依赖配置（项目指定Java 17，本地安装JDK 21），内容如下：

<?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.2.4</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.auction.kafka</groupId>
    <artifactId>kafka-streams-auction</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>kafka-streams-auction</name>
    <description>Kafka Streams project for auction Web app backend</description>
    <properties>
        <java.version>17</java.version>
        <kafka.version>3.7.0</kafka.version>
        <ehcache.version>3.10.8</ehcache.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-cache</artifactId>
        </dependency>

        <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-jcache</artifactId>
    <version>6.4.4.Final</version>
    </dependency>
        
        <dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-c3p0</artifactId>
    <version>5.5.5.Final</version>
</dependency>

        <dependency>
            <groupId>javax.cache</groupId>
            <artifactId>cache-api</artifactId>
        </dependency>
        <dependency>
            <groupId>org.ehcache</groupId>
            <artifactId>ehcache</artifactId>
            <version>${ehcache.version}</version>
            <classifier>jakarta</classifier>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.apache.kafka</groupId>
            <artifactId>kafka-streams</artifactId>
            <version>${kafka.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.kafka</groupId>
            <artifactId>spring-kafka</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.32</version>
            <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        
        <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-web</artifactId>
      </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>org.apache.tomcat</groupId>
                    <artifactId>tomcat-jdbc</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
 </dependencies>

    <build>
        <finalName>${project.name}</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

• 调整VS Code的Maven配置，移除默认路径后指定本地Maven配置文件：

"java.configuration.maven.userSettings": "./.m2/wrapper/dists/apache-maven-3.9.5-bin/32db9c34/apache-maven-3.9.5/conf/settings.xml",
    "java.configuration.maven.globalSettings": "./.m2/wrapper/dists/apache-maven-3.9.5-bin/32db9c34/apache-maven-3.9.5/conf/settings.xml"

• 执行「Java: Clean Java Language Server Workspace」操作
• 运行mvn clean install并重新加载项目
• 尝试调整Maven可执行路径，但无法修改
• 对比新项目替换./mvn/wrapper目录，问题依旧；仓库内新建子项目也出现相同识别问题

解决建议 #

1. 统一Java版本匹配 #

项目指定Java 17，但本地使用JDK 21，VS Code的Java语言服务可能对版本差异敏感：

• 安装JDK 17，通过VS Code的「Java: Configure Java Runtime」切换项目使用的JDK为17
• 若坚持用JDK 21，在pom.xml的<properties>中添加<maven.compiler.release>17</maven.compiler.release>，确保编译级别与项目指定版本一致

2. 修复Maven配置路径 #

当前配置的是相对路径，可能导致语言服务无法正确识别，改为绝对路径：

• 找到本地Maven的settings.xml绝对路径（Windows：C:\Users\你的用户名\.m2\conf\settings.xml；Linux/macOS：~/.m2/conf/settings.xml）
• 在VS Code设置中更新java.configuration.maven.userSettings和java.configuration.maven.globalSettings为绝对路径

3. 修正Lombok相关配置 #

• 确认VS Code已安装「Lombok Annotations Support for VS Code」插件
• 移除Spring Boot Maven插件中对Lombok的排除配置（当前配置会导致语言服务无法识别Lombok注解）：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <!-- 移除以下排除配置 -->
    <!-- <configuration>
        <excludes>
            <exclude>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
            </exclude>
        </excludes>
    </configuration> -->
</plugin>

• 执行mvn clean install后重新加载项目

4. 重置VS Code Java配置 #

• 关闭VS Code，删除项目根目录下的.vscode文件夹，重新打开项目
• 若问题仍存在，打开VS Code设置，搜索「Java: Configuration」，点击「Reset Settings」重置Java扩展配置

5. 解决Hibernate版本冲突 #

项目中Hibernate版本混用（hibernate-jcache用6.4.4.Final，hibernate-c3p0用5.5.5.Final），可能导致依赖解析异常：

• 移除hibernate-c3p0的手动版本指定，让Spring Boot父项目管理版本（Spring Boot 3.2.4对应Hibernate版本为6.4.4.Final）：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-c3p0</artifactId>
    <!-- 去掉version标签，使用父项目管理的版本 -->
</dependency>

• 运行mvn dependency:tree查看依赖树确认冲突，再执行mvn clean install

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