FASTQC在Linux命令行正常运行，Python subprocess调用报Java字体错误

我之前碰到过完全一样的问题！这个错误的核心原因是Java在非图形化/无桌面环境下无法找到可用的字体——FastQC生成报告时需要渲染字体来生成质量图表，而subprocess调用默认的环境变量可能没有配置字体路径，或者系统缺少必要的字体文件，最终导致Java抛出这个致命错误。

先还原你遇到的错误堆栈：

Exception in thread "Thread-1" java.lang.Error: Probable fatal error:No fonts found.
at sun.font.SunFontManager.getDefaultPhysicalFont(SunFontManager.java:1236)
at sun.font.SunFontManager.initialiseDeferredFont(SunFontManager.java:1100)
at sun.font.SunFontManager.findOtherDeferredFont(SunFontManager.java:1037)
at sun.font.SunFontManager.findDeferredFont(SunFontManager.java:1054)
at sun.font.SunFontManager.findFont2D(SunFontManager.java:2256)
...

下面是两种最有效的解决方法：

方法1：安装系统字体包（优先推荐） #

Linux系统默认可能缺少Java依赖的基础字体，安装一个通用的TrueType字体包就能快速解决问题：

• 对于Debian/Ubuntu系列：

  sudo apt update && sudo apt install fonts-dejavu-core
  

• 对于RHEL/CentOS/Rocky系列：

  sudo dnf install dejavu-sans-fonts
  

安装完成后重新运行Python脚本，subprocess调用FastQC时Java就能自动找到可用字体了。

方法2：在subprocess调用中指定Java环境变量 #

如果安装字体后仍有问题，或者你需要在纯后台环境（比如服务器crontab）运行，可以通过设置JAVA_OPTS环境变量，强制Java使用headless模式并指定字体路径：

import subprocess
import os

# 复制当前环境变量，避免覆盖原有系统配置
custom_env = os.environ.copy()
# 设置Java参数：启用headless模式，指定字体路径（根据你的系统实际路径调整）
custom_env['JAVA_OPTS'] = '-Djava.awt.headless=true -Dsun.font.fontpath=/usr/share/fonts/truetype/dejavu/'

# 调用FastQC，传入自定义环境变量
subprocess.run(
    ['fastqc', 'your_input_file.fastq', '-o', 'output_directory'],
    env=custom_env,
    check=True
)

为什么命令行直接运行正常？ #

因为你在命令行操作时，终端可能关联了图形环境（比如本地桌面终端、带X11转发的SSH连接），Java能自动识别并加载系统字体；而subprocess在后台运行时，默认环境没有加载图形相关配置，导致字体查找失败。

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