ColdFusion调用Java MAPIMessage对象时报错求助

• 检查POI依赖完整性：报错提示找不到org.apache.poi.POIReadOnlyDocument，该类是POI 5.x及以上版本新增的核心类。需确认服务器上的POI相关jar包（如poi.jar、poi-scratchpad.jar）是否存在缺失、版本不匹配或被误删情况，对比之前正常运行时的jar包列表进行校验。
• 验证ColdFusion类加载路径：检查CF的Java类路径配置，确认POI相关jar包的路径未被近期更新（如CF补丁、服务器系统升级）修改。可通过代码输出当前类加载路径辅助排查：

  <cfset classLoader = createObject("java", "java.lang.ClassLoader").getSystemClassLoader()>
  <cfdump var="#classLoader.getURLs()#">
  

• 排查CF版本升级冲突：CF2023自带的POI版本可能与原项目依赖版本不兼容，导致MAPIMessage依赖的类无法被加载。查阅CF2023官方文档确认其集成的POI版本，对比原项目使用的版本是否存在兼容性问题。

方案1：使用第三方Java库解析.msg #

引入msgparser轻量级.msg解析库，将jar包放置到CF的WEB-INF/lib目录后，通过以下代码实现读取与PDF生成：

<!--- 加载msgparser核心类 --->
<cfset msgParser = createObject("java", "com.github.mangstadt.msg4j.parser.MessageParser")>
<cfset msg = msgParser.parse(fileReadBinary("path/to/target.msg"))>

<!--- 提取邮件核心信息 --->
<cfset subject = msg.getSubject()>
<cfset body = msg.getBody().getContent()>
<cfset sender = msg.getSender().getEmailAddress()>

<!--- 生成PDF --->
<cfdocument format="pdf" filename="email_output.pdf" overwrite="true">
    <h2>#subject#</h2>
    <p><strong>发件人：</strong>#sender#</p>
    <div>#body#</div>
</cfdocument>

方案2：命令行工具转格式后生成PDF #

借助msgconvert（Perl编写的.msg转EML工具）先将.msg转为EML格式，再通过CFPDF转换为PDF：

<!--- 调用msgconvert转换.msg为EML --->
<cfexecute name="msgconvert" 
            arguments="C:/path/input.msg C:/path/output.eml" 
            timeout="30" 
            variable="convertResult">
</cfexecute>

<!--- 用CFPDF将EML转为PDF --->
<cfpdf action="convert" 
       source="C:/path/output.eml" 
       destination="C:/path/final.pdf" 
       overwrite="true">
</cfpdf>

注：需先在服务器安装libemail-outlook-message-perl包（Linux）或对应的Windows版本工具。

方案3：Microsoft Graph API解析（需外网访问） #

将.msg文件上传至Microsoft Graph，调用API解析邮件内容后生成PDF。该方案需配置Azure应用权限，适合具备云服务支持的场景。

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