getresourceasstream() 返回 null 主因是路径错误：不支持绝对路径和“../”上层访问，仅支持包相对路径或classpath根路径（需以/开头）；需确认资源已编译进classpath、路径大小写正确、流安全使用及模块化环境限制。
getResourceAsStream() 返回 null 的常见原因
调用 Class.getResourceAsStream() 却拿到 null，八成是路径写错了。它不接受绝对路径（如 /images/logo.png），也不认相对路径的“上层”（如 ../assets/icon.jpg）。它只按「从当前类所在包为基准」或「以 classpath 根为起点」两种方式解析，且路径必须以 / 开头才走后者。
比如 MyService.class.getResourceAsStream("icon.png") 会去找和 MyService.class 同包下的 icon.png；而 MyService.class.getResourceAsStream("/images/logo.png") 才会从 classpath 根（如 src/main/resources 或 JAR 包顶层）开始找。
- 确认图片已编译进 classpath：检查 target/classes/ 或 JAR 包里是否存在对应路径文件
- 路径区分大小写：Windows 下可能不报错，Linux/JVM 严格区分
Logo.png和logo.png - Maven 项目中，
src/main/resources/images/logo.png对应的资源路径就是/images/logo.png
读取图片时别直接 new BufferedImage(InputStream)
ImageIO.read() 内部会尝试标记流并重置，但 getResourceAsStream() 返回的流不总支持 mark()/reset()（尤其在某些 JAR 加载场景下），直接传给 ImageIO.read() 可能静默失败、返回 null。
稳妥做法是先将流完整读入字节数组，再用 ImageIO.read(new ByteArrayInputStream(bytes))：
InputStream is = MyClass.class.getResourceAsStream("/images/avatar.jpg");
if (is == null) {
throw new IllegalArgumentException("Resource not found: /images/avatar.jpg");
}
byte[] bytes = is.readAllBytes(); // Java 9+
BufferedImage img = ImageIO.read(new ByteArrayInputStream(bytes));
- Java 8 用户可用
IOUtils.toByteArray(is)（Apache Commons IO）或手动ByteArrayOutputStream - 避免长期持有
InputStream：它不会自动关闭，务必在读完后显式is.close()（或用 try-with-resources）
ClassLoader.getResourceAsStream() 和 Class.getResourceAsStream() 的区别
两者行为高度相似，但前缀逻辑不同：ClassLoader.getResourceAsStream("images/logo.png") 永远从 classpath 根开始查，等价于 Class.getResourceAsStream("/images/logo.png")；而 Class.getResourceAsStream("images/logo.png")（无前导 /）是相对包路径查找。
推荐统一用 Class.getResourceAsStream() 并显式加 /，语义更清晰，也避免误以为 “没写 / 就是相对路径” 而实际想从 resources 下加载。
- 不要混用：比如
MyClass.class.getClassLoader().getResourceAsStream("/images/logo.png")多余加了/，反而可能失败 - 模块化（JPMS）环境下，如果类在命名模块中，资源需在同模块内，否则返回
null（无异常）
打包成 JAR 后图片读不到？检查 META-INF/MANIFEST.MF 和资源位置
Maven 构建时，src/main/resources 下的文件默认会复制到 JAR 包根目录，所以 /images/logo.png 能正常加载。但如果用了自定义 resources 目录或插件配置（如 maven-resources-plugin 过滤），可能导致图片被跳过或路径变更。
运行 jar -tf your-app.jar | grep logo.png 确认文件是否真在预期路径。若发现图片在 static/images/logo.png，那代码里就得写 /static/images/logo.png。
- Spring Boot 项目中，静态资源默认放在
src/main/resources/static/，对应 classpath 路径就是/static/xxx - IDE 运行时路径和 JAR 中可能不一致：建议始终以 JAR 内结构为准，本地调试时也模拟 JAR 的 classpath 查找逻辑
null —— 而且没有任何异常提示。Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
