28 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 написан, тесты зелёные.
- Сверка с данными 5 октября: механизм краша Network-процесса подкреплён лишь частично (20–45% «здоровых»
stuck); error 6 на iOS (~1/3 строк), привязка вкладок и большая часть «здоровых» сбоев фиксами не покрыты. Нужна телеметрия до или вместе с фиксами (раздел «Телеметрия для валидации»). - Весь пакет: 490 тестов, 0 падений (repro-тесты без env пропускаются). SwiftLint
--strictчистый. - 8 октября: разбор непокрытых групп ведётся в отдельном worktree
alex/cpm-web-extension-remaining-failures(без фиксов, как в проде) — см. раздел «Непокрытые группы: расследование». Error 6 воспроизведён на macOS, найден естественный iOS-путь (будильник CPM будит background, пока приложение в фоне); ждёт подтверждения на устройстве с iOS 26.
Что нашли
Отказ одной вкладки — потеря 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 |
Фиксы ↔ гипотезы
| Фикс | Гипотеза | Подтверждена данными? |
|---|---|---|
| Gate на первую загрузку посреди сессии | Потеря init при eager-загрузке background нового идентификатора (317981), не про Network-процесс |
Нет. Косвенно — app_version_change=updated, но запуск и так под gate; частота установок посреди сессии неизвестна |
| Watchdog по PID Network-процесса | Краш Network-процесса → мёртвый worker при «живом» background | Частично (см. ниже) |
| Перезапуск по первому сбою | Мёртвый worker по любой причине при отзывчивом процессе background'а | Не проверена: из app причину не видно |
Сверка с собранными данными (5 октября)
Источник: apple-browsers.git/cpm-public-attribution-2026-10-06/events.tsv (строки stuck .count) и events_daily.tsv (в скобках). Группы по приоритету, как в атрибуции.
| Группа по снимку | iOS: всего / network_restarted=true |
macOS: всего / network_restarted=true |
|---|---|---|
| Вкладка: controller/scripts/tab | 81 / 10% (13%) | 102 / 1% (2%) |
| Нет background view | 158 / 11% (14%) | 35 / 3% (3%) |
| Error 6 (background не загрузился) | 579 / 10% (14%) | 3 / – |
died_* (процесс background умер) |
14 / 86% (85%) | 0 |
| Снимок без видимой ошибки | 1 410 / 17% (21%) | 705 / 30% (45%) |
За гипотезу о Network-процессе: смена Network-процесса заметно чаще в группе «без видимой ошибки» — там, где её предсказывает механизм. В остальных группах ~10% на iOS и 1–3% на macOS. Смерть процесса background'а почти всегда вместе со сменой Network-процесса — похоже на jetsam на iOS, убивающий оба.
Почему это не доказательство: network_restarted сравнивает PID с загрузкой контекста, а не с последним созданием background view. В почти всех таких строках последние события — view, proxy_on за 30 с – 5 мин до снимка. Если view пересоздан после смены процесса, worker свежий и механизм не применим. Порядок из текущих данных не восстановить.
Итог: механизм объясняет в лучшем случае 20–45% «здоровых» stuck. Остальное — другие дефекты, которые текущими фиксами не покрыты:
- Error 6 — ~1/3 всех строк iOS. WebKit сам сообщает, что background не загрузился (
dealloc → error:6 → view…). Worker не поднимается, а не тихо умирает. Перезапуск по сбою почти не поможет: после error 6 view обычно нет. Отдельный приоритет для iOS. - Вкладка не привязана (macOS: неверный controller и нет scripts; iOS: нет scripts) — привязка вкладки к контексту, фиксы не трогают.
- Нет background view — WebKit не пересоздал background; обоим механизмам нужен живой view.
- «Здоровые» без смены Network-процесса — крупнейший необъяснённый остаток (1 170 iOS / 497 macOS). Кандидаты: другая смерть worker'а (поймает перезапуск по сбою), поздний или несопоставленный
refreshCpmDashboardStateпри живом worker'е (перезапуск — ложное срабатывание), первая загрузка вне gate. Безnative_seenне разделить.
Непокрытые группы: расследование (8 октября)
Worktree alex/cpm-web-extension-remaining-failures, ветка от того же коммита a0717cf098, без фиксов — чтобы воспроизводить на коде как в проде. Фиксы остаются незакоммиченными в alex/cpm-web-extension-ready-handshake.
- В harness перенесена инфраструктура (без watchdog/recovery) и подключён production
CPMMessagingDiagnosticsRecorder: воспроизведённые сбои дают те же параметры пикселей, что и прод (bg_events,context_errors,network_restarted, …). Watcher логируетcontext.errors. - Новый набор
CPMReproBackgroundLoadFailureTests: idle-выгрузка (~32 с), затем пробуждение навигацией при заданном условии.
Error 6 (BackgroundContentFailedToLoad, ~1/3 строк stuck на iOS)
WebKit (WebExtensionContextCocoa.mm): error 6 ставится, когда _loadServiceWorker вернул success=false (:2796) или упала навигация background-страницы (:3052). Код 7 — внутренний ScriptExecutionError (didEncounterScriptError, :284): JS-ошибка в скрипте extension во время работы. В проде: 7,6 — 283, только 6 — 259, 6,7 — 103 из 645 строк iOS с error 6.
| Условие при пробуждении (macOS) | Результат |
|---|---|
| Без помех | доставлено |
| Network-процесс заморожен 5/10/60 с | пробуждение потеряно, error 6 нет, потом всё работает |
| Network-процесс убит перед пробуждением | доставлено |
| Background убит во время загрузки | пробуждение потеряно (died_client), error 6 нет |
| Файлы extension отсутствуют | error 6 + WKWebExtensionErrorDomain:2 — в проде кода 2 нет, не причина |
Background-скрипт бросает на верхнем уровне / нет browser/chrome |
error 6 без кода 7 — точная продовая сигнатура «только 6», но продовой причины падения скрипта не нашлось |
| Новый процесс background заморожен ≥30 с во время загрузки | таймаут загрузки SW → background none + error 6, цепочка view, proxy_on, unresponsive, error:6, dealloc; 10 с — error 6 нет; после разморозки работает |
Естественный путь на iOS (гипотеза): в настоящем приложении в iOS Simulator видно, что CPM сам будит background будильником cpm-summary (через 2 мин после активности, шлёт autoconsent_summary) — в том числе когда приложение в фоне. На устройстве RunningBoard не даёт фоновому приложению держать новый WebContent-процесс активным → процесс приостанавливается посреди загрузки SW → таймаут ~30 с → error 6. Объясняет, почему error 6 почти только на iOS (579 против 3).
Ограничения проверки:
- Тесты пакета в iOS Simulator непоказательны: процесс
xctestне получает RunningBoard assertions (Failed to acquire RBS assertion), background не работает с самого начала. - В приложении в симуляторе фоновое приложение не приостанавливается (background живёт 40–50 с и грузится), поэтому сам error 6 там не появляется.
- Нужно устройство с iOS 18.4+ (лучше 26.x). Подключённый iPhone 12 mini — на iOS 18.1: CPM-extension там не включается (
@available(iOS 18.4)). Сборка DDG iOS (Debug), локальный HTTP-сервер со страницами и сценарии черезsimctl/devicectlготовы.
Сценарий для устройства: открыть страницу → свернуть приложение → ждать 2–3 мин (будильник cpm-summary) → вернуться → навигация; снимать логи WebExtensions ([CPM Diagnostics], Context error).
Возможный фикс, если подтвердится: при возврате приложения на передний план, если context.errors содержит error 6 или background мёртв, — перезапустить background; либо не давать будильнику будить background, пока приложение в фоне (изменение extension или WebKit).
Привязка вкладок на macOS (tab_controller_match=false + нет scripts, ~100 строк)
- Гипотеза атрибуции не подтвердилась. Путь в коде есть: выключение флага
webExtensionsвызываетuninstallAllExtensions()и обнуляет менеджер, включение создаёт новый с новым controller, аWKWebViewConfigurationстарых вкладок не меняется. Но флаг.webExtensions=remoteReleasable(WebExtensionsSubfeature.featureEnabled)сdefaultValue: .enabled, а подфичиfeatureEnabledнет ни во встроенном, ни в текущем удалённомmacos-config.json→ флаг всегдаenabled(отсутствующая подфича возвращаетdefaultValue). Мигать нечему. - Порядок запуска не объясняет:
setupWebExtensions()(AppDelegate.swift:1509) вызывается до восстановления сессии (:1526), раньше вкладки не создаются. tab_controller_matchсчитается какtabController != nil && tabController === context.webExtensionController(CPMMessagingDiagnosticsRecorder.swift:378) —falseи при отсутствующем controller у вкладки, и при устаревшей ссылке на контекст.- Следующие кандидаты: вкладки из
createWebViewWith(popup /target=_blank) и кэш закреплённых вкладок; пересборка user scripts вUserContentControllerприложения при обновлении правил content blocking — может стирать скрипты extension из вкладки (на iOS есть группа «скриптов нет при верном controller»).
Ещё не начато
- Нет background view (158 iOS / 35 macOS).
- «Здоровые» сбои без смены Network-процесса (1 170 iOS / 497 macOS) — разделять после
native_seen.
Телеметрия для валидации
Выпустить раньше фиксов или вместе с ними в A/B — иначе эффект фиксов не отделить. Все значения — bool/enum/bucket, без URL и идентификаторов; оформить через ddg-add-pixel, privacy triage (прецедент — cpm-m3-telemetry-privacy-triage).
Подтвердить сбои — параметры к существующим initialization_failed / stuck:
network_replaced_since_view(bool) — PID Network-процесса при последнем создании background view ≠ текущему. Прямая подпись мёртвого worker'а. Recorder уже вычисляет это (CPMMessagingDiagnosticsRecorder.swift:285-289), но только логирует. Плюс токенnet_replacedвbg_events, чтобы видеть порядок. Самое дешёвое и самое ценное.native_seen(none/site_check/refresh_other_url) — были ли нативные вызовы от background для этой навигации (background зовётisFeatureEnabledс URL вкладки при обработкеinit). Делит сбой на «не дошло до worker'а» / «worker обработал, refresh опоздал» / «рассогласование URL на native». Только app.bg_first_load(bool) + токеныinstall/upgrade/bg_loadedвbg_events— подпись бага первой загрузки.gate(none/launch/startup/timeout) — прошла ли навигация мимо gate или он открылся по таймауту 5 с.
Подтвердить, что фиксы работают:
- Пиксель
debug_web_extension_cpm_background_restarted(daily+count):trigger=network_process_replaced/initialization_failed;outcome=restarted/skipped_unresponsive/spi_unavailable. - Атрибуция восстановления:
recovery_action(none/background_restart) кrecovered_without_extension_reload, либо параrecovered_after_background_restart/background_restart_failed(следующая навигация после перезапуска тоже упала → M4). - Ожидаемый эффект: падают
messaging_stuckи M4 (recovered_after_extension_reload); почти исчезают вторые сбои эпизода сnative_seen=none+network_replaced_since_view=true; исчезают сбои сbg_first_load=trueвне запуска. - A/B, а не просто флаг: recovery и новый gate — за экспериментальным флагом (
ddg-add-feature-flag), когорта в CPM-пикселях. Сравнение версий (1.208 → 1.209) уже оказалось неинформативным.
Не измерить без extension: восстановление уже открытых документов (монитор меряет только навигации) и причину смерти worker'а при живом Network-процессе.
Тесты
Папка 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и неотличимо. Реализовать план из раздела «Телеметрия для валидации»; минимум —network_replaced_since_view,native_seenи пиксельbackground_restarted. - Порядок выкатки. Телеметрия раньше фиксов или вместе с ними в A/B-эксперименте с когортой в CPM-пикселях.
- Error 6 на iOS (~1/3 строк
stuck) не покрыт фиксами. Механизм воспроизведён на macOS (заморозка нового background ≥30 с во время загрузки). Обновить iPhone до iOS 26.x и подтвердить сценарий с будильникомcpm-summaryв фоне; затем решить про фикс. - Привязка вкладок на macOS: гипотеза мигания флага отброшена; проверить popup-вкладки, кэш закреплённых вкладок и пересборку user scripts.
- Телеметрия для error 6: причина в
context_errors(описание ошибки, хотя бы категория) и состояние приложения в момент ошибки (foreground/background). - Остаток «здоровых» сбоев без смены Network-процесса (1 170 iOS / 497 macOS) не объяснён; разделить после
native_seen. - 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 приложения и фиксы. Актуальное — эта заметка.