簡(jiǎn)介JxBrowser 7.19 是面向 Java 桌面應(yīng)用開發(fā)者的嵌入式瀏覽器組件資源適合在 Swing、SWT、JavaFX 等界面中集成網(wǎng)頁(yè)渲染、HTML 交互、登錄授權(quán)與跨平臺(tái)瀏覽能力的項(xiàng)目使用也可為舊版本升級(jí)、兼容性驗(yàn)證和多端部署提供參考。壓縮包共 1359 個(gè)文件以 1345 個(gè) HTML 文檔為主輔以 10 個(gè) JAR 運(yùn)行庫(kù)及少量腳本、樣式與索引文件整體約 437.21MB內(nèi)容覆蓋 Windows、Linux、macOS 等桌面與 ARM 平臺(tái)依賴并附帶完整 Javadoc 與 Browser.java 示例方便按容器類型選擇依賴并完成接入。已有 2599 人學(xué)習(xí)下載。讀者可獲得全平臺(tái)運(yùn)行庫(kù)、較完整的接口文檔和最小接入示例用于核對(duì)版本差異、搭建開發(fā)環(huán)境、驗(yàn)證容器嵌入方式并對(duì)照平臺(tái)分包排查常見集成問題文檔目錄也便于按類名與接口快速檢索減少反復(fù)試錯(cuò)對(duì)需要維護(hù)多端一致體驗(yàn)的團(tuán)隊(duì)較為實(shí)用并降低環(huán)境配置成本。1. 用 jxbrowser java 把 Chromium 塞進(jìn) Swing它真正解決的是哪一類問題Java 桌面端要嵌一個(gè)現(xiàn)代內(nèi)核的瀏覽器這事兒的坑比想象中深。JavaFX 自帶的 WebView 引擎版本老H5 報(bào)表里的 ES6 語(yǔ)法一上來就白屏JCEF 能跑但編譯鏈得自己維護(hù)換個(gè) JDK 就得重來一遍。所以我一般會(huì)把 jxbrowser java 這條路線重新?lián)炱饋怼狫xBrowser 7.19 屬于 7.x 線上比較穩(wěn)的一個(gè)點(diǎn)本質(zhì)是把整個(gè) Chromium 內(nèi)核封裝成Engine/Browser兩層 JVM 對(duì)象Swing、JavaFX、SWT 都能掛上去。它值錢的地方不是“能顯示網(wǎng)頁(yè)”而是網(wǎng)頁(yè)里的 JS 能回調(diào) Java、Java 能攔請(qǐng)求改響應(yīng)、離屏模式下還能截圖和打印。適合誰做桌面客戶端、界面里要嵌 H5 模塊、又不想碰 CEF 編譯鏈的 Java 團(tuán)隊(duì)。它是商業(yè)庫(kù)這點(diǎn)要有心理準(zhǔn)備。2. 依賴坐標(biāo)與內(nèi)核目錄jxbrowser 7.19 的包結(jié)構(gòu)拆開看把 7.19 的構(gòu)件下下來第一反應(yīng)往往是“怎么這么多 jar”。它不是一個(gè)單體包而是按宿主 UI 框架切的核心 API 一個(gè) jarSwing / JavaFX / SWT 各自的視圖實(shí)現(xiàn)各一個(gè) jar再疊一個(gè)裝 Chromium 原生庫(kù)的 classifier 包。搞不清這個(gè)分層最容易出的問題就是“代碼編譯過了一跑就NoClassDefFoundError”或者打出來的安裝包莫名其妙 800 MB。2.1 四個(gè)構(gòu)件各管什么別一股腦全引進(jìn)來先看分工這張表建議存下來排查依賴沖突時(shí)對(duì)著看構(gòu)件里面是什么什么時(shí)候引jxbrowserEngine、Browser、Frame、Network等核心 API必引jxbrowser-swingBrowserView的 Swing 實(shí)現(xiàn)界面是 Swing / AWTjxbrowser-javafxBrowserView的 JavaFX 實(shí)現(xiàn)界面是 JavaFXjxbrowser-swtSWT 宿主適配老 RCP 項(xiàng)目核心包只提供“引擎 瀏覽器實(shí)例 DOM 操作 網(wǎng)絡(luò)事件”它不知道你要把畫面貼到哪個(gè)組件上。視圖包才是把渲染結(jié)果落到JComponent或Node上的那一層。所以只引jxbrowser不引jxbrowser-swingBrowserView.newInstance(browser)會(huì)直接找不到類。真正的體積大頭在 classifier 上。7.x 的坐標(biāo)長(zhǎng)這樣!-- 核心 API必引 -- dependency groupIdcom.teamdev.jxbrowser/groupId artifactIdjxbrowser/artifactId version7.19/version !-- cross-desktop 把 win64/linux64/mac64/mac64arm 的原生庫(kù)全塞進(jìn)一個(gè) jar 開發(fā)期省事發(fā)布期建議換成單平臺(tái) classifier -- classifiercross-desktop/classifier /dependency !-- Swing 宿主視圖 -- dependency groupIdcom.teamdev.jxbrowser/groupId artifactIdjxbrowser-swing/artifactId version7.19/version /dependencyGradle 寫法等價(jià)dependencies { implementation(com.teamdev.jxbrowser:jxbrowser:7.19:cross-desktop) implementation(com.teamdev.jxbrowser:jxbrowser-swing:7.19) }這里的關(guān)鍵參數(shù)是classifier。cross-desktop是“全平臺(tái) fat jar”好處是同一份依賴在 Windows 開發(fā)機(jī)、Linux 構(gòu)建機(jī)、Mac 上都能直接跑壞處是每個(gè)平臺(tái)的chrome可執(zhí)行文件和.dll/.so/.dylib都在里面包體直接翻幾倍。發(fā)布階段我一般會(huì)改成單平臺(tái) classifier——win64、linux64、mac64、mac64arm這幾個(gè)按目標(biāo)平臺(tái)分別構(gòu)建安裝包能瘦一大圈。JDK 版本上7.x 的編譯目標(biāo)是 Java 8所以 8、11、17 都能跑我這邊的 11 和 17 環(huán)境都驗(yàn)證過。至于 21 及以上得看構(gòu)件是否帶了對(duì)應(yīng)的模塊化描述動(dòng)手前先寫個(gè)Engine.newInstance的 ten 行 demo 試一下比看文檔快。2.2 渲染模式選型HARDWARE_ACCELERATED 和 OFF_SCREEN 差在哪這一步選錯(cuò)后面所有界面問題都是它引起的。7.x 的RenderingMode實(shí)際上就兩條路模式渲染路徑優(yōu)點(diǎn)代價(jià)HARDWARE_ACCELERATED內(nèi)核開原生窗口直接疊在宿主窗口上性能接近獨(dú)立瀏覽器視頻、Canvas 都流暢z-order 由操作系統(tǒng)管Swing 的彈窗、JPopupMenu會(huì)被瀏覽器視圖蓋住OFF_SCREEN渲染到離屏緩沖再合成到 Swing 組件上能被 Swing 正常遮擋、能截圖、能透明疊加必須手動(dòng)resize滾動(dòng)和輸入事件得自己轉(zhuǎn)發(fā)滾動(dòng)幀率明顯低一檔判斷標(biāo)準(zhǔn)很樸素如果你的界面里瀏覽器區(qū)域是“一整塊不跟別的組件重疊的矩形”選HARDWARE_ACCELERATED如果需要在這個(gè)區(qū)域上浮一層自定義的 Swing 控件、或者要對(duì)著頁(yè)面做截圖和錄像、或者要嵌進(jìn)帶透明背景的面板里選OFF_SCREEN。OFF_SCREEN有一個(gè)幾乎人人都會(huì)踩的點(diǎn)不調(diào)resize就是一片白。它不是自動(dòng)跟隨容器尺寸的必須顯式告訴內(nèi)核畫布多大// 離屏模式下必須先給出畫布尺寸否則內(nèi)核不知道渲染多大表現(xiàn)為純白 browser.resize(1280, 800); BrowserView view BrowserView.newInstance(browser); // 組件尺寸變化時(shí)要同步回去否則拉伸窗口后頁(yè)面還是舊尺寸 view.addComponentListener(new ComponentAdapter() { Override public void componentResized(ComponentEvent e) { browser.resize(Math.max(1, view.getWidth()), Math.max(1, view.getHeight())); } });resize的寬高必須大于 0最小化窗口時(shí)如果傳 0內(nèi)核那邊會(huì)拋參數(shù)異常所以上面加了Math.max(1, ...)兜底。這一行是血淚經(jīng)驗(yàn)不加的話用戶一最小化再還原就崩。2.3 內(nèi)核落地目錄別讓首次啟動(dòng)去解壓臨時(shí)目錄Engine.newInstance第一次執(zhí)行時(shí)會(huì)把 Chromium 內(nèi)核解壓出來。默認(rèn)落到系統(tǒng)臨時(shí)目錄下的一個(gè)帶版本號(hào)的子目錄里。開發(fā)機(jī)上無所謂生產(chǎn)環(huán)境就有兩個(gè)隱患一是臨時(shí)目錄可能被安全策略限制寫入二是某些清理工具會(huì)把臨時(shí)目錄當(dāng)垃圾掃掉用戶第二天打開軟件就報(bào)內(nèi)核加載失敗。所以我一般會(huì)顯式指定內(nèi)核目錄Path base Paths.get(System.getProperty(user.home), .myapp); Path chromiumDir base.resolve(chromium); EngineOptions options EngineOptions.newBuilder(RenderingMode.HARDWARE_ACCELERATED) // license 單獨(dú)封裝別硬編碼在源碼里也別提交到倉(cāng)庫(kù) .licenseKey(LicenseStore.load()) // 內(nèi)核落地目錄要求可寫預(yù)留至少 500MB 空間 .chromiumDir(chromiumDir) // 虛擬機(jī)和遠(yuǎn)程桌面環(huán)境下關(guān)掉著色器緩存能少一類花屏問題 .addSwitch(--disable-gpu-shader-disk-cache) .build(); Engine engine Engine.newInstance(options);三個(gè)參數(shù)逐個(gè)說。licenseKey是必填的7.x 沒有合法 license 會(huì)在newInstance階段直接拋異常不是運(yùn)行到一半才攔。chromiumDir指定解壓目標(biāo)一旦指定后續(xù)啟動(dòng)會(huì)復(fù)用這份內(nèi)核不再重復(fù)解壓冷啟動(dòng)能從幾十秒降到幾百毫秒。addSwitch是往 Chromium 命令行透?jìng)鏖_關(guān)等價(jià)于你在啟動(dòng) chrome 時(shí)加參數(shù)排障時(shí)特別有用——花屏加--disable-gpu字體渲染異常試--disable-font-subpixel-positioning。如果chromiumDir這個(gè)構(gòu)建器方法報(bào)“找不到符號(hào)”先別懷疑自己寫錯(cuò)了多半是拿到的構(gòu)件不是標(biāo)準(zhǔn) 7.19 的官方構(gòu)建被重新打包過。版本對(duì)不上的包后面還會(huì)在內(nèi)核版本、license 校驗(yàn)上出各種玄學(xué)問題。指定完目錄要驗(yàn)證進(jìn)到~/.myapp/chromium下應(yīng)該能看到一個(gè)chromeWindows 上是chrome.exe加一堆動(dòng)態(tài)庫(kù)總大小幾百 MB。如果目錄是空的說明參數(shù)沒生效或者寫入被攔了去看日志里有沒有被吞掉的IOException。3. 最小閉環(huán)Engine 單例、Browser 多開、BrowserView 掛載依賴?yán)眄樍私酉聛硎前岩粋€(gè)能跑的窗口搭出來。這三層對(duì)象的生命周期差別很大混著用是后面卡頓和進(jìn)程泄漏的根源Engine是重對(duì)象一個(gè)進(jìn)程只能有一個(gè)Browser是輕對(duì)象可以開很多個(gè)BrowserView只是把某個(gè)Browser的畫面貼到某個(gè)組件上不持有內(nèi)核狀態(tài)。3.1 一個(gè)線程安全的 Engine 持有類Engine.newInstance是阻塞的而且內(nèi)部會(huì)拉起一整套 Chromium 子進(jìn)程。放在 EDT 上執(zhí)行界面會(huì)直接凍住十幾秒——這不是性能問題是“用戶以為程序掛了”的問題。所以我把引擎初始化單獨(dú)抽出來public final class BrowserEngineHolder { private static volatile Engine instance; public static Engine get() { Engine local instance; if (local null) { synchronized (BrowserEngineHolder.class) { local instance; if (local null) { EngineOptions options EngineOptions.newBuilder(RenderingMode.HARDWARE_ACCELERATED) .licenseKey(LicenseStore.load()) .chromiumDir(Paths.get(System.getProperty(user.home), .myapp, chromium)) .build(); local Engine.newInstance(options); instance local; // 兜底關(guān)閉防止用戶直接關(guān)進(jìn)程留下僵尸子進(jìn)程 Runtime.getRuntime().addShutdownHook(new Thread(local::close, jxbrowser-shutdown)); } } } return local; } private BrowserEngineHolder() { } }雙檢鎖是為了保證并發(fā)調(diào)用時(shí)只創(chuàng)建一個(gè)引擎。很多項(xiàng)目啟動(dòng)時(shí)會(huì)并發(fā)初始化多個(gè)業(yè)務(wù)面板如果每個(gè)面板都newInstance你會(huì)看到任務(wù)管理器里瞬間冒出幾組 Chromium 進(jìn)程每個(gè)都占幾百 MB還互相搶 GPU 進(jìn)程。addShutdownHook那一行是后悔藥。用戶在任務(wù)管理器里結(jié)束進(jìn)程時(shí)JVM 的關(guān)閉鉤子仍會(huì)執(zhí)行能把這批 Chromium 子進(jìn)程一起收掉沒有它異常退出后下次啟動(dòng)可能出現(xiàn)端口/鎖文件沖突。這個(gè)get()必須在啟動(dòng)階段、非 EDT 線程上預(yù)熱一次。我一般放在 splash 界面加載時(shí)用SwingWorker里跑界面先顯示“正在初始化瀏覽器內(nèi)核…”。3.2 Browser 的創(chuàng)建與 URL 加載時(shí)機(jī)Browser很便宜engine.newBrowser()通常在幾十毫秒內(nèi)返回。真正耗時(shí)的是頁(yè)面導(dǎo)航。所以創(chuàng)建和加載要分開看Engine engine BrowserEngineHolder.get(); Browser browser engine.newBrowser(); BrowserView view BrowserView.newInstance(browser); panel.setLayout(new BorderLayout()); panel.add(view, BorderLayout.CENTER); // 導(dǎo)航是異步的這里返回不代表頁(yè)面已經(jīng)加載完 browser.navigation().loadUrl(https://report.internal/dashboard); // 加載完成事件里再做 DOM 注入、JS 通信這類事 browser.navigation().on(FinishLoading.class, event - { LOG.info(loaded: {}, event.url()); });loadUrl是異步的。緊接著在下一行去executeJavaScript經(jīng)常拿到的是null或者空對(duì)象因?yàn)?DOM 還沒建完。所有依賴頁(yè)面結(jié)構(gòu)的操作都得掛在FinishLoading或DocumentLoaded回調(diào)里。同一個(gè)Browser可以重復(fù)用切換頁(yè)面用loadUrl或loadHtml不需要關(guān)掉重建。但換業(yè)務(wù)模塊時(shí)建議browser.close()再新建一個(gè)——不是必須只是把可能泄漏的 JS 定時(shí)器和事件監(jiān)聽一起清掉。BrowserView.newInstance(browser)這個(gè)方法名在HARDWARE_ACCELERATED和OFF_SCREEN下是同一個(gè)差異在Engine那邊就定了。所以渲染模式必須在建引擎時(shí)就定死中途改不了。3.3 關(guān)閉順序先 browser 后 engine關(guān)閉順序錯(cuò)了控制臺(tái)會(huì)刷一堆IllegalStateException嚴(yán)重的時(shí)候進(jìn)程退不干凈。正確順序是自下而上// 關(guān)閉單個(gè)瀏覽器視圖 browser.close(); // 應(yīng)用退出時(shí)再關(guān)引擎順序不能反 engine.close();browser.close()會(huì)釋放這個(gè)頁(yè)面的渲染進(jìn)程和所有 JS 上下文engine.close()會(huì)終止整個(gè) Chromium 進(jìn)程組。如果先engine.close()再browser.close()后者會(huì)對(duì)一個(gè)已經(jīng)失效的引擎發(fā)指令拋異常如果只關(guān)窗口不close瀏覽器渲染進(jìn)程會(huì)一直掛著用戶反復(fù)打開關(guān)閉同一個(gè)模塊進(jìn)程數(shù)會(huì)一路漲上去。一個(gè)常見的錯(cuò)誤寫法是在windowClosing里先調(diào)engine.close()再dispose()界面。改成先關(guān)所有Browser最后統(tǒng)一關(guān)Engine這類問題就沒了。4. 雙向通信JS 調(diào) Java、Java 注 JS、請(qǐng)求攔截頁(yè)面能顯示只是第一步。真正讓嵌入方案有價(jià)值的是雙向通信網(wǎng)頁(yè)里的按鈕要觸發(fā) Java 側(cè)的下載、Java 側(cè)要把登錄態(tài)塞給頁(yè)面、某些請(qǐng)求要在網(wǎng)絡(luò)層被改寫。JxBrowser 7.x 給了三層機(jī)制從輕到重依次是注入執(zhí)行、對(duì)象橋接、網(wǎng)絡(luò)攔截。4.1 JsAccessible 加 JsObject把 Java 對(duì)象掛到 window 上最省事的做法是把一個(gè)普通 Java 對(duì)象掛到window上頁(yè)面里直接當(dāng) JS 對(duì)象調(diào)用。前提是方法必須標(biāo)JsAccessible不標(biāo)的一律不可見——這既是安全邊界也避免把整個(gè)對(duì)象圖暴露出去public final class HostBridge { JsAccessible public String readToken() { return TokenStore.current(); } JsAccessible public void log(String message) { LOG.info([web] {}, message); } }掛載的時(shí)機(jī)必須等頁(yè)面加載完browser.navigation().on(FinishLoading.class, event - { browser.mainFrame().ifPresent(frame - { // executeJavaScript 返回 JsObject 時(shí)是頁(yè)面里的 window 本身 JsObject window frame.executeJavaScript(window); // 掛上去之后頁(yè)面里可以直接 hostBridge.readToken() window.putProperty(hostBridge, new HostBridge()); }); });frame.executeJavaScript(window)這里看起來有點(diǎn)繞但它返回的就是頁(yè)面window的JsObject引用putProperty相當(dāng)于在頁(yè)面里執(zhí)行window.hostBridge {...}。參數(shù)名這里是hostBridge就是頁(yè)面?zhèn)仍L問用的全局變量名別跟業(yè)務(wù)里已有的變量撞。注意兩點(diǎn)。第一JsAccessible方法是在哪個(gè)線程被調(diào)用的取決于內(nèi)核回調(diào)線程不是 EDT方法體里如果要改 Swing 組件必須SwingUtilities.invokeLater包一層否則就是經(jīng)典的隨機(jī)崩潰。第二參數(shù)和返回值只支持基礎(chǔ)類型和字符串傳自定義對(duì)象會(huì)靜默變成undefined這個(gè)坑很隱蔽。4.2 executeJavaScript 的返回值邊界Promise 不是值executeJavaScript看著像個(gè)萬能入口實(shí)際上它只能同步拿到表達(dá)式的即時(shí)結(jié)果。頁(yè)面里fetch(...)、async函數(shù)返回的是一個(gè) Promise 對(duì)象你拿到的是JsObject不是數(shù)據(jù)// 錯(cuò)誤示范拿到的不是數(shù)據(jù)是 Promise 的包裝對(duì)象 Object wrong frame.executeJavaScript(fetch(/api/profile).then(r r.json())); // 可行做法讓頁(yè)面同步返回序列化好的字符串 String json frame.executeJavaScript(JSON.stringify(window.__profile || null));所以我的習(xí)慣是不指望從executeJavaScript直接取異步結(jié)果而是在頁(yè)面?zhèn)葤煲粋€(gè)回調(diào)函數(shù)Java 側(cè)先注冊(cè)橋接對(duì)象頁(yè)面拿到數(shù)據(jù)后主動(dòng)調(diào)hostBridge.onProfileLoaded(json)。這樣數(shù)據(jù)流向是單向的、可追蹤的出問題也容易定位。JSON.stringify那一步別省。JxBrowser 對(duì) JS 對(duì)象的自動(dòng)轉(zhuǎn)換只覆蓋基礎(chǔ)類型直接返回Object或者數(shù)組經(jīng)常得到一個(gè)看起來像數(shù)組、實(shí)際取不到值的怪東西也不好斷點(diǎn)。序列化成字符串Java 側(cè)用任意 JSON 庫(kù)解析行為最確定。4.3 網(wǎng)絡(luò)攔截BeforeUrlRequest 攔請(qǐng)求、BeforeSendHeaders 改頭網(wǎng)絡(luò)層是這套方案里最容易被低估的能力。engine.network()上可以訂閱一系列事件用來做請(qǐng)求阻斷、請(qǐng)求頭注入、mock 響應(yīng)// 阻斷某個(gè)路徑下的所有請(qǐng)求常用于屏蔽頁(yè)面里的第三方統(tǒng)計(jì)腳本 engine.network().on(BeforeUrlRequest.class, event - { if (event.url().contains(/legacy/)) { event.preventDefault(); // 攔掉頁(yè)面?zhèn)缺憩F(xiàn)為請(qǐng)求失敗 } }); // 給所有出站請(qǐng)求補(bǔ)一個(gè)客戶端標(biāo)識(shí)后端按這個(gè)標(biāo)識(shí)下發(fā)不同版本 engine.network().on(BeforeSendHeaders.class, event - { HttpHeaders headers event.headers().toBuilder() .add(X-Client, desktop/1.0) .build(); event.setHeaders(headers); });BeforeUrlRequest觸發(fā)在請(qǐng)求發(fā)出之前preventDefault()就是阻斷頁(yè)面里對(duì)應(yīng)的fetch會(huì)走 reject 分支所以頁(yè)面?zhèn)纫卸档滋幚矸駝t用戶看到的是一個(gè)一直轉(zhuǎn)圈的加載態(tài)。BeforeSendHeaders觸發(fā)在請(qǐng)求頭組裝完成之后headers().toBuilder()拷一份再改不要直接改原對(duì)象。這兩個(gè)接口在不同小版本之間簽名略有出入寫的時(shí)候靠 IDE 補(bǔ)全確認(rèn)參數(shù)類型別照抄網(wǎng)上的老代碼。另外網(wǎng)絡(luò)事件回調(diào)不保證在 EDT 上回調(diào)體里做重活比如寫數(shù)據(jù)庫(kù)、讀大文件會(huì)拖慢整個(gè)網(wǎng)絡(luò)層建議只做判斷和轉(zhuǎn)發(fā)。5. 避坑與排查許可證、首次啟動(dòng)、EDT、進(jìn)程殘留、打包五個(gè)翻車點(diǎn)前面四章都是“怎么跑起來”這一章講“為什么跑不起來”。下面五個(gè)問題是我在不同項(xiàng)目里反復(fù)遇到的按出現(xiàn)頻率排。每個(gè)都按現(xiàn)象、原因、解決三段寫遇到了直接對(duì)號(hào)入座。5.1 許可證與內(nèi)核來源兩個(gè)最容易被忽略的前置條件現(xiàn)象一本地開發(fā)一切正常換到測(cè)試機(jī)或者打包后運(yùn)行啟動(dòng)即拋異常提示 license 缺失或無效。原因7.x 的 license 校驗(yàn)發(fā)生在Engine.newInstance而且它是跟簽發(fā)時(shí)的應(yīng)用標(biāo)識(shí)綁定的不是隨便一個(gè)字符串都能過。另外把 license 硬編碼進(jìn)源碼、或者放在沒被打進(jìn)安裝包的資源目錄里都會(huì)導(dǎo)致運(yùn)行期讀不到。解決把 license 的讀取抽成單獨(dú)一層優(yōu)先讀外部配置文件其次讀環(huán)境變量最后才回落到打包內(nèi)的資源。啟動(dòng)時(shí)把 key 的前 8 位打進(jìn)日志不要打全量一眼就能看出讀到的是不是預(yù)期那一份。生產(chǎn)環(huán)境更穩(wěn)的做法是把 license 放在安裝目錄的conf/下隨配置一起下發(fā)方便替換?，F(xiàn)象二chromiumDir指定了目錄卻始終是空的或者目錄里有文件但程序報(bào)內(nèi)核版本不匹配。原因拿到的構(gòu)件被重新打包過classifier 里的原生庫(kù)和jxbrowser核心包的版本對(duì)不上。這種情況在來源不明的整合包里特別常見。解決核對(duì) jar 的清單文件里的版本號(hào)和依賴聲明里的7.19是否一致。對(duì)不上就換回標(biāo)準(zhǔn)構(gòu)件。生產(chǎn)項(xiàng)目不要用來源不明的整合包出了問題沒有任何線索可查純屬給自己埋雷。5.2 線程與卡死在 EDT 上碰 Engine 的代價(jià)現(xiàn)象雙擊圖標(biāo)后窗口白屏十幾秒到一分鐘進(jìn)度條不動(dòng)Windows 直接標(biāo)“未響應(yīng)”。原因Engine.newInstance在 EDT 上執(zhí)行。首次運(yùn)行要解壓幾百 MB 的內(nèi)核文件這段時(shí)間 EDT 被完全占住Swing 連重繪都做不了。解決把引擎初始化放到啟動(dòng)線程或者SwingWorker#doInBackground里界面先顯示一個(gè) splash 或者“初始化中”的占位面板初始化完成后再切到主界面。第二次及以后的啟動(dòng)因?yàn)閮?nèi)核已解壓通常幾百毫秒就夠但代碼不能假設(shè)“一定是第二次”。現(xiàn)象點(diǎn)擊頁(yè)面按鈕后整個(gè)界面卡住幾秒然后恢復(fù)日志里能看到 JS 調(diào)用記錄。原因在 EDT 上同步等待executeJavaScript的結(jié)果或者JsAccessible方法體里做了阻塞 IO。解決橋接方法里只做輕量轉(zhuǎn)換把耗時(shí)邏輯丟到線程池需要的返回值通過回調(diào)再送回頁(yè)面。判斷標(biāo)準(zhǔn)很簡(jiǎn)單——橋接方法體超過 10 行就該拆了。5.3 進(jìn)程與打包任務(wù)管理器里的進(jìn)程數(shù)是最好的體檢指標(biāo)現(xiàn)象反復(fù)打開關(guān)閉同一個(gè)業(yè)務(wù)模塊任務(wù)管理器里 Chromium 相關(guān)進(jìn)程數(shù)一路往上漲內(nèi)存也跟著漲最后 OOM。原因只把BrowserView從容器里remove了沒有browser.close()。視圖沒了但渲染進(jìn)程和 JS 上下文還活著。解決把browser.close()和界面銷毀綁在一起寫在一個(gè)統(tǒng)一的dispose()方法里模塊卸載時(shí)必調(diào)。上線前做一次“打開關(guān)閉 20 次”的壓測(cè)看進(jìn)程數(shù)是否回到初始值這是最直接的驗(yàn)證手段?，F(xiàn)象開發(fā)機(jī)能跑打成安裝包后安裝到干凈機(jī)器上界面一片空白日志里沒有任何異常。原因內(nèi)核二進(jìn)制沒進(jìn)安裝包或者進(jìn)了包但被安全軟件攔在臨時(shí)目錄外或者目標(biāo)機(jī)器的用戶目錄沒有寫權(quán)限。解決顯式指定chromiumDir到安裝目錄下的子目錄并在安裝包里預(yù)置好這份內(nèi)核跳過首次解壓。安裝完成后加一步校驗(yàn)檢查目錄下chrome可執(zhí)行文件是否存在、動(dòng)態(tài)庫(kù)數(shù)量是否與預(yù)期一致。這一步能擋掉大部分“換臺(tái)機(jī)器就不行”的問題。6. 上線前的自檢把內(nèi)核版本、線程歸屬和關(guān)閉行為都打出來調(diào)到后期問題往往不是“跑不起來”而是“跑起來但行為不對(duì)”。我習(xí)慣在動(dòng)手寫業(yè)務(wù)代碼之前先跑一段自檢把三個(gè)不確定因素量化出來內(nèi)核到底是什么版本、回調(diào)落在哪個(gè)線程、關(guān)閉之后進(jìn)程有沒有真的退干凈。public final class BrowserSelfCheck { public static void main(String[] args) throws Exception { Engine engine BrowserEngineHolder.get(); System.out.println(engine created on: Thread.currentThread().getName()); Browser browser engine.newBrowser(); browser.navigation().loadUrl(about:blank); browser.navigation().on(FinishLoading.class, event - { // UA 里 Chrome/xx 那段就是內(nèi)核真實(shí)版本比看文檔靠譜 System.out.println(userAgent browser.userAgent()); // 回調(diào)線程名能直接告訴你這里能不能碰 Swing System.out.println(callback thread Thread.currentThread().getName()); // 離屏模式下這一行必須 0否則就是白屏 System.out.println(viewport browser.mainFrame().isPresent()); }); Thread.sleep(3000); browser.close(); engine.close(); // 正常情況這行打印后 1~2 秒內(nèi)進(jìn)程列表里的 Chromium 子進(jìn)程應(yīng)全部消失 System.out.println(closed, check process list now); } }三個(gè)輸出各有用途。userAgent里的Chrome/后面那段數(shù)字是內(nèi)核真實(shí)版本比你翻構(gòu)件元數(shù)據(jù)可靠——如果它和你預(yù)期的代際差得遠(yuǎn)說明內(nèi)核目錄里躺著一份舊的解壓結(jié)果刪掉chromiumDir重來。callback thread決定了你的回調(diào)體能不能直接操作界面名字不是AWT-EventQueue-0的一律得包invokeLater。最后那句closed打印完之后去任務(wù)管理器看一眼子進(jìn)程如果還在就是某個(gè)Browser沒關(guān)。這段代碼我一般會(huì)做成一個(gè)隱藏的“診斷”菜單項(xiàng)讓現(xiàn)場(chǎng)實(shí)施的人也能點(diǎn)一下把三行輸出貼回來。比讓用戶描述“有時(shí)候會(huì)卡”有用得多。從那以后我每次把 jxbrowser 塞進(jìn)新項(xiàng)目都強(qiáng)制先跑一遍這段自檢再談業(yè)務(wù)邏輯——省下來的排查時(shí)間比寫這段代碼的時(shí)間多得多。手上這份 7.19 的包建議也先按這個(gè)順序跑通再加功能。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取