Class.getResourceAsStream路径以/开头才从classpath根查找，否则按当前类包路径相对查找；文件需在src/main/resources下且构建后存在于jar顶层；返回null主因是路径错误、资源未进classpath或IDE缓存未刷新。
Class.getResourceAsStream 读取配置文件的路径规则
路径必须以 / 开头才表示从 classpath 根目录开始查找；不加 / 则按当前类所在包路径相对查找。比如 MyClass.class.getResourceAsStream("config.yml") 实际查的是 com/example/MyClass.class 同级的 config.yml，而非 classpath 根下的。
绝大多数场景下你想要的是根路径，所以应写成：MyClass.class.getResourceAsStream("/config.yml")
- 路径中不能含盘符、
file://或绝对文件系统路径 - 路径区分大小写（尤其在 Linux 环境或 jar 包中）
- 若文件在
src/main/resources下（Maven 结构），它会被复制到 classpath 根，"/config.yml"就能命中
返回 null 的常见原因和排查方式
getResourceAsStream 返回 null 不抛异常，容易静默失败。最常因为路径错、文件没进 classpath、IDE 缓存未刷新。
- 确认文件确实在最终 classpath 中：解压生成的 jar，看
config.yml是否在顶层目录 - IntelliJ 用户注意：修改
resources后需手动触发 Build → Rebuild Project，否则资源不会更新到out/或target/classes/ - 用
MyClass.class.getResource("/config.yml")先测试 URL 是否非 null，比直接拿流更易调试 - Maven 多模块项目中，确保配置文件所在模块被正确依赖，且未被
配合 Properties 或 YAML 解析的典型用法
拿到 InputStream 后别忘了关流——但若用 try-with-resources，需注意流生命周期与解析逻辑是否匹配。
try (InputStream is = MyClass.class.getResourceAsStream("/app.properties")) {
if (is == null) {
throw new IllegalStateException("Missing resource: /app.properties");
}
Properties props = new Properties();
props.load(is); // Properties.load() 内部不关闭流，由你负责
}
- Spring Boot 中推荐用
@Value或ResourceLoader，而非手写getResourceAsStream - 解析 YAML 时（如 SnakeYAML），传入
is即可，但注意其Yaml.load()方法内部不消费完流，后续若重复读会失败 - 流只能读一次，反复调用
getResourceAsStream才能获取新流实例
ClassLoader.getResourceAsStream 和 Class.getResourceAsStream 的区别
二者行为高度相似，但默认类加载器策略不同：Class.getResourceAsStream(path) 相当于 Class.getClassLoader().getResourceAsStream(path)，只是前者对不带 / 的路径做了包前缀拼接。
- 显式使用
Thread.currentThread().getContextClassLoader().getResourceAsStream("/config.yml")更适合框架代码（如 Servlet、Spring），避免因类加载器隔离导致找不到资源 - 普通工具类中用
MyClass.class.getResourceAsStream更直观、不易误用 - 不要混用两者去“绕过”路径问题——根源还是路径写法和资源部署位置不一致
实际出问题时，90% 是路径写错了，或者以为文件在 classpath 却漏掉了构建步骤。先验证 getResource 返回的 URL 是否有效，再谈解析逻辑。
