JEditorPaneHTMLEditorKitParserMethodIllegalBlockingMode非法阻塞模式

本文目录导读：

1. 如何定位和修复
2. 完整的修复建议

看起来你遇到了一个与 JEditorPane、HTMLEditorKit 或底层解析器相关的 “非法阻塞模式” (Illegal Blocking Mode) 错误。

这个错误通常不是 JEditorPane 或 HTMLEditorKit 本身直接抛出的标准 Java 异常,而更可能是以下两种情况之一：

1. NIO (New I/O) 非阻塞通道错误：这个错误信息 (IllegalBlockingModeException) 是 java.nio.channels 包中特有的，它发生在你尝试对处于非阻塞模式的 SocketChannel 或 ServerSocketChannel 调用阻塞 I/O 操作（如 read()、write()、accept()）时。
2. SwingWorker 或自定义解析器中的线程问题：你在 JEditorPane 加载 HTML 或自定义 HTMLEditorKit.Parser 时，可能在错误的线程（非事件调度线程 EDT）或错误的 I/O 上下文中执行了操作。

最可能的核心原因：你在非阻塞 NIO 通道上尝试执行阻塞式读取（用于加载 HTML）,而该通道并未被设置为阻塞模式。

如何定位和修复

请先检查你的代码中是否有以下模式：

场景1：你使用了 NIO SocketChannel 并试图将其用于 JEditorPane

// 错误示例
SocketChannel channel = SocketChannel.open();
channel.configureBlocking(false); // 设置为非阻塞模式
// 然后你试图将 channel 的 InputStream 传给 JEditorPane
// 或者直接试图在 channel 上执行阻塞 read
channel.read(buffer); // 如果配置为非阻塞，这里就会抛 IllegalBlockingModeException

修复方法：

• 如果你需要阻塞读取（例如加载 HTML 内容），不要调用 channel.configureBlocking(false)。
• 或者，在使用 JEditorPane 加载数据之前，显式设置为阻塞模式：

  channel.configureBlocking(true);

场景2：你在 SwingWorker 或后台线程中错误地重写了 HTMLEditorKit.Parser 的 callback

如果你自定义了一个 HTMLEditorKit.ParserCallback，并在 handleText、handleStartTag 等方法中进行了阻塞 I/O 操作，且该 I/O 通道处于非阻塞模式,也可能触发此异常。

// 示例：不推荐的做法
parser.parse(new StringReader(html), new HTMLEditorKit.ParserCallback() {
    @Override
    public void handleText(char[] data, int pos) {
        // 如果在这里尝试进行阻塞式网络 I/O (例如读取另一个URL)，
        // 且该通道是非阻塞的，就会报错
        readFromNonBlockingChannel(); 
    }
}, true);

修复方法：

• 不要在解析回调中进行阻塞网络 I/O。
• 如果需要下载子资源,应在解析前完成或使用异步方式。

场景3：关键字误拼或库冲突

检查异常栈的准确信息,如果错误信息是：

Exception in thread "AWT-EventQueue-0" java.nio.channels.IllegalBlockingModeException

那一定是 NIO 问题，如果是其他拼写或自定义异常,则可能是：

• 你继承或使用了某个第三方库,它内部在非阻塞模式下调用了阻塞方法。
• 你的代码中 JEditorPane 的 setPage() 方法内部需要从 URL 读取数据，而该 URL 连接到了一个非阻塞通道。

完整的修复建议

1. 检查所有网络 I/O 代码：查找 SocketChannel、ServerSocketChannel、DatagramChannel，确保你在需要阻塞操作（如读取整个 HTTP 响应给 JEditorPane）时，调用了 configureBlocking(true)。

2. 避免在 EDT 中执行网络 I/O：JEditorPane.setPage(url) 内部会进行网络请求，应在 SwingWorker 的后台线程中先下载 HTML 字符串，然后使用 setText() 设置到 EDT 中，这样可以避免 NIO 状态混乱。

   // 推荐做法
   SwingWorker<String, Void> worker = new SwingWorker<String, Void>() {
       @Override
       protected String doInBackground() throws Exception {
           // 使用标准阻塞式 HttpURLConnection 下载
           URL url = new URL("http://example.com");
           HttpURLConnection conn = (HttpURLConnection) url.openConnection();
           // ... 读取为 String
           return htmlContent;
       }
       @Override
       protected void done() {
           try {
               String html = get();
               // 确保在 EDT 中设置
               SwingUtilities.invokeLater(() -> editorPane.setText(html));
           } catch (Exception e) {
               e.printStackTrace();
           }
       }
   };
   worker.execute();

3. 检查是否误用了 NIO.2 (AsynchronousSocketChannel)：AsynchronousSocketChannel 也是非阻塞的,不要直接在其上调用阻塞读。

4. 检查自定义 HTMLEditorKit：如果你继承 HTMLEditorKit 并重写了 createParser() 方法,确保返回的解析器不依赖于非阻塞通道。

如果你能提供完整的异常堆栈跟踪（stack trace），我可以给出更精确的定位。