QIIME2-2022.8多样性分析报错求助（Ubuntu系统）

问题场景 #

在Ubuntu 22.04.1 LTS x86_64环境下，通过conda安装QIIME2-2022.8，完成Moving Pictures教程后，处理自有数据或Atacama土壤教程数据时，执行以下core-metrics-phylogenetic命令：

qiime diversity core-metrics-phylogenetic \
  --i-phylogeny rooted-tree.qza \
  --i-table table.qza  \
  --p-sampling-depth 700 \
  --m-metadata-file sample-metadata.tsv  \
  --output-dir core-metrics-results

出现diversity插件报错：

Plugin error from diversity:

  Command '['ssu', '-i', '/tmp/qiime2/mike/data/67d50ad2-ce55-4192-9f83-c4254b86110c/data/feature-table.biom', '-t', '/tmp/qiime2/mike/data/7b8f5914-09aa-4e99-a53f-0e6310557047/data/tree.nwk', '-m', 'unweighted', '-o', '/tmp/q2-LSMatFormat-alcain3f']' returned non-zero exit status 1.

Debug info has been saved to /tmp/qiime2-q2cli-err-x3td01k5.log

解决方案 #

• 验证ssu依赖完整性
  激活QIIME2 conda环境后，执行ssu --help，若无法输出帮助信息，说明依赖未正确安装。重新安装diversity插件：

  conda install -c qiime2 qiime2-diversity-2022.8
  

  确保安装过程无报错。

• 检查输入文件有效性

  • 验证有根树文件：执行qiime tools peek rooted-tree.qza，确认树文件格式合规、无损坏，且为标准有根树结构。
  • 检查特征表：用以下命令生成特征表可视化报告，确认采样深度700是否合理（需保证多数样本测序深度≥700），同时排查空样本或异常值：

    qiime feature-table summarize --i-table table.qza --o-visualization table-summary.qzv
    

  • 校验样本元数据：确保sample-metadata.tsv格式正确，无缺失值，且样本ID与特征表中的ID完全匹配。

• 调整临时目录权限
  Ubuntu下QIIME2默认使用/tmp存储临时文件，检查目录权限：

  ls -ld /tmp
  

  若当前用户无读写权限，执行：

  sudo chmod 1777 /tmp
  

  或指定自定义临时目录（需保证该目录有足够空间）：

  export TMPDIR=/path/to/your/custom/tmp
  

• 修复依赖兼容性
  QIIME2-2022.8在Ubuntu 22.04上可能存在依赖版本冲突，尝试降级scikit-bio（ssu的核心依赖）：

  conda install -c bioconda scikit-bio=0.5.7
  

  或更新整个conda环境，确保所有依赖版本匹配：

  conda update --all
  

• 查看详细错误日志
  查看debug日志获取精准报错原因：

  cat /tmp/qiime2-q2cli-err-x3td01k5.log
  

  日志会记录ssu执行时的具体失败原因（如树文件格式错误、特征表不兼容等），可针对性解决问题。

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