需通过-Djava.protocol.handler.pkgs指定包前缀注册URLStreamHandler，类名必须为XxxURLStreamHandler且位于对应包下，否则new URL("classpath:xxx")抛MalformedURLException。
URLStreamHandler 怎么注册自定义协议（比如 classpath:）
Java 的 URL 类本身不支持 classpath: 这类非标准协议，除非你提供对应的 URLStreamHandler 实现，并通过 JVM 启动参数或系统属性显式注册。JDK 默认只认 http、file、jar 等内置协议。
实操上，最常用的是通过 java.protocol.handler.pkgs 系统属性指定包路径，让 URL 类在解析时自动加载对应协议的 handler：
- 写一个类，如
ClasspathURLStreamHandler，继承java.net.URLStreamHandler，重写openConnection() - 把它放在包
com.example.protocols.classpath下 - 启动时加参数：
-Djava.protocol.handler.pkgs=com.example.protocols（注意：末尾不带.classpath，JVM 会自动拼.<protocol>.Handler</protocol>） - 之后 new URL(
"classpath:/META-INF/MANIFEST.MF") 就能走你的 handler
为什么 new URL("classpath:xxx") 直接报 java.net.MalformedURLException: unknown protocol: classpath
这个错误说明 JVM 根本没找到 classpath 协议的 handler。不是代码写错了，而是注册环节缺失或路径不匹配。
常见踩坑点：
立即学习“Java免费学习笔记（深入）”；
-
java.protocol.handler.pkgs值写成了完整类名（如com.example.ClasspathURLStreamHandler），其实只要包前缀 - handler 类名不是
Handler结尾（必须是ClasspathURLStreamHandler，不能叫ClasspathHandler） - 类没被 classloader 加载到（比如放在 test 目录下但主程序 classpath 没包含）
- 用 IDE 运行时没把 VM options 传给实际进程（IntelliJ 要检查「Run Configuration → VM options」是否生效）
URLStreamHandler 子类里 openConnection() 怎么写才安全
这个方法返回的 URLConnection 必须能正确处理资源定位、输入流打开、连接关闭逻辑。尤其对 classpath:，本质是委托给 ClassLoader.getResourceAsStream()，但要注意边界情况。
关键点：
- URL 的
getPath()返回的是带前导/的路径（如"/logback.xml"），直接传给getResourceAsStream()即可；但若用户写了classpath:logback.xml（无斜杠），getPath()是"logback.xml"，也合法 - 必须判空：如果
getResourceAsStream()返回 null，应抛IOException，不能静默返回 null 连接 - 不要在 handler 里缓存 classloader——不同 context 可能用不同 classloader，应每次从
URL.getClassLoader()或当前线程上下文获取 - 别重写
parseURL()，除非你要改默认解析逻辑（比如支持classpath*:xxx多匹配），否则默认实现已够用
Spring 的 classpath: 和原生 URLStreamHandler 有啥区别
Spring 的 classpath: 不依赖 JVM 协议注册机制，它是自己在 ResourceLoader 层解析字符串前缀，再调用 ClassLoader.getResourceAsStream()。所以它更灵活，支持通配符、多路径、Ant 风格匹配，也不需要 VM 参数。
这意味着：
- 你不用注册 handler 就能用 Spring 的
classpath:（比如ApplicationContext.getResource("classpath:app.properties")） - 但如果你希望
new URL("classpath:xxx")在任意 Java 代码中都可用（比如第三方库内部硬编码了 URL 构造），就必须走原生 handler 注册这条路 - 两者不兼容：Spring 不会识别你注册的
URLStreamHandler，它完全绕过URL类
真正容易被忽略的是：协议 handler 是 JVM 级别的全局配置，一旦设错（比如包路径拼错），整个应用所有 URL 解析都会受影响，而且错误表现往往延迟到首次用到该协议时才爆发。
