如何使用Apache POI在Word文档指定位置插入HTML内容？

完全可以在文档任意位置插入HTML内容，不需要局限于文档末尾。核心实现逻辑是先定位插入锚点，再调整altChunk在文档body中的插入位置，具体操作步骤如下：

• 定位插入锚点
  先确定你要插入HTML的目标位置，获取对应位置的XWPFParagraph对象作为锚点，比如你要在第N个段落后面插入，就取索引为N-1的段落对象。
• 构造altChunk基础信息
  给要插入的HTML内容分配唯一的chunk id，避免和文档内其他元素id冲突：

// 示例代码
String htmlContent = "<p>待插入的HTML内容</p>";
String chunkId = "htmlInsert_" + UUID.randomUUID().toString().replace("-", "");
XWPFParagraph anchorParagraph = document.getParagraphArray(targetInsertIndex);

• 调整altChunk插入位置
  这是和末尾插入逻辑的核心差异点，默认addNewAltChunk会把元素加到body末尾，需要手动调整到锚点位置之后：

CTBody docBody = document.getDocument().getBody();
CTAltChunk newAltChunk = docBody.addNewAltChunk();
newAltChunk.setId(chunkId);
// 计算锚点段落的位置，把altChunk插入到锚点后一位
int insertPosition = anchorParagraph.getCTP().newCursor().getAllPos() + 1;
docBody.setAltChunkArray(insertPosition, newAltChunk);
// 删除默认追加到末尾的冗余altChunk元素
docBody.removeAltChunk(docBody.sizeOfAltChunkArray() - 1);

• 绑定HTML内容到altChunk
  和原有逻辑一致，把HTML内容和分配的id绑定即可：

document.addAltChunk(AlternativeFormatInputType.HTML, htmlContent.getBytes(StandardCharsets.UTF_8), chunkId);

额外注意事项：如果需要插入到某个段落的中间位置，可以先把原段落从插入点拆分为前后两个独立段落，再把altChunk插入到两个段落中间即可。如果HTML内容存在中文或特殊字符，建议给HTML加上完整的<head><meta charset="UTF-8"></head>头包裹，避免格式识别异常。

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