# Общие исключения и ошибки, связанные со шрифтами в Linux

> Исключения и ошибки шрифтов в Linux

Source: https://docs.aspose.com/slides/ru/java/technical-articles/common-errors-involving-fonts/
Updated: 2025-12-10


## **Отсутствие текста или изображений (EMF или WMF) при выполнении кода в Linux**

Эта проблема возникает в системах с ограничениями в следующих случаях:

1. Когда не установлены шрифты или папка шрифтов для процесса Java недоступна
2. Когда директория TEMP недоступна.

### **Решение**

Проверьте и убедитесь, что доступ к директории TEMP и папке шрифтов предоставлен. 

{{% alert color="warning" %}}
В некоторых случаях вы можете не иметь возможности предоставить доступ к папкам из‑за ограничений, наложенных средой или политикой безопасности. Попробуйте следующие обходные пути: 
{{% /alert %}}

**Обходной путь**

Используйте [FontsLoader](https://reference.aspose.com/slides/java/com.aspose.slides/FontsLoader) для загрузки необходимых шрифтов без их установки:
```
FontsLoader.loadExternalFonts(pathToFontsFolders);
```


Если директория TEMP недоступна, используйте этот код, чтобы указать другую директорию в качестве TEMP для Java:
```
String newTempFolder = "pathToTmpFolder";
String oldValue = System.getProperty("java.io.tmpdir");
java.io.File file = new java.io.File(newTempFolder);
if (!file.exists())
    file.mkdir();
System.setProperty("java.io.tmpdir", newTempFolder);
try {

    FontsLoader.loadExternalFonts(pathToFontsFolders);

    Presentation pres = ...
    // ....

} finally {
    System.setProperty("java.io.tmpdir", oldValue);
}
```


## **Исключение: InvalidOperationException: Не удалось найти установленные шрифты в системе**

Это исключение возникает, когда

1) процесс Java не может получить доступ к папке шрифтов  
2) шрифты не установлены.

### **Решение**

1. Проверьте и убедитесь, что доступ к папке шрифтов для процесса Java предоставлен.  
2. Установите некоторые шрифты или используйте [FontsLoader](https://reference.aspose.com/slides/java/com.aspose.slides/FontsLoader).  
3. Установите шрифты.

   * Ubuntu: 
     ```
     sudo apt-get update
     sudo apt-get install -y fonts-dejavu-core
     fc-cache -fv
     ```


   * CentOS: 
     ```
     sudo yum makecache
     sudo yum -y install dejavu-sans-fonts
     fc-cache -fv
     ```


   * Using [FontsLoader](https://reference.aspose.com/slides/java/com.aspose.slides/FontsLoader): 
     ```
     FontsLoader.loadExternalFonts(pathToFontsFolders);
     ```


## **Исключение: NoClassDefFoundError: Не удалось инициализировать класс com.aspose.slides.internal.ey.this**

Это исключение возникает в Linux‑системе, где отсутствуют fontconfig и шрифты. 

### **Решение**

Установите fontconfig:

* Ubuntu:
  ```
  sudo apt-get update
  sudo apt-get -y install fontconfig
  ```


* CentOS:
  ```
  sudo yum makecache
  sudo yum -y install fontconfig
  ```


Кроме того, некоторые версии open‑jdk (например, **alpine JDK**) также **требуют установленные шрифты**.

* Ubuntu:
  ```
  sudo apt-get install -y fonts-dejavu-core
  fc-cache -fv
  ```


* CentOS:
  ```
  sudo yum -y install dejavu-sans-fonts
  fc-cache -fv
  ```


## **Исключение: UnsatisfiedLinkError: libfreetype.so.6: Не удалось открыть общий объектный файл: Файл или каталог не найден**

Это исключение возникает в Linux‑системе, где отсутствует библиотека libfreetype. 

### **Решение**

Установите libfreetype и fontconfig:

* Ubuntu: 
  ```
  sudo apt-get update
  sudo apt-get install libfreetype6
  sudo apt-get -y install fontconfig
  ```


* CentOS: 
  ```
  sudo yum makecache
  sudo yum install libfreetype6
  sudo yum -y install fontconfig
  ```


{{% alert title="TIP" color="primary" %}} 
Не забудьте установить шрифты или использовать FontsLoader.
{{% /alert %}}