首次学习Maven教程遭遇依赖解析与构件读取错误求助

Hey there, sorry to hear you're stuck on this Maven issue as a beginner—totally frustrating when you're following a tutorial step by step and hit these roadblocks. Let's break down the fixes that should get you back on track:

1. Update the Outdated Maven Shade Plugin #

Looking at your pom.xml, you're using version 2.1 of the maven-shade-plugin—this version is really old (released in 2013) and might not be compatible with modern Maven versions, which could be causing the artifact read/resolution errors. Let's update it to a recent stable version, like 3.4.1:

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-shade-plugin</artifactId>
  <version>3.4.1</version>
  <!-- Keep your existing execution configuration exactly the same -->
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>shade</goal>
      </goals>
      <configuration>
        <transformers>
          <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
            <mainClass>hello.HelloWorld</mainClass>
          </transformer>
        </transformers>
      </configuration>
    </execution>
  </executions>
</plugin>

2. Fix a Corrupted Local Maven Repository #

One of the most common causes of "artifact cannot be read" errors is a corrupted local repository. Here's how to fix it:

• Find your local Maven repo: it's at ~/.m2/repository (Linux/macOS) or C:\Users\<YourName>\.m2\repository (Windows).
• Delete the folder org/apache/maven/plugins/maven-shade-plugin (this forces Maven to re-download the plugin and its dependencies fresh).
• Run mvn clean install from your project folder again.

3. Force Maven to Update Artifacts #

Sometimes Maven caches stale or incomplete artifacts. Run this command to force an update:

mvn clean install -U

The -U flag tells Maven to refresh all snapshot and release dependencies/plugins, which can fix missing or corrupted files.

4. Verify Your Maven & Java Version Match #

You've set your Java source/target to 1.8 (Java 8) in your POM. Make sure your installed Maven version works with Java 8:

• Run mvn -v in your terminal to check your Maven version. Maven 3.6.0 and above are fully compatible with Java 8. If you're on an older Maven version, consider updating it.

5. Check Your Project Structure #

Maven is picky about directory structure. Make sure your project looks like this:

gs-maven/
├── src/
│   ├── main/
│   │   └── java/
│   │       └── hello/
│   │           └── HelloWorld.java
│   └── test/
└── pom.xml

If your HelloWorld.java isn't in the hello package (or the path is wrong), the shade plugin might fail to find your main class, which could throw related errors.

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