JavaFX Maven应用数据库连接报错：NullPointerException求助

核心原因 #

java.lang.NullPointerException: inStream parameter is null 本质是database.properties文件未被正确加载——ClassLoader无法找到该文件的有效路径，导致返回的输入流为null，后续加载Properties时触发空指针异常。

排查与修复步骤 #

1. 严格遵循Maven资源文件存放规范 #

Maven项目中，配置文件必须放在src/main/resources目录下，否则编译阶段不会自动将其打包到classpath中：

• 正确路径：src/main/resources/database.properties
• 错误路径示例：直接放在src/main/java、项目根目录或其他非resources子目录

2. 修正配置文件加载代码 #

确保加载逻辑使用正确的路径格式，避免包路径或根路径混淆：

• 使用Class.getResourceAsStream()时，带前置斜杠表示从classpath根目录查找：

  InputStream inputStream = R.class.getResourceAsStream("/database.properties");
  

• 使用ClassLoader加载时，无需前置斜杠（默认从classpath根开始）：

  InputStream inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("database.properties");
  

注意：如果不带斜杠使用Class.getResourceAsStream()，会从当前类所在的包路径下查找文件，若配置文件不在该包下则会失败。

3. 验证Maven编译输出 #

执行mvn clean compile命令后，检查target/classes目录下是否存在database.properties文件：

• 如果不存在，说明Maven未复制资源文件到输出目录，需在pom.xml中明确配置资源目录：

  <build>
      <resources>
          <resource>
              <directory>src/main/resources</directory>
              <filtering>false</filtering>
          </resource>
      </resources>
  </build>
  

4. 检查IDE资源目录配置 #

• IntelliJ IDEA：打开File -> Project Structure -> Modules -> Sources，确认src/main/resources被标记为Resources类型
• Eclipse：右键项目 → Build Path -> Configure Build Path，将src/main/resources添加为Source Folder，并确保其输出目录指向target/classes

5. 禁用绝对路径加载 #

不要使用本地绝对路径（如C:/project/database.properties）加载配置文件，这种方式在项目打包或部署到其他环境后会直接失效，必须基于classpath加载。

修复后的工具类示例代码 #

public class R {
    private static final Properties props = new Properties();

    static {
        try (InputStream inputStream = R.class.getResourceAsStream("/database.properties")) {
            if (inputStream == null) {
                throw new FileNotFoundException("database.properties not found in classpath");
            }
            props.load(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
            throw new RuntimeException("Failed to load database configuration", e);
        }
    }

    public static String getProperty(String key) {
        return props.getProperty(key);
    }
}

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