IntelliJ IDEA中ClassLoader.getSystemResourceAsStream返回null致DOM解析报错

Hey there! Let's break down the root cause of that frustrating IllegalArgumentException: InputStream cannot be null error you hit in IntelliJ, and walk through solid fixes to prevent it from happening again.

Root Causes #

The core issue boils down to classpath resource resolution differences between IntelliJ IDEA and CodeBoard:

• Incorrect resource file placement: CodeBoard likely uses a flat project structure where your Student.xml is automatically placed in the root of the classpath. But IntelliJ is stricter—if your XML file isn't in a directory marked as a "resource root," it won't be copied to the compiled classpath when you run your code. The system class loader can't find files that aren't in the classpath, hence the null input stream.
• System class loader limitations: ClassLoader.getSystemResourceAsStream() relies on the JVM's system class loader, which has a narrower view of the classpath compared to the class loader tied to your application's main class. In IntelliJ's modular or structured project setup, the system class loader might not have access to resources stored inside your project's modules.
• Missing resource copy during compilation: IntelliJ only copies files from directories marked as "Resources Root" (like src/main/resources for Maven/Gradle projects) to the compiled output directory (e.g., target/classes). If your Student.xml is in a regular src folder or unmarked directory, it won't make it to the classpath post-compile.

Fixes & Solutions #

Try these steps to resolve the issue:

• Place resources in the correct directory

  • For Maven/Gradle projects: Move Student.xml to the src/main/resources folder—this is the standard directory for non-code resources, and IntelliJ automatically treats it as a resource root.
  • For plain Java projects: Right-click the folder containing Student.xml, select Mark Directory as → Resources Root. This tells IntelliJ to include all files in this directory in the compiled classpath.

• Use your main class's class loader instead of the system loader
  Replace this line:

  Document document = builder.parse(ClassLoader.getSystemResourceAsStream("Student.xml"));
  

  With either of these more reliable alternatives:

  // Uses the class loader tied to your Main class (recommended)
  Document document = builder.parse(Main.class.getResourceAsStream("/Student.xml"));
  // Or explicitly get the class loader from your main class
  Document document = builder.parse(Main.class.getClassLoader().getResourceAsStream("Student.xml"));
  

  The leading slash in getResourceAsStream("/Student.xml") ensures you're looking from the root of the classpath, avoiding path confusion.

• Verify the compiled output
  Check if Student.xml exists in IntelliJ's compiled output directory (usually target/classes for Maven, or out/production/[your-module] for plain projects). If it's missing, double-check that your directory is marked as a resource root, or adjust your project structure settings via File → Project Structure → Modules.

• Add the resource directory to your run configuration
  If you can't move the file, manually add its directory to your run classpath:

  1. Open Run → Edit Configurations
  2. Select your main class's run configuration
  3. Go to the Classpath tab, click the + button, and add the folder containing Student.xml

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