Краткий ответ

Метод addSuppressed выбрасывает IllegalArgumentException и не добавляет исключение в список подавленных. Самоподавление запрещено, потому что подавленное исключение должно быть отдельным объектом, а ссылка объекта на самого себя не несёт диагностического смысла и могла бы создавать циклическую структуру причин.

Исторический контекст

Механизм подавленных исключений появился в Java 7 вместе с автоматическим управлением ресурсами. Он решает проблему, когда основная ошибка возникает в теле операции, а дополнительная — при закрытии ресурса: обе ошибки нужно сохранить, не заменяя первичную вторичной.

Для этого Throwable хранит отдельный список suppressed exceptions. Он отличается от cause: причина объясняет происхождение исключения, а подавленное исключение описывает сопутствующий сбой, возникший во время обработки основной ошибки.

Постановка проблемы

Если позволить исключению подавлять само себя, диагностическая структура станет рекурсивной: при печати стека объект пришлось бы рассматривать как собственное дополнительное исключение. Такая связь не описывает отдельное событие и может привести к некорректной интерпретации журнала ошибок.

На практике ошибка часто возникает не в самом addSuppressed, а в коде очистки ресурсов или в утилите агрегации исключений. Если этот вызов не ожидается и не обрабатывается, исходная ошибка может быть затенена новым IllegalArgumentException.

Подробное решение

При вызове addSuppressed Java сначала проверяет, не совпадает ли переданный объект с текущим объектом Throwable. При совпадении выбрасывается IllegalArgumentException с сообщением о недопустимости самоподавления; список подавленных исключений не изменяется.

Проверка выполняется независимо от того, разрешено ли подавление для данного экземпляра. Если подавление отключено специальным конструктором Throwable, обычные отдельные исключения не добавляются, но попытка передать сам объект всё равно считается ошибкой. Передача null также недопустима и приводит к NullPointerException.

Минимальный пример:

public class Demo {
    public static void main(String[] args) {
        Throwable error = new Exception("primary");
        try {
            error.addSuppressed(error);
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage());
        }
        System.out.println(error.getSuppressed().length);
    }
}

После вызова длина списка равна нулю. addSuppressed не заменяет cause, не меняет основной тип исключения и не превращает переданный объект в новую ошибку; он только добавляет отдельный объект в список сопутствующих исключений.

При ручном агрегировании ошибок нужно проверять идентичность объектов, а не только их типы или сообщения. Два разных исключения одного класса могут быть корректно добавлены друг другу как подавленные, если такая связь действительно отражает последовательность событий.

Ситуация из практики

Сервис выполняет операцию и затем закрывает несколько ресурсов. При обработке ошибки разработчик пишет универсальный сборщик, который добавляет каждую возникшую ошибку в основной объект. Из-за ошибки в логике одна и та же ссылка передаётся как основная и как подавленная.

Вариант без проверки прост, но приводит к IllegalArgumentException и может скрыть исходную проблему. Проверка только класса недостаточна: одинаковые типы исключений не запрещены, запрещено именно совпадение объектов.

Выбранное решение — перед добавлением проверять идентичность candidate == primary, а сам сборщик вызывать так, чтобы ошибка агрегации не подменяла исходную ошибку без явного решения. В результате первичное исключение сохраняется, реальные вторичные ошибки доступны через getSuppressed(), а ошибочная попытка самоподавления выявляется отдельно в тестах.

Что кандидаты часто упускают

Заменяет ли addSuppressed исходное исключение или его причину?

Нет. Метод только добавляет объект в отдельный список, доступный через getSuppressed(). Основной объект Throwable и его cause, возвращаемая getCause(), от этого не изменяются.
Можно ли добавить один и тот же отдельный объект подавленного исключения дважды?

Да, Java не запрещает повторное добавление одного и того же объекта, если он не совпадает с объектом-владельцем списка. Каждый успешный вызов добавляет запись, поэтому длина массива может увеличиться, хотя диагностически дублирование обычно является ошибкой проектирования.
Что произойдёт, если для исключения подавление отключено?

Попытка добавить обычное отличное от владельца исключение не приведёт к его сохранению: вызов фактически не добавит запись. Это свойство задаётся при создании Throwable и используется для классов исключений, которым не нужен механизм suppression; самоподавление при этом всё равно считается недопустимым и вызывает IllegalArgumentException.