本文目录导读：
- 确保所有 UI 更新在 Event Dispatch Thread (EDT) 上执行
- 不要在加载过程中重复设置内容或操作文档
- 同一个 JEditorPane 不要复用不同的 EditorKit
- 显式重置或使用 read() 方法代替 setText()
- 检查 ParserDelegator 和 HTMLReader 的重用
- 完整示例（安全写法）
- 如果以上方法都无效：
这个错误信息看起来像是 Java 的 JEditorPane 和 HTMLEditorKit 在使用过程中遇到的一个 内部状态冲突 问题，或者在解析 HTML 内容时发生了异常（可能是由于 Parser（解析器）与文档或编辑器之间出现了连接冲突）。
虽然错误信息不完全标准（像是多个类名拼在了一起），通常你的实际错误栈（stack trace）中会包含像 ParserDelegator 或 HTMLDocument.HTMLReader 相关的异常。
根据描述“已连接”（Already Connected），根本原因通常是 尝试多次加载、修改或重新设置 HTML 内容时，导致 HTMLEditorKit 内部的解析器状态被破坏，或线程安全问题导致同时连接。
以下是几种解决方案,按推荐程度排序：
确保所有 UI 更新在 Event Dispatch Thread (EDT) 上执行
这是最可能的原因，如果你在非 AWT 事件线程（比如后台线程或 main 方法）中调用 setText() 或 read(),会导致状态混乱。
错误做法：
new Thread(() -> {
jEditorPane.setText("<html>..."); // 错误：不在 EDT 上
}).start();
正确做法：
SwingUtilities.invokeLater(() -> {
jEditorPane.setText("<html>...");
});
不要在加载过程中重复设置内容或操作文档
如果你在 HyperlinkListener 或自定义的解析回调中又去修改同一个 JEditorPane 的内容，会触发重入（re-entrant）连接错误。
解决方案： 加一个标志位或使用 SwingUtilities.invokeLater 推迟修改：
// 在监听器中：
public void hyperlinkUpdate(HyperlinkEvent e) {
if (e.getEventType() == HyperlinkEvent.EventType.ACTIVATED) {
SwingUtilities.invokeLater(() -> {
// 延迟修改，避免在解析过程中直接操作
jEditorPane.setText("新内容...");
});
}
}
同一个 JEditorPane 不要复用不同的 EditorKit
如果你曾经设置了 HTMLEditorKit，然后又切换为 PlainEditorKit，然后又切换回来,可能会导致底层的解析器泄漏或状态冲突。
解决方案： 只设置一次 EditorKit,不要频繁切换：
// 只设置一次，例如初始化时：
JEditorPane editor = new JEditorPane();
editor.setEditorKit(new HTMLEditorKit());
editor.setContentType("text/html");
显式重置或使用 read() 方法代替 setText()
setText() 导致了“已连接”错误，可以改为使用 read() 方法，并显式处理 Reader 连接。
替代方案：
try {
HTMLEditorKit kit = (HTMLEditorKit) editor.getEditorKit();
HTMLDocument doc = (HTMLDocument) editor.getDocument();
// 先移除所有文档监听器（如果有）
// ...
// 使用 Reader 重新加载
StringReader reader = new StringReader("<html><body>新内容</body></html>");
kit.read(reader, doc, 0);
reader.close();
} catch (Exception ex) {
ex.printStackTrace();
}
检查 ParserDelegator 和 HTMLReader 的重用
默认的 HTMLEditorKit 使用 ParserDelegator 进行 HTML 解析，如果该解析器实例正在被使用（比如在解析过程中），又尝试设置新内容，会出现“Already connected”错误。
解决方案： 确保在设置新内容之前,前一次解析完全完成：
- 不要在多线程中调用。
- 不要在事件回调中立即调用。
完整示例（安全写法）
import javax.swing.*;
import javax.swing.text.html.*;
import java.io.*;
public class SafeHTMLEditor {
private JEditorPane editor;
public void setHTMLContent(String html) {
SwingUtilities.invokeLater(() -> {
try {
HTMLEditorKit kit = (HTMLEditorKit) editor.getEditorKit();
HTMLDocument doc = (HTMLDocument) editor.getDocument();
// 保险做法：使用 Document 的 replace 或从头部开始写
doc.remove(0, doc.getLength());
StringReader reader = new StringReader(html);
kit.read(reader, doc, 0);
reader.close();
} catch (Exception e) {
e.printStackTrace();
}
});
}
}
如果以上方法都无效：
- 检查是否自定义了
ViewFactory并且返回了错误的组件。 - 检查是否动态加载了
<script>或<applet>导致 JavaScript 或插件在修改 DOM。 - 考虑升级 JDK（某些旧版本（如 Java 6/7）的 HTMLEditorKit 有已知 bug）。
这个问题90%的原因是 线程安全问题 或 重入修改，严格按照 EDT 线程 和 一次只做一件事 的原则处理,通常可以解决。
