Сутки по 25 часов: как перевод часов повесил вкладку на 27 секунд

Раздел аналитики VOG открывался мгновенно в Москве и зависал на 27 секунд там, где переводят часы. Причина — одна строка: к полуночи прибавляли 24 часа. Как это нашлось, почему сервер был ни при чём, в скольких часовых поясах сидит такая ловушка и как проверить это тестом

Один и тот же код, одна и та же страница, те же данные. В Москве всё открывается сразу, а в Нью-Йорке вкладка замирает почти на полминуты, и главный график потом так и остаётся пустым. Сервер об этом не знает: он даже не получает запросов. Всё дело в одной строке, которая считает, что в сутках 24 часа.

Это восьмая статья серии «VOG изнутри». Предыдущая — про архив партий в Parquet. Та была о миллионах партий, а эта об одном прибавлении.

Схема в стиле журнала «Полдень»: вокзальные часы с лишним делением «25 ч» на циферблате; маленький механический ходок идёт по кольцу, а рычаг с табличкой «00:00» возвращает его на то же место, и из башни ползёт лента с одинаковыми карточками «00:00», заваливая площадь; во врезке листок календаря «1 ноября» и обычный циферблат «24 ч», где ходок идёт дальше

В статье

Симптом

В админке VOG есть раздел «Динамика»: график со скользящим окном и ещё семь панелей: когорты удержания, длительность партий и сессий, заполнение комнат, устройства, честность костей, воронка регистраций и распределение рейтинга. 5 ноября 2026 года выяснилось, что раздел открывается очень долго. На экране при этом висели только серые надписи «Loading…», а главный график после ожидания оставался пустым.

Первая версия была неверной

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

Но скриншот ему противоречил. Панель, которая ждёт данные, уже показывает заголовок и фильтры, а тут были голые заглушки без заголовков: панели ещё даже не отрисовались. Значит, ожидание начиналось раньше запросов. Загрузка кода эту задержку тоже не объясняла: файлы приходили за доли секунды.

Предположения закончились, пора было мерить.

Что показал замер

В браузере есть Long Animation Frames API: он записывает кадры, которые заняли основной поток надолго. Благодаря buffered: true записи можно прочитать уже после того, как всё случилось, — прямо из консоли открытой страницы:

new PerformanceObserver((list) => {
  for (const e of list.getEntries()) {
    console.log(Math.round(e.startTime), Math.round(e.duration), e.scripts.map((s) => s.sourceURL))
  }
}).observe({ type: 'long-animation-frame', buffered: true })

Вместе с performance.getEntriesByType('resource') получилась такая картина загрузки:

Момент Что происходит
0,7 с страница загружена
2,1 с код всех панелей скачан
2,1–15,6 с основной поток занят, 13,5 с
15,6–29,1 с занят ещё раз, снова 13,5 с
29,1 с только теперь уходят запросы за данными
29,4–29,8 с ответы получены, загрузка каждого заняла 140–400 мс (данные браузера, вместе с сетью)

Ответы вместе с сетью приходили за доли секунды. Запросы просто никто не отправлял, потому что всё это время страница считала что-то сама. Поэтому в журналах служб и в графиках нагрузки искать было нечего.

В консоли при этом была очень говорящая ошибка:

Uncaught RangeError: Invalid array length
    at Array.push (<anonymous>)
    at q (chartMath-DU5e0hAE.js:1:6240)
    at DynamicsChart-D4t6MIpO.js:1:2710
    at Object.useMemo (islands.js:41:60584)

Стек показывает только место: push внутри расчёта графика. Причину покажет пример ниже, а по отдельности этот стек ничего не доказывает.

Зато время сходится. Такой же цикл, запущенный отдельно в том же Chrome 152, упал с той же ошибкой через 13,3 секунды на 134 217 728 элементах. Это близко к длине каждого из двух кадров. Но что именно заняло каждый из них, по этому замеру сказать нельзя: в записях длинных кадров виден только планировщик React, стеков там нет, а полную трассу мы не сохранили. Напрашивается повторная отрисовка после ошибки, но это гипотеза: насколько видно по исходникам React 19, повтор идёт в том же вызове и двух отдельных кадров сам не объясняет.

Одна строка

По позиции в собранном файле нашлась timeTicks — функция, которая считает подписи на оси времени. При шаге в сутки она шла от полуночи к полуночи:

let cur = new Date(d.getFullYear(), d.getMonth(), d.getDate() + 1).getTime()
while (cur <= to) {
  out.push(cur)
  cur = new Date(cur + days * DAY).setHours(0, 0, 0, 0)
}

Приём кажется надёжным: прибавить сутки в миллисекундах, а потом на всякий случай выровнять на полночь. Выравнивание как раз и защищает от перевода часов: весной, в сутках из 23 часов, прибавление даёт 01:00 следующего дня, и сброс возвращает к его полуночи.

Осенью сутки длятся 25 часов. В США часы перевели 1 ноября. Прибавляем к полуночи 24 часа и попадаем в 23:00 того же дня, а setHours(0, 0, 0, 0) возвращает к той же полуночи, с которой начали. Значение cur больше не растёт. Проверить это можно за минуту:

// stuck.mjs
const DAY = 86_400_000
const midnight = new Date(2026, 10, 1).getTime()
const next = new Date(midnight + DAY).setHours(0, 0, 0, 0)
console.log(new Date(midnight + DAY).toString().slice(0, 33))
console.log(next === midnight ? 'застряли на той же полуночи' : 'перешли на следующий день')
$ TZ=America/New_York node stuck.mjs
Sun Nov 01 2026 23:00:00 GMT-0500
застряли на той же полуночи

$ TZ=Europe/Moscow node stuck.mjs
Mon Nov 02 2026 00:00:00 GMT+0300
перешли на следующий день

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

Кого это касается

Ловушка срабатывает при трёх условиях:

  1. В поясе браузера в этот день отводят часы назад. Весенний перевод безопасен.
  2. Цикл доходит до полуночи этого дня. Окно должно начинаться раньше неё и заканчиваться не раньше неё: цикл идёт, пока cur <= to. Если окно начинается уже 1 ноября, первая отметка строится на 2 ноября, и ошибки нет. При окне в семь дней опасная неделя начинается с этой полуночи.
  3. Шаг делений округляется до одних суток. Для недельного окна это целевое число подписей от 5 до 7. Сколько их получится на самом деле, зависит от границ окна.

В Москве часы не переводят с 2014 года, поэтому на окнах последних лет ошибки там нет. Но график хранит историю, и окно вокруг 26 октября 2014 года застряло бы и в Москве. А вот все пояса из базы Node за 2026 год:

// scan.mjs
const DAY = 86_400_000
const zones = Intl.supportedValuesOf('timeZone')
const hit = {}
for (const tz of zones) {
  process.env.TZ = tz
  for (let d = 0; d < 365; d++) {
    const m = new Date(2026, 0, 1 + d).getTime()
    if (new Date(m + DAY).setHours(0, 0, 0, 0) === m) {
      ;(hit[new Date(m + 12 * 3_600_000).toLocaleDateString('sv')] ??= []).push(tz)
    }
  }
}
console.log('всего поясов', zones.length, 'с ловушкой', new Set(Object.values(hit).flat()).size)
for (const k of Object.keys(hit).sort()) console.log(k, hit[k].length, hit[k].slice(0, 3).join(' '))
$ node -p "'node ' + process.versions.node + ', ICU ' + process.versions.icu + ', tzdata ' + process.versions.tz"
node 26.13.0, ICU 79.1, tzdata 2026e

$ node scan.mjs
всего поясов 418 с ловушкой 126
2026-02-15 2 Africa/Casablanca Africa/El_Aaiun
2026-04-04 2 America/Santiago Pacific/Easter
2026-04-05 11 Antarctica/Macquarie Antarctica/McMurdo Australia/Adelaide
2026-09-20 2 Africa/Casablanca Africa/El_Aaiun
2026-10-24 5 America/Godthab America/Scoresbysund Asia/Beirut
2026-10-25 57 Africa/Ceuta Antarctica/Troll Arctic/Longyearbyen
2026-10-29 1 Africa/Cairo
2026-11-01 48 America/Adak America/Anchorage America/Boise

Это 126 поясов из 418 на этих версиях Node и tzdata. Опасные дни — не только осенние по календарю северного полушария: в Чили и Австралии это апрель, а в Марокко таких дат в 2026 году две. Хватает и перевода на полчаса: в Australia/Lord_Howe сутки длятся 24,5 часа, и полночь плюс 24 часа — это всё ещё те же сутки.

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

Исправление и ещё одна ловушка

Лечится это отказом от арифметики в миллисекундах там, где речь о календарных днях:

for (let day = d.getDate() + 1; ; day += days) {
  const t = new Date(d.getFullYear(), d.getMonth(), day).getTime()
  if (!(t <= to)) break
  if (t !== out[out.length - 1]) out.push(t)
}

new Date(год, месяц, день) спокойно принимает день за пределами месяца: 32 октября станет 1 ноября. Длина суток в этом счёте вообще не участвует. Проверка на повтор нужна для редкого случая: в Pacific/Apia дня 30 декабря 2011 года не существует, конструктор сводит его к 31-му, и без проверки на оси было бы две одинаковые отметки. А условие выхода записано как !(t <= to), а не t > to, потому что за концом диапазона Date получается NaN: оба сравнения, t > to и t <= to, с ним ложны, и с первым цикл снова не закончился бы. Графику VOG такое не грозит, но выход из цикла не должен зависеть от того, что дата валидна.

Напрашивается вариант короче: один объект даты и setDate(getDate() + days). Он не зависает, но у него другая проблема. В Гаване весной часы переводят ровно в полночь, полуночи 8 марта не существует, и new Date(2026, 2, 8) даёт 01:00. Следующий setDate сохраняет это время, и сдвиг остаётся до конца цикла:

$ TZ=America/Havana node fix-check.mjs
setDate:    Sat Mar 07 2026 00:00 | Sun Mar 08 2026 01:00 | Mon Mar 09 2026 01:00
от начала:  Sat Mar 07 2026 00:00 | Sun Mar 08 2026 01:00 | Mon Mar 09 2026 00:00

Поэтому каждая дата строится заново от номера дня, а не от предыдущей даты. Общее правило: момент времени и календарная дата — разные вещи. Длина местных суток зависит от изменения смещения, поэтому «следующий день» — это календарная операция, а не прибавление миллисекунд. Именно это различие делает явным Temporal, где PlainDate и Instant — разные типы.

После выкатки та же страница в том же поясе открылась без длинных кадров. От начала загрузки страницы до завершения последнего запроса панелей прошло 1,2 секунды против 29,8 до исправления. Часть кода во втором замере могла браться из кэша браузера, но его скачивание занимало меньше секунды, так что на вывод это не влияет.

Как это проверять тестом

У timeTicks тестов раньше не было. Теперь есть, и первая их версия сама оказалась с изъяном. Она задавала пояс через vi.stubEnv, а ожидаемые полуночи считала через тот же местный Date:

const midnights = (y: number, m: number, firstDay: number, n: number) =>
  Array.from({ length: n }, (_, i) => new Date(y, m, firstDay + i).getTime())

Если пояс не применился, результат и ожидание сдвигаются одинаково, и тест проходит. Так и случилось при проверке: со старым циклом (его остановили на первом повторе отметки, чтобы не ждать падения) и пулом threads при TZ=UTC прошли все четыре теста. В потоке process.env — копия, и присваивание TZ на Date не влияет. С пулом forks тест осеннего перевода эту ошибку поймал.

Отсюда два правила. Первое: ожидание задаётся моментами UTC, которые не зависят от пояса процесса. По ним видно и саму суть перевода: смещение меняется между двумя соседними полуночами.

const utc = (...moments: string[]) => moments.map((m) => Date.parse(m))

it('осенний перевод: 25-часовые сутки не зацикливают ось', () => {
  vi.stubEnv('TZ', 'America/New_York')
  const to = Date.parse('2026-11-05T07:57:00Z')
  expect(timeTicks(to - 7 * DAY, to, 6)).toEqual(
    utc(
      '2026-10-30T04:00:00Z',
      '2026-10-31T04:00:00Z',
      '2026-11-01T04:00:00Z',
      '2026-11-02T05:00:00Z',
      '2026-11-03T05:00:00Z',
      '2026-11-04T05:00:00Z',
      '2026-11-05T05:00:00Z',
    ),
  )
})

Второе: пул процессов закреплён в настройках явно, pool: 'forks', чтобы тесты поясов не зависели от значения по умолчанию.

Набор поясов получился небольшой: осенний и весенний перевод в Нью-Йорке, Гавана как пояс без полуночи (моменты UTC там совпадают с нью-йоркскими, поэтому её тест проверяет ещё и местный час: 01:00 на 8 марта и 00:00 на 9 марта), Апиа как пропущенный день и Москва как пояс без перевода. Новые тесты стоит прогнать и на старом коде, и в неподходящем пуле: падение там показывает, что они проверяют именно эту ошибку.

Итог

  • В сутках не всегда 24 часа. Их бывает 23, 24,5 и 25. Прибавление 86 400 000 к местной полуночи — ошибка, даже если потом выровнять результат.
  • Календарные шаги считаются календарём. Каждая дата строится заново от номера дня, а не прибавлением к предыдущей.
  • Код в браузере работает в поясе пользователя. Одна страница ведёт себя по-разному у разных людей, и у разработчика может не воспроизводиться вообще.
  • Такие ошибки приходят по календарю. Код месяц работает, потом ломается на неделю и сам проходит. Если поломка совпала с датой перевода часов, стоит проверить это первым делом.
  • Сначала замер, потом версия. Версия про тяжёлые запросы выглядела убедительно, но ответы загружались за 140–400 мс. Long Animation Frames показал, что поток занят самой страницей, и искать на сервере стало незачем.
  • Тесты времени задают пояс сами, а ожидание — в UTC. Иначе тест может пройти, даже если пояс не применился. И стоит убедиться, что новый тест падает на старом коде.

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

Обсуждение в Telegram

Присоединиться →