POI向word2007文件插入图片时的Bug问题

最近项目中需要生成word文件，于是找到了Apache的POI开源项目，当前版本是4.1；

当然除了POI还有其它的选择，比如java2word、jcob等，但我都没用过，好像只能在windows上运行，于是决定还是使用POI。

下载了最新版本研究半天，感觉POI和其它的Apache项目相比在文档方面要逊色很多，POI的文档极其不全，甚至连Java API docs里都没有什么描述信息，类和方法都光秃秃的，很多东西都要去猜，很是郁闷...

幸好网上有不少博客，磕磕绊绊也能大体了解如何使用。

问题描述

由于项目暂时只考虑word2007及以上版本，所以我主要关注了XWPF部分。

在向生成的word文档中插入图片时遇到了如下问题：

1、使用XWPFRun类的addPicture方法插入图片时，生成的docx文件无法打开，word报如下问题：

2、使用XWPFDocument类的方法addPictureData插入图片时虽然不报异常，word也能打开生成的文件，但图片却无法显示出来，如果将word文件用解压缩文件打开，也能看到里面包含的图片文件，但在word中无法正常显示。

问题原因

于是百度Google了一番，发现遇到此问题的人还真不少，但少有人找到正确的解决方法，而且这是POI自身的Bug，详细情况请看这里：

https://issues.apache.org/bugzilla/show_bug.cgi?id=49765

这是老外程序员向Apache提出的Bug，提出时间 2010年，奇怪的是现在都2013年了，POI也发展到3.9版本了，问题依然没有解决（至少知道3.7和3.8是没有解决，如果3.9解决了，那就是我哪地方没做对；但我把3.9版本官方提供的例子运行起来，问题依旧，想必3.9也是存在该问题），不知道是什么原因。

虽然POI没有解决，但在下面的回复中还是有人找到了原因并提供了解决方案。

在回复的第14楼，有人这样回复：

https://issues.apache.org/bugzilla/show_bug.cgi?id=49765#c14

本人英文