如何让JavaFX WebEngine输出详细错误并解决模块导出访问异常？

问题根因说明 #

该报错是JDK 9+模块强封装规则导致的，你之前配置未生效大概率是启动参数作用范围不对，或者Maven运行插件未同步配置导出规则，可按照以下步骤依次排查修复：

第一步：校正IDEA本地运行参数 #

• 打开IDEA对应项目的运行/调试配置，确认--add-exports参数写在VM选项栏，不是程序参数栏，参数格式如下：
  • 非模块化项目（无module-info.java）：

    --add-exports javafx.web/com.sun.javafx.webkit=ALL-UNNAMED
    

  • 模块化项目（有module-info.java）：将ALL-UNNAMED替换为你自己的模块名

    --add-exports javafx.web/com.sun.javafx.webkit=你的自定义模块名
    

第二步：同步Maven插件配置 #

如果使用javafx-maven-plugin启动项目，需要在pom.xml的插件配置中同步添加导出规则，否则IDEA默认读取插件配置会覆盖手动添加的VM参数：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <mainClass>你的主类全限定名</mainClass>
        <vmArgs>
            --add-exports javafx.web/com.sun.javafx.webkit=ALL-UNNAMED
        </vmArgs>
    </configuration>
</plugin>

模块化项目同样替换ALL-UNNAMED为你的模块名即可。

第三步：校验module-info.java配置 #

如果是模块化项目，不需要在module-info.java中写额外的exports语句，只需要确保已声明javafx.web依赖：

module 你的自定义模块名 {
    requires javafx.web;
    // 其他依赖声明保持不变
}

备选兼容方案（不依赖内部API） #

如果不想依赖com.sun包下的不稳定内部API（后续JavaFX版本可能移除），可以通过JS注入重定向console输出实现日志监听：

• 注入console重定向代码：

  webEngine.getLoadWorker().stateProperty().addListener((obs, oldState, newState) -> {
      if (newState == Worker.State.SUCCEEDED) {
          JSObject window = (JSObject) webEngine.executeScript("window");
          window.setMember("javaConsole", new CustomConsole());
          webEngine.executeScript("""
              console.log = msg => javaConsole.log(msg);
              console.error = msg => javaConsole.error(msg);
              console.warn = msg => javaConsole.warn(msg);
          """);
      }
  });
  

• 自定义控制台接收类：

  public class CustomConsole {
      public void log(String msg) {
          System.out.println("[Web日志] " + msg);
      }
      public void error(String msg) {
          System.err.println("[Web错误] " + msg);
      }
      public void warn(String msg) {
          System.out.println("[Web警告] " + msg);
      }
  }
  

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