intellij 中能正常加载的图片资源，在导出为 jar 后却因 getresource() 返回 null 而失败，根本原因在于：ide 的类路径与构建工具（如 maven）的资源处理机制不一致——未显式声明的资源目录不会被打包进 jar，导致运行时无法定位。
intellij 中能正常加载的图片资源，在导出为 jar 后却因 getresource() 返回 null 而失败，根本原因在于：ide 的类路径与构建工具（如 maven）的资源处理机制不一致——未显式声明的资源目录不会被打包进 jar，导致运行时无法定位。
在 Java 桌面或游戏项目（如使用 Jaylib）中，通过 ClassLoader.getResource() 加载图像、音频等资源是常见做法。但开发者常遇到一个典型陷阱：代码在 IntelliJ IDEA 中运行完美，打包成 JAR 后却抛出 NullPointerException 或 URISyntaxException。从你提供的堆栈日志可见，异常发生在 ZipFileSystemProvider.getPath() 阶段，这明确指向 JAR 内部资源路径解析失败——即目标资源根本未被包含在最终 JAR 包中。
? 根本原因分析
IntelliJ 默认将 src/main/resources（或用户手动标记的任意目录）自动加入运行时类路径，因此 getClass().getClassLoader().getResource("assets/img/hero.png") 在 IDE 中总能成功。但 Maven 默认仅打包 src/main/resources 下的文件；若你的图片存放在 src/main/assets/、resources/images/ 或其他自定义路径，且未在 pom.xml 中显式声明，则这些文件不会出现在生成的 JAR 的 classpath 中，getResource() 自然返回 null。
✅ 正确解决方案：显式配置 Maven 资源目录
在 pom.xml 的
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
<build><resources><!-- 默认已包含 src/main/resources --><resource><directory>src/main/resources</directory></resource><!-- 显式添加自定义资源目录，例如 assets/ --><resource><directory>src/main/assets</directory><!-- 可选：启用过滤（如替换占位符） --><!-- <filtering>true</filtering> --></resource><!-- 若图片在 images/ 子目录下，也可指定具体路径 --><resource><directory>src/main/resources/images</directory></resource></resources><!-- 若使用 Maven Shade Plugin 构建 fat jar，请确保保留资源结构 --><plugins><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-shade-plugin</artifactid><version>3.5.0</version><executions><execution><phase>package</phase><goals><goal>shade</goal></goals><configuration><transformers><transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><mainclass>com.github.command17.mariomaker17.Main</mainclass></transformer></transformers></configuration></execution></executions></plugin></plugins></build>
✅ 验证是否生效：执行 mvn clean package 后，用 jar -tf target/your-app.jar | grep "your-image.png" 检查目标文件是否存在于 JAR 包内。
? 健壮的资源加载代码（推荐写法）
避免依赖 Path.of(...) 直接解析 JAR 内部 URI（该方式在 ZIP 文件系统中易失败），改用流式读取：
@Nullable
public InputStream getInputStream() {
URL resource = getClass().getClassLoader().getResource(this.location);
if (resource == null) {
LOGGER.error("Resource not found: {}", this.location);
return null;
}
try {
return resource.openStream(); // 安全兼容 JAR 和文件系统
} catch (IOException e) {
LOGGER.error("Failed to open resource stream: {}", this.location, e);
return null;
}
}
// 使用示例（Jaylib 场景）
public Texture2D loadTexture(String imagePath) {
try (InputStream is = getInputStream()) {
if (is == null) throw new RuntimeException("Texture resource missing: " + imagePath);
// 假设 Jaylib 提供从 InputStream 创建纹理的方法
return LoadTextureFromImage(LoadImageFromMemory(is));
} catch (Exception e) {
throw new RuntimeException("Failed to load texture: " + imagePath, e);
}
}
⚠️ 注意事项
- 路径格式必须为正斜杠 /："assets/sprites/player.png" ✅，"assets\sprites\player.png" ❌（Windows 反斜杠在资源路径中无效）；
- 不要使用 File 构造器操作 JAR 内资源：new File(url.toURI()) 在 JAR 环境下会抛 FileSystemNotFoundException；
- Shadow JAR vs. Fat JAR：若使用 Gradle 的 Shadow plugin，需确认 mergeServiceFiles() 是否覆盖了关键服务配置（如图像解码器 SPI）；
- IDE 缓存干扰：修改 pom.xml 后，务必在 IDEA 中点击 File → Reload project，否则新配置可能未生效。
通过规范资源目录声明 + 健壮的流式加载逻辑，即可彻底解决“IDE 能跑、JAR 报错”的经典资源加载问题，确保应用在任意部署环境下行为一致。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
