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

initCause можно успешно вызвать только один раз для исключения, созданного без заранее заданной причины. После этого причину нельзя заменить, даже если при первой установке передали null; повторный вызов приводит к IllegalStateException. Нельзя также указать само исключение в качестве собственной причины — это вызывает IllegalArgumentException.

Если причина передана через конструктор исключения, она уже считается установленной, поэтому последующий вызов initCause запрещён.

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

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

Раздельная установка причины через initCause поддерживает классы исключений, у которых нет конструктора с параметром Throwable. При этом одноразовость установки защищает диагностическую информацию от последующей незаметной подмены.

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

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

Особенно коварен случай с null: метод getCause() вернёт null и до установки причины, и после явной установки null, но внутреннее состояние объекта в этих ситуациях различается. После явной установки изменить причину уже нельзя.

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

У Throwable есть внутреннее состояние, показывающее, была ли причина инициализирована. Для исключения, созданного обычным конструктором без причины, это состояние позволяет один раз вызвать initCause.

При передаче причины через конструктор она фиксируется сразу. Поэтому такой объект нельзя дополнительно настроить вызовом initCause, даже если переданная конструктору причина равна null.

Метод проверяет два недопустимых случая:

повторную инициализацию причины — выбрасывается IllegalStateException;
передачу самого объекта исключения — выбрасывается IllegalArgumentException.

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

import java.io.IOException;

class Demo {
    public static void main(String[] args) {
        RuntimeException error = new RuntimeException("сбой");
        error.initCause(new IOException("источник"));

        try {
            error.initCause(null);
        } catch (IllegalStateException ex) {
            System.out.println("Причина уже установлена");
        }
    }
}

В примере первый вызов устанавливает причину, а второй не заменяет её и завершается IllegalStateException. На практике предпочтительнее использовать конструктор исключения с параметром Throwable, если он доступен: такой способ сразу делает обязательную причину частью создания объекта и уменьшает риск оставить исключение ненастроенным.

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

Сервис преобразует SQLException в ОтчётНеДоступенException. Рассматривались два варианта: выбросить новое исключение без причины или создать его без причины и позже вызвать initCause.

Первый вариант проще, но теряет исходный стек и код ошибки базы данных. Второй сохраняет диагностику, однако у него есть риск повторного вызова initCause в разных ветках обработки.

Выбран вариант с конструктором ОтчётНеДоступенException(String, Throwable), который сразу передаёт исходную ошибку как причину. Это делает контракт класса явным, исключает повторную инициализацию и позволяет журналированию показать всю цепочку причин.

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

Можно ли вызвать initCause(null) один раз?

Да, если исключение было создано конструктором без заранее установленной причины. После этого причина считается инициализированной, хотя getCause() возвращает null. Повторный вызов всё равно завершится IllegalStateException, поэтому null нельзя рассматривать как признак возможности повторной настройки.
Что произойдёт при передаче исключения самому себе как причины?

initCause выбросит IllegalArgumentException. Самопричина создала бы цикл длиной один, из-за которого обход цепочки причин и форматирование стека могли бы стать некорректными или бесконечными.
Заменяет ли установка причины список подавленных исключений?

Нет. Причина описывает исходное исключение, которое привело к текущему, а подавленные исключения хранят дополнительные ошибки, возникшие, например, при закрытии ресурса в try-with-resources. Эти механизмы независимы: установка причины не удаляет подавленные исключения и не добавляет объект в список подавленных автоматически.