为何JavaFX的.jar可执行文件无法加载WebView中的JS地图？

我之前碰到好几个开发者遇到过一模一样的问题——Eclipse里跑起来一切正常，打包成Jar就直接空白，核心原因大多是Jar包内的资源路径协议和本地文件系统不一样，WebEngine对jar:协议的资源加载有特殊限制，或者HTML/JS里的相对路径在Jar环境下失效了。给你几个针对性的解决方案：

方案1：把资源提取到临时目录再加载（最稳妥） #

Jar里的资源是压缩包内的文件，WebView对jar:协议的支持不算完美，把HTML、JS等资源复制到系统临时目录，再用file:协议加载，就能和Eclipse里的环境一致了。

先写个工具方法提取资源到临时文件夹：

private void extractMapResourcesToTemp() throws IOException {
    // 创建临时目录存放地图资源
    File tempDir = Files.createTempDirectory("map-resources").toFile();
    tempDir.deleteOnExit(); // 程序退出时自动删除

    // 复制map.html
    copyResourceToTemp("/map/map.html", new File(tempDir, "map.html"));
    // 复制对应的JS文件（比如map.js，根据你的实际文件名调整）
    copyResourceToTemp("/map/map.js", new File(tempDir, "map.js"));
    // 如果有CSS、图片等资源，同样复制过来

    // 加载临时目录里的HTML
    WebEngine engine = webviewmap.getEngine();
    engine.load(new File(tempDir, "map.html").toURI().toURL().toExternalForm());
}

private void copyResourceToTemp(String resourcePath, File targetFile) throws IOException {
    try (InputStream in = getClass().getResourceAsStream(resourcePath);
         OutputStream out = new FileOutputStream(targetFile)) {
        if (in == null) {
            throw new FileNotFoundException("找不到资源：" + resourcePath);
        }
        byte[] buffer = new byte[4096];
        int bytesRead;
        while ((bytesRead = in.read(buffer)) != -1) {
            out.write(buffer, 0, bytesRead);
        }
    }
}

然后在初始化WebView的时候调用extractMapResourcesToTemp()就行，这样WebView加载的是本地文件，和Eclipse里的运行环境完全一致，JS地图肯定能正常加载。

方案2：调整WebEngine的安全设置 #

有时候WebEngine默认限制了跨协议资源加载，可以开启相关权限试试：

WebEngine engine = webviewmap.getEngine();
WebSettings settings = engine.getSettings();
settings.setAllowFileAccess(true);
settings.setAllowUniversalAccessFromFileURLs(true);
settings.setAllowFileAccessFromFileURLs(true);

不过这个方案不一定能解决Jar内资源的加载问题，因为核心还是jar:协议的兼容性，只能作为辅助尝试。

方案3：检查HTML/JS里的路径引用 #

确保HTML里引用JS、CSS的路径是相对路径，比如：

<!-- 正确：相对当前HTML的路径 -->
<script src="map.js"></script>

<!-- 错误：绝对路径或者带根目录的路径，在Jar里会找不到 -->
<script src="/map/map.js"></script>
<script src="file:///C:/project/resources/map/map.js"></script>

Eclipse里本地文件系统的根路径和Jar里的资源根路径不一样，绝对路径在Jar环境下完全失效，必须用相对路径。

方案4：直接加载HTML字符串（适合小型资源） #

如果你的HTML和JS内容不多，可以直接把HTML读取成字符串，用loadContent方法加载，甚至把JS内容直接嵌入到HTML里：

// 读取HTML内容
String htmlContent = new String(
    getClass().getResourceAsStream("/map/map.html").readAllBytes(),
    StandardCharsets.UTF_8
);
// 如果JS是外部文件，也可以读取后替换HTML里的<script>引用
String jsContent = new String(
    getClass().getResourceAsStream("/map/map.js").readAllBytes(),
    StandardCharsets.UTF_8
);
htmlContent = htmlContent.replace("<script src=\"map.js\"></script>", "<script>" + jsContent + "</script>");

// 加载内容
WebEngine engine = webviewmap.getEngine();
engine.loadContent(htmlContent, "text/html");

这种方式完全绕开了资源路径问题，适合资源体量不大的场景。

另外还要注意：如果用Maven/Gradle打包，要确保resources/map目录下的所有文件都被正确打包到Jar里；如果是Eclipse导出Jar，导出时一定要勾选resources文件夹，不然资源会缺失。

内容的提问来源于stack exchange，提问作者IdelHamza