11 KiB
11 KiB
title, date, status, tags
| title | date | status | tags | |||
|---|---|---|---|---|---|---|
| CPM Web Extension — воспроизведение и фикс | 2026-10-08 | fix-uncommitted |
|
CPM Web Extension — воспроизведение и фикс
Продолжение cpm-web-extension-breakage-session-summary-2026-10-07 (§8 «План точного воспроизведения»).
Среда: macOS 26.7.1 (25G241), system WebKit, production embedded extension 2026.9.29.
Код: worktree alex/cpm-web-extension-ready-handshake, пакет SharedPackages/WebExtensions. Ничего не закоммичено.
Статус
- Harness на реальном WebKit готов: реальные
WebExtensionManager,WebExtensionLifecycleCoordinator+ navigation gate,CPMMessagingHealthMonitor(4 с), M4, production extension без изменений логики. - Оба класса отказа воспроизведены, причины найдены, фикс на стороне app написан, тесты зелёные.
- Весь пакет: 490 тестов, 0 падений (repro-тесты без env пропускаются). SwiftLint
--strictчистый.
Что нашли
Отказ одной вкладки — потеря init при первой загрузке background
- WebKit при первой загрузке extension с новым идентификатором (первая установка или обновление — апгрейд ставит новый UUID) грузит background сразу.
runtime.sendMessage, пришедший до выполнения background-скрипта, резолвитсяundefined, listener не вызывается. - Без gate: 14/20 при первой установке, 18/20 при обновлении; с busy-wait 1 с в скрипте — 3/3 детерминированно.
- При обычном перезапуске (extension уже установлен), после reload (M4) и при пробуждении после idle WebKit ставит сообщения в очередь — потерь нет.
- Поправка к первому отчёту: при запуске это уже закрывает gate в
WebExtensionLifecycleCoordinator(флагwebExtensionStateRestorationGate). Дыры были: установка или обновление посреди сессии (sync(), отложенная установка на iOS до protected data), таймаут gate 5 с.
Полный отказ — мёртвый worker при живом background
- Краш Network-процесса (
SIGKILL, аналог jetsam на iOS): background view и его PID прежние, WebKit считает background загруженным, worker мёртв. Теряются сообщения из всех вкладок и уже открытых документов. Монитор: init failed → stuck → M4. После M4 новые навигации работают, документы, открытые до сбоя, сломаны навсегда. Без M4 держится, пока пользователь активен; снимается после ~30 с idle-выгрузки. 20/20. - Смерть worker'а при живом Network-процессе:
_terminateServiceWorkers(SPI) или удаление service worker registrations из data store (то, что делает очистка данных). Состояние то же. - Fire в обоих приложениях выгружает extensions на время очистки и загружает потом, поэтому сам Fire сюда не приводит. Других путей в проде, которые убивают только worker, не нашёл.
- Не триггеры:
org.WebKit.lowMemory, заморозка background на 10–75 с, kill background-процесса (WebKit перезапускает сам). - Если background занят или заморожен дольше ~30 с, WebKit выгружает его, и сообщение «в полёте» теряется навсегда (одна вкладка, не каскад).
Восстановление
- Убить только background WebContent-процесс (
_killWebContentProcessAndResetState) — WebKit поднимет новый worker на следующем сообщении; новые навигации и уже открытые документы работают. - Reload extension (M4) чинит только новые навигации.
loadBackgroundContent()ничего не даёт: WebKit считает background загруженным.
Почему мёртвый worker не обнаружить из приложения
- Регистрация SW остаётся
activated. runtime.sendMessageиз page world background web view до worker'а не доходит (WebKit считает страницу самим background-контекстом) — и у живого, и у мёртвого worker'а сразуundefined.- Background CPM слушает только
onMessage,onConnect(порт privacy-dashboard) иonAlarm— приложение не может их вызвать.
Фикс (app, пакет WebExtensions)
- Gate для первой загрузки посреди сессии. После
installEmbeddedExtensionменеджер запоминает задачуloadBackgroundContent()нового контекста;coordinator.initialLoadWaiter(его уже вызывают обе платформы на каждой main-frame навигации) после открытия стартового gate отдаёт этот waiter, не дольше 5 с. EmbeddedBackgroundLivenessWatchdog. Запоминает PID Network-процесса background'а; при смене перезапускает background-процесс. Проверка на каждой навигации и раз в 1 с.- Перезапуск по первому сбою. Монитор вызывает
onEpisodeStartedна первом сбое обычной навигации; менеджер перезапускает background, если процесс отвечает (callAsyncJavaScript("return 1"), 1 с). Замороженный или занятый не трогаем: убийство остановленного процесса давало глухой новый worker. - Пункты 2 и 3 включаются одним переключателем
isEmbeddedBackgroundRecoveryEnabled(по умолчаниюtrue).
| Сценарий | Без фикса | С фиксом |
|---|---|---|
| Установка посреди сессии | 3/3 потерь | 5/5 доставлено |
| Обновление посреди сессии | 5/5 потерь | 5/5 доставлено |
| Краш Network-процесса, 4 вкладки + открытые документы | все сломаны | всё работает |
| Краш Network-процесса без M4 | не восстанавливается | работает |
| Смерть worker'а (SPI / удаление регистраций) | 2 таймаута → M4, старые документы сломаны | 1 потерянная навигация, затем всё работает без reload |
Тесты
Папка Tests/WebExtensionsTests/CPMRepro/, запуск из SharedPackages/WebExtensions:
CPM_REPRO=1 swift test --filter CPMRepro— путь приложения:CPMReproSingleTabTests(10),CPMReproFullFailureTests(8). Должны быть зелёными.CPM_REPRO=1 CPM_REPRO_WEBKIT=1— ещёCPMReproWebKitTests(7): защиты выключены, тесты утверждают, что баги WebKit всё ещё есть. Покраснеют, когда Apple исправит — сигнал убрать обходы.- Ручки:
CPM_REPRO_ITERATIONS,CPM_REPRO_FREEZE,CPM_REPRO_INSTALL_DIR(настоящий перезапуск процесса: запустить дважды). - Unit-тесты без env:
EmbeddedBackgroundLivenessWatchdogTests(11), 4 новых вWebExtensionLifecycleCoordinatorTests, 3 новых вCPMMessagingHealthMonitorTests.
Открытые вопросы — решить до коммита
- Feature flag. Watchdog и перезапуск по первому сбою сейчас включены по умолчанию (
isEmbeddedBackgroundRecoveryEnabled = { true }), в приложениях не подключены к удалённому флагу. Завести флаг (ddg-add-feature-flag), желательно раздельно для watchdog и для перезапуска по сбою. - Риск перезапуска по первому сбою. Первых сбоев много (~6.6k установок/день на iOS); часть — не мёртвый worker (нет инъекции, медленный native). Перезапуск дешевле M4, но рвёт незавершённую работу background для других вкладок. Решить: включать сразу или через эксперимент.
- Телеметрия. Восстановление после перезапуска сейчас попадает в
recovered_without_extension_reloadи неотличимо. Нужен пиксель или параметр «background restarted» с причиной (network process replaced / first failure) —ddg-add-pixel. - SPI. Перезапуск через
_killWebContentProcessAndResetState, детекция через_networkProcessIdentifier; естьresponds(to:). Согласовать с командой (приложение уже использует SPI WebKit в этом месте). - Сборка приложений. iOS и macOS не собирал; изменения обратно совместимы (дефолтная реализация нового метода протокола, дефолтный параметр init). Проверить сборку и прогнать на iOS Simulator.
- Zero-loss для смерти worker'а. Нужен ping-канал в extension (native port с heartbeat или обработчик ping) — задача в репозитории extension.
- Не воспроизведено: продовое «первый probe после M4 падает» (670 iOS / 232 macOS). В тестах после M4 навигации проходят.
- WebKit-баги для репорта: (1) потеря сообщения при eager-загрузке background первой загрузки; (2) после краша Network-процесса или удаления регистраций
WebExtensionContextне замечает мёртвый worker. - Прогнать на macOS 27 VM — фикс 317981 может уже стоять; тогда
testWebKitDropsInitDuringFirstBackgroundLoadпокраснеет. - Отчёт
cpm-web-extension-repro-results-2026-10-07.mdвapple-browsers.gitустарел: он не учитывает gate приложения и фиксы. Актуальное — эта заметка.