MPXJ(Java)读取mpp文件时无法读取全部任务项如何解决

问题现象 #

Java环境下使用mpxj库读取mpp格式文件时，多数文件可正常完整解析，少数文件存在任务跳过、读取不全问题：经核对问题文件内共包含约58个任务，代码运行后仅能读取到14个任务，对应示例代码、问题样例mpp文件随问题同步提供。

排查解决步骤 #

• 升级mpxj依赖到最新正式版
  mpxj对不同版本Microsoft Project生成的mpp文件适配存在版本差异，旧版本对高版本Project新增的任务字段、存储结构适配不全，很容易出现解析截断。同类问题中超半数是版本适配导致，直接升级到官方最新正式版重试即可解决。
• 排查自定义过滤逻辑误拦截
  移除所有任务读取环节的自定义过滤规则，不要默认过滤摘要任务、非活动任务、折叠状态的大纲子任务，也不要仅通过顶层任务递归遍历子节点的方式统计任务数，直接调用project.getAllTasks()获取全量任务集合计数，避免大纲层级解析异常、过滤条件过严漏掉有效任务。
• 开启DEBUG日志定位解析异常
  将mpxj包的日志级别调整为DEBUG后重新读取问题文件，查看日志输出：默认配置下mpxj遇到局部数据块解析失败、字段格式不匹配时不会抛出全局异常，只会跳过异常数据块继续向后解析，很容易出现后半段任务丢失的情况，根据日志提示的失败点调整对应解析配置即可。
• 校验mpp文件本身有效性
  用Microsoft Project打开问题文件，确认是否存在文件损坏提示，将文件重新另存为无加密的标准mpp格式后再尝试读取。从第三方项目管理系统导出、经其他工具二次编辑的mpp文件容易出现数据块偏移、文件头损坏问题，会导致mpxj仅能解析文件前半段内容。
• 调整解析配置适配特殊场景
  如果问题文件包含跨项目任务链接、大量自定义字段、受保护内容，初始化MPPReader时手动调整配置，强制全字段读取、关闭容易触发解析中断的非必要逻辑，参考配置：

  MPPReader reader = new MPPReader();
  // 开启全字段读取
  reader.setReadAllFields(true);
  // 关闭跨项目链接解析，避免外链任务导致解析中断
  reader.setRespectCrossProjectLinks(false);
  ProjectFile project = reader.read(mppFileInputStream);
  

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