Public Static Void Main(String[] Args) - Java Main Method | DigitalOcean

Common Errors and Troubleshooting

When you’re starting out, it’s easy to make small typos or conceptual mistakes related to the main method. This troubleshooting guide covers the most common errors you’ll encounter, explains what they mean in simple terms, and shows you how to fix them.

1. Error: Main method not found in class...

This is the most frequent error a Java beginner will see. It’s the JVM’s way of saying, it couldn’t find the exact public static void main(String[] args) signature to start the program.

What it looks like:

Error: Main method not found in class YourClassName, please define the main method as: public static void main(String[] args)

Common Causes:

• A Typo in the Name: The method name is misspelled (e.g., maim instead of main).
• Incorrect Capitalization: The name is capitalized (e.g., Main instead of main). Java is case-sensitive.
• Wrong Return Type: You have something other than void as the return type (e.g., public static int main(...)).
• Incorrect Parameter Type: The parameter is not a String array (e.g., you have main(String arg) instead of main(String[] args)).

How to Fix It:

Carefully check your main method against the required signature. It must be: public static void main(String[] args)

2. Error: Main method is not static in class...

This is a more specific error that occurs when the JVM finds a main method with the correct name, but it’s missing the static keyword.

What it looks like:

Error: Main method is not static in class YourClassName, please define the main method as: public static void main(String[] args)

Common Cause:

You have simply forgotten to include the static modifier in the method signature.

How to Fix It:

Add the static keyword between public and void. The main method must be static because the JVM needs to run it without creating an object of your class first.

3. Runtime Error: ArrayIndexOutOfBoundsException

This error doesn’t happen at launch, but rather during your program’s execution. It occurs when you try to access a command-line argument from the args array that doesn’t exist.

What it looks like:

Exception in thread "main" java.lang.ArrayIndexOutOfBoundsException: Index 0 out of bounds for length 0 at YourClassName.main(YourClassName.java:5)

Common Cause:

Your code attempts to use an argument (e.g., args[0]) but the user ran the program without providing any arguments on the command line.

How to Fix It:

Always check the length of the args array before trying to access its elements. This ensures your program can handle cases where the user doesn’t provide the expected input.

4. Compilation Error: incompatible types: unexpected return value

This error happens before you even run the program. It’s a compile-time error. It occurs if you try to return a value from the main method.

What it looks like:

YourClassName.java:5: error: incompatible types: unexpected return value return 0; ^

Common Cause:

The main method’s signature explicitly states that its return type is void, meaning it returns nothing. Your code includes a return statement that attempts to return a value (e.g., return 0;).

How to Fix It:

Remove the return value. The main method cannot return any data. If you need to terminate the program with a specific status code, use System.exit(0) instead.