使用STS 3.9.3导入Spring入门项目后出现NoClassDefFoundError求助

Hey there, let's work through this NoClassDefFoundError you're hitting with your Spring rest service project in STS 3.9.3. This error almost always boils down to missing/corrupted dependencies or misconfigured build settings, so here are some tried-and-true fixes to get you up and running:

1. Refresh and Repair Dependencies #

NoClassDefFoundError often pops up when Maven/Gradle hasn't pulled all required dependencies correctly. Here's how to fix that:

• Right-click your project → Maven → Update Project (skip to Gradle steps if your project uses it). Check the box for Force Update of Snapshots/Releases then click OK.
• For Gradle projects: Right-click → Gradle → Refresh Gradle Project.
• If you see download errors in the console, navigate to your local Maven repo (usually ~/.m2/repository) and delete the corrupted dependency folders (e.g., anything under org/springframework related to your project). Then re-run the update/refresh step.

2. Confirm JDK Compatibility #

STS 3.9.3 (based on Eclipse Oxygen) works best with JDK 8, which is also the minimum requirement for most Spring Boot 2.x projects (the rest service starter uses this):

• Right-click your project → Properties → Java Build Path → Libraries. Ensure the JRE System Library points to a JDK 8 installation (not a lower version).
• Next, go to Project Facets (still in Properties) and make sure the Java version matches your JDK (e.g., 1.8). If it doesn't, adjust it and apply the changes.

3. Clean and Rebuild the Project #

Corrupted compiled class files can also cause this error. Let's wipe and rebuild:

• Click Project → Clean from the top menu, select your project, and click OK.
• Then, right-click the project → Run As → Maven Build. In the "Goals" field, enter clean install and run it. For Gradle, use clean build instead.
• Once the build finishes successfully, try running Application.java again.

4. Re-Import the Project #

If the initial import was corrupted, starting fresh might help:

• Delete the current project from STS (you can choose to keep the local files if you want, or delete them entirely).
• Re-run the import steps: File → New → Import Spring Getting Started Content, search for "rest", select the project, and complete the import.
• Wait for STS to finish downloading dependencies and initializing the project (watch the bottom-right progress bar) before attempting to run anything.

5. Check STS Global Configurations #

Sometimes the issue is with STS itself, not the project:

• Go to Window → Preferences → Java → Installed JREs. Ensure JDK 8 is listed and set as the default.
• For Maven, check Window → Preferences → Maven → Installations. Make sure you're using a Maven version 3.5 or higher (compatible with Spring Boot).

If none of these steps fix the error, sharing the full stack trace of the NoClassDefFoundError would help pinpoint exactly which class is missing—this will let us narrow down the issue further.

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