一、问题描述
通过POI，把Word中的占位符替换为实际的值，以生成复杂结构的业务报告。
在POI 3.9上，功能正常。由于某些原因升级到POI 3.10.1后，项目组反馈说Word模板出错，无法生成Word文件，总是报解析错误。
二、问题分析
Word模板功能相关的代码应该说是比较稳定了，相关代码很久没有变动过，而且已经有投产项目在正式使用。现在出了问题，应该是升级POI版本导致的。
Word模板内容示例：
本期产品为向${ds:ds001,col:INVESTER_TYPE_NAME}发行的混合类理财产品，本期产品投资期限为${ds:ds001,col:TERM}天，收益率为${ds:ds001,col:YTM_100}%/年，为${ds:ds001,col:INCOME_TYPE_NAME}类产品，到期还本付息。是一款具有投资安全性高、回报率高重点的理财产品。
分析、调试代码。发现两个版本的POI在处理Paragraph.getRuns()有区别：
3.9版本：一个段落就是一个XWPFRun；
3.10.1版本：一个段落不知道根据什么规则，胡乱分成了List<XWPFRun>。如上述示例模板，会被切换为长度为14的List；
这样就导致获取、替换段落文本时出错。
三、问题解决
问题被定位后，就尝试解决。主要的思路，就是强制把List中的内容合并成一个字符串，替换内容后，把段落中的XWPFRun全部remove掉，然后新建一个含有替换后内容的XPWFRun，并赋给当前段落。
解决问题的过程中，“对于removeRun方法无法达到本应达成的预期效果的问题”，耗费了不少时间。总结来说：不能从0到size()移除Run，这样的话Run不会被移除；而应该从size()到0进行移除。
需要继续关注表格替换时是否会有问题。
解决这类第三方软件引起的问题，几乎没有道理可言，如果不想被埋在相关源代码中，只能靠经验+运气。
四、附代码
在3.10.1下有问题的代码示意：
while (itPara.hasNext()) {
XWPFParagraph paragraph = (XWPFParagraph) itPara.next();
int length = paragraph.getRuns().size();
if (length > 0) {
String text = paragraph.getText();
if (text.indexOf(tag) < 0) {
continue;
}
while (length-- > 0) {
paragraph.removeRun(0);
}
XWPFRun newrun = paragraph.insertNewRun(0);
newrun.setText(text.replace(tag, val));
}
}
修改后的代码示意：
while (itPara.hasNext()) {
XWPFParagraph paragraph = (XWPFParagraph) itPara.next();
int length = paragraph.getRuns().size();
if (length > 0) {
String text = StringUtils.join(paragraph.getRuns().toArray());
if (text.indexOf(tag) < 0) {
continue;
}
for (int i = (length - 1); i >= 0; i--) {
paragraph.removeRun(i);
}
XWPFRun newRun = paragraph.insertNewRun(0);
text = text.replaceAll(tag, val);
newRun.setText(text, 0);
}
}