在 Scala 项目中，使用 getClass.getResource("xml-files") 可在开发环境（如 IntelliJ）正常工作，但打包为 JAR 后因资源路径机制变化导致 NullPointerException——根本原因在于 getResource() 返回的 jar:// URL 无法直接转换为 File 对象。
在 scala 项目中，使用 `getclass.getresource("xml-files")` 可在开发环境（如 intellij）正常工作，但打包为 jar 后因资源路径机制变化导致 `nullpointerexception`——根本原因在于 `getresource()` 返回的 `jar://` url 无法直接转换为 `file` 对象。
Java/Scala 的类加载器通过 ClassLoader.getResource() 或 Class.getResource() 加载资源时，资源可能位于文件系统（file://）或归档包内（jar://）。当项目以 JAR 运行时，"xml-files" 实际是 JAR 内的一个逻辑目录，并非真实文件系统路径，因此 new File(...).listFiles() 必然返回 null（JDK 规范要求对非文件协议 URL 构造的 File 调用 listFiles() 返回 null），进而触发 NullPointerException。
✅ 正确做法：避免将资源 URL 强转为 File，改用类加载器 + JarURLConnection 或流式遍历方式访问 JAR 内资源。以下是推荐的健壮解决方案：
✅ 方案一：使用 ClassLoader.getResources() + URL 解析（通用、简洁）
import java.net.URL
import scala.collection.mutable.ListBuffer
def listXmlFilesInResourceDir(dirName: String): List[String] = {
val classLoader = getClass.getClassLoader
val resources = classLoader.getResources(dirName)
val paths = ListBuffer[String]()
while (resources.hasMoreElements) {
val url = resources.nextElement()
url.getProtocol match {
case "file" =>
// 开发环境：直接读取文件系统
val dir = new java.io.File(url.toURI)
if (dir.isDirectory) {
dir.listFiles().foreach(f => paths += f.getName)
}
case "jar" =>
// JAR 环境：解析 jar:file:/path/to.jar!/xml-files 格式
val jarPath = url.toString.stripPrefix("jar:").stripSuffix(s"/$dirName")
val jarFile = new java.util.jar.JarFile(new java.io.File(jarPath))
val entries = jarFile.entries()
while (entries.hasMoreElements) {
val entry = entries.nextElement()
if (entry.getName.startsWith(s"$dirName/") && !entry.isDirectory) {
paths += entry.getName.stripPrefix(s"$dirName/")
}
}
jarFile.close()
case _ => // 其他协议（如 http、module）暂不支持
}
}
paths.toList
}
// 使用示例
val xmlFilenames = listXmlFilesInResourceDir("xml-files")
println(s"Found XML files: $xmlFilenames")
✅ 方案二：使用 ClassLoader.getResourceAsStream() + 扫描（更安全，无需依赖路径结构）
若 XML 文件数量可控且命名规则明确，可结合已知文件名列表或约定前缀扫描：
def loadXmlContent(filename: String): Option[String] = {
val stream = getClass.getClassLoader.getResourceAsStream(s"xml-files/$filename")
if (stream != null) {
try {
scala.io.Source.fromInputStream(stream).mkString
} finally stream.close()
} else None
}
// 示例：加载所有已知 XML 文件
val knownFiles = List("config.xml", "schema.xml", "data.xml")
knownFiles.collect { case f if loadXmlContent(f).isDefined => f }
⚠️ 注意事项与最佳实践
- ❌ 永远不要对 getResource(...) 返回的 URL 调用 .getFile 后再 new File(...).listFiles() —— 这在 JAR 中必然失败；
- ✅ 将资源目录（如 xml-files/）置于 src/main/resources/ 下，确保编译后正确打包进 JAR 根路径；
- ✅ 使用 getClass.getClassLoader.getResource(...) 替代 getClass.getResource(...)，避免类加载器上下文差异；
- ✅ 若需动态枚举 JAR 内资源，优先考虑 JarFile API；若仅需读取特定文件，getResourceAsStream 更轻量、跨平台；
- ? 调试技巧：打印 url.toString 和 url.getProtocol，快速判断当前运行环境（file vs jar）。
综上，资源访问的本质是“抽象路径”而非“物理路径”。拥抱类加载器模型，放弃 File 依赖，才能写出真正可移植的 Scala/JVM 应用代码。
