如何在离线无Web服务器环境下使用PDF.js并嵌入JavaFX WebView？

直接通过file://协议加载PDF.js的viewer.html时，WebView（基于WebKit内核）会触发CORS限制——因为file协议不在浏览器允许的跨源协议列表内，导致所有本地资源（图片、CSS、JS）无法正常访问。以下是几种无需Web服务器的解决方法：

方法1：修改PDF.js配置与资源路径 #

• 打开viewer.js文件，找到并设置isLocal: true，让PDF.js识别当前为本地运行环境，跳过部分跨源校验逻辑。
• 检查viewer.html中所有资源的引用路径，确保使用相对路径：比如将/web/images/toolbarButton-viewThumbnail.svg改为./images/toolbarButton-viewThumbnail.svg，避免绝对路径触发跨源判定。

方法2：自定义JavaFX协议处理器绕过CORS #

实现一个自定义URL协议（如local://），将本地文件路径映射到该协议下，让WebView认为所有资源来自同一协议源：

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.web.WebView;
import javafx.stage.Stage;
import java.net.URL;
import java.net.URLConnection;
import java.net.URLStreamHandler;

// 自定义本地文件协议处理器
class LocalFileHandler extends URLStreamHandler {
    @Override
    protected URLConnection openConnection(URL u) {
        try {
            // 转换为file协议路径
            String localPath = u.getPath().substring(1);
            return new URL("file:///" + localPath).openConnection();
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
}

public class PdfViewerApp extends Application {
    @Override
    public void start(Stage stage) {
        WebView webView = new WebView();
        
        // 注册自定义协议
        try {
            URL.setURLStreamHandlerFactory(protocol -> {
                if ("local".equals(protocol)) {
                    return new LocalFileHandler();
                }
                return null;
            });
        } catch (Error ignored) {
            // 若协议已注册则忽略错误
        }
        
        // 用自定义协议加载viewer.html
        webView.getEngine().load("local:///C:/pdfjs_3/web/viewer.html");
        stage.setScene(new Scene(webView));
        stage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

方法3：将PDF.js资源打包为JAR内部资源 #

把PDF.js的web目录下所有文件放入Java项目的resources目录，通过类加载器读取资源路径加载，此时所有资源属于同一JAR源，不会触发CORS：

webView.getEngine().load(
    getClass().getResource("/web/viewer.html").toExternalForm()
);

这种方法适合需要打包成独立JAR的分发场景，无需依赖外部文件路径。

额外注意事项 #

• 启动JavaFX应用时，可添加启动参数--enable-file-access-from-files，确保WebView允许本地文件访问权限（部分旧版本JavaFX需要）。
• 测试时优先排查资源路径拼写错误，404错误有时会被CORS错误信息掩盖。

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