VSCode中Maven项目无法导入已安装依赖的问题

本地有一个Maven项目，Maven配置文件settings.xml路径为/opt/apache-maven-3.8.6/conf/settings.xml，内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">

  <localRepository>/opt/apache-maven-3.8.6/repository</localRepository>

  <pluginGroups>

  </pluginGroups>


  <proxies>

  </proxies>


  <servers>

  </servers>

  <mirrors>
    <mirror>
      <id>maven-default-http-blocker</id>
      <mirrorOf>external:http:*</mirrorOf>
      <name>Pseudo repository to mirror external repositories initially using HTTP. 
      </name>
      <url>http://0.0.0.0/</url>
      <blocked>true</blocked>
    </mirror>
  </mirrors>


  <profiles>

  </profiles>

</settings>

项目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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.markleo.app</groupId>  
    <artifactId>java-oss-upload-demo</artifactId>  
    <version>1.0-SNAPSHOT</version>

    <properties>
      <java.version>1.8</java.version>
      <maven.compiler.source>8</maven.compiler.source>
      <maven.compiler.target>8</maven.compiler.target>
    </properties>

    <dependencies>
      <dependency>
        <groupId>com.aliyun.oss</groupId>
        <artifactId>aliyun-sdk-oss</artifactId>
        <version>3.15.0</version>
      </dependency>
    </dependencies>
    <build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
    </plugins>
</build>

</project>

执行mvn install成功后，aliyun-sdk-oss依赖已安装到/opt/apache-maven-3.8.6/repository/com/aliyun/oss/aliyun-sdk-oss路径，Maven面板也能看到该依赖，但在java-oss-upload-demo/src/main/java/com/markleo/app/Index.java中导入相关包时出现报错：

import com.aliyun.oss.ClientException;
                     ^
com/markleo/app/Index.java:4: error: package com.aliyun.oss does not exist
import com.aliyun.oss.OSS;
                     ^
com/markleo/app/Index.java:5: error: package com.aliyun.oss does not exist
import com.aliyun.oss.OSSClientBuilder;
                     ^
com/markleo/app/Index.java:6: error: package com.aliyun.oss does not exist
import com.aliyun.oss.OSSException;
                     ^

以下是几种快速排查和解决的方法：

1. 刷新IDE的Maven依赖缓存 #

不同IDE操作略有差异：

• IntelliJ IDEA：点击右侧Maven面板的刷新按钮（圆圈箭头图标），或右键项目 → Maven → Reload Project
• Eclipse：右键项目 → Maven → Update Project，勾选Force Update of Snapshots/Releases后确认

2. 检查IDE的Maven配置一致性 #

确认IDE使用的Maven路径和settings.xml与本地配置匹配：

• IntelliJ IDEA：File → Settings → Build, Execution, Deployment → Build Tools → Maven，检查Maven home directory是否为/opt/apache-maven-3.8.6，User settings file是否指向/opt/apache-maven-3.8.6/conf/settings.xml
• Eclipse：Window → Preferences → Maven → Installations和User Settings，对应检查路径是否一致

3. 清理并重新安装依赖 #

执行命令强制更新依赖，确保包下载完整：

mvn clean install -U

-U参数会强制更新快照依赖，重新下载完整的aliyun-sdk-oss包

4. 检查本地依赖包完整性 #

进入路径/opt/apache-maven-3.8.6/repository/com/aliyun/oss/aliyun-sdk-oss/3.15.0，确认存在aliyun-sdk-oss-3.15.0.jar且文件大小正常（约4MB）。若文件缺失或大小异常，删除该目录后重新执行mvn install

5. 确认项目目录结构规范 #

检查Index.java所在的src/main/java/com/markleo/app符合Maven标准目录结构，src/main/java需被IDE识别为Sources Root（IntelliJ中目录显示蓝色，Eclipse中显示源码文件夹图标）

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