Выберите одну безвредную операцию и проследите её через renderer, preload и main с диагностическим ID. «Сообщение отправлено» ещё не означает, что обработчик зарегистрирован, операция выполнена и ответ попал в актуальное окно. Сначала сравните имя канала и пару методов на обеих сторонах, затем проверьте готовность bridge API в собранной версии.

Electron документирует разные IPC-схемы: invoke работает с обработчиком handle и возвращает Promise; send используется с событийной схемой. Проверено 22 октября 2026 года. Несовпадающая пара не превращается в запрос-ответ только из-за одинакового имени канала. Разделите команду, результат и уведомление в собственном контракте приложения.

Где остановилась конкретная операция

Последняя отметкаЧто исследовать дальше
Клик есть, вызова bridge нетПодключение UI и имя узкого метода
Bridge вызван, main молчитКанал, пара методов, регистрация обработчика
Main начал, результата нетОшибка операции и путь возврата
Ответ отправлен, UI не изменилсяАктуальность окна, подписка и обработка результата
В dev работает, в пакете нетПуть preload и состав сборки

Отдайте renderer только нужную возможность

Условный контракт:
renderer -> requestId + допустимые данные
preload -> узкая функция конкретной операции
main -> проверка отправителя и параметров
операция -> результат или безопасная причина отказа
renderer -> применить только актуальный ответ
закрытое окно -> не перенаправлять ответ случайному новому

В руководстве Electron preload раскрывает отдельную функцию через contextBridge, а не весь ipcRenderer. Это сохраняет границу полномочий. Не включайте Node-интеграцию и не отключайте contextIsolation ради исчезновения ошибки импорта в интерфейсе. Если bridge отсутствует, исправьте загрузку preload и контракт, а не выдавайте странице доступ ко всем системным операциям.

Обработчик main регистрируется управляемо, а не при каждом открытии окна без учёта уже существующих подписок. Для main-to-renderer уведомления выбирайте нужный webContents и момент готовности. Глобальный broadcast может показать чужие данные другому окну. После навигации прежний слушатель и текущий экран могут относиться к разным состояниям.

Проверяйте сериализуемость данных и формат ошибки. Не передавайте через границу случайные объекты с привилегиями или внутренний stack trace. Для интерфейса достаточно стабильного кода и безопасного объяснения; подробности остаются в ограниченном журнале. Диагностический ID должен связывать этапы, не раскрывая содержание пользовательского документа.

Перезагрузка окна проверяет контракт лучше повтора клика

  • Первый вызов после запуска установленной сборки.
  • Повтор операции без размножения слушателей.
  • Перезагрузка renderer во время ожидания ответа.
  • Ошибка main с завершённым состоянием UI.
  • Недопустимый параметр с отказом до выполнения действия.

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

Сохраните минимальный тест IPC без реальных файлов, платежей и секретов, затем проверьте прикладную операцию. Для разбора подготовьте журнал этапов и схему вызова, а не полный дамп памяти. Успех — проверенный результат в нужном окне при сохранённой изоляции, а не просто исчезнувшее сообщение об ошибке.

Проверенные источники