---
Product: psd
Platform: java
Page Type: kb
Canonical URL: https://kb.aspose.org/psd/java/how-to-work-with-psd-core-exceptions-java
Last Updated: 2026-11-19
---

# How to Handle PSD Load and Save Errors in Java

Catch PsdLoadException and the other errors that loading or saving a PSD or PSB file can produce in Aspose.PSD FOSS for Java.

This guide shows which error you get for which problem and how to catch it.

## Step-by-Step Guide

### Step 1: Add the Library

```xml
<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-psd-foss</artifactId>
  <version>26.11.0</version>
</dependency>
```

---

### Step 2: Know the Exceptions

`PsdLoadException` and `PsdSaveException` are in `org.aspose.psd.coreexceptions`. Both extend `Exception`, so both are checked exceptions.

---

### Step 3: Catch Load Errors From a Stream

`PsdImage.load(InputStream)` declares `PsdLoadException`. It is thrown for an invalid signature or header, an empty stream, and data that ends before the end of the image resources or layer sections. Read the message: it names what is wrong, for example `Invalid PSD signature. Expected '8BPS'`.

---

### Step 4: Catch Load Errors From a Path

`PsdImage.load(String)` does not declare the exception. For the same problems it throws a `RuntimeException` whose cause is the `PsdLoadException`, so read `getCause()`. A path that does not exist is a `FileNotFoundException` and a `null` path is an `IllegalArgumentException`.

---

### Step 5: Catch Save Errors

`PsdImage.save` declares only `IOException`. A save problem, for example a layer name that is longer than 255 characters, surfaces as a `RuntimeException` whose cause is a `PsdSaveException`. A `catch (PsdSaveException e)` around `save` does not compile; catch `RuntimeException` and read `getCause()`.

## Things to Know

- `catch (IOException)` does not catch `PsdLoadException`.
- A file that is cut off or damaged inside the merged image data at the end of the file still loads without an exception.
- Setters that this edition does not support throw `UnsupportedOperationException`, not a PSD exception.

## See Also

- [Core Exceptions in the documentation](https://docs.aspose.org/psd/java/developer-guide/core-exceptions/)
- [PsdLoadException reference](https://reference.aspose.org/psd/java/psdloadexception/)
- [Aspose.PSD for Java — Enterprise Knowledge Base](https://kb.aspose.com/psd/java/)