Files
buryan-infra/ops/scripts/MATRIX-SEQUENCE-FIX.md

3.4 KiB
Raw Permalink Blame History

Matrix: починка счётчиков — 16.10.2026

Симптом

Synapse не запускался: Restarting (1)
matrix.buryans.ru → 502
В журнале: UniqueViolation: duplicate key value violates
           unique constraint "events_stream_ordering"

Причина

При переносе баз из SQLite в PostgreSQL счётчики номеров не выровнялись по данным. Это следствие работы 14–15 октября.

Мои прежние починки выравнивали только колонку id — а здесь проблема была в других колонках и в служебной таблице:

events.stream_ordering
receipts.stream_id
presence_stream.stream_id
account_data.stream_id
device_lists_stream.stream_id
device_inbox.stream_id
e2e_cross_signing_keys.stream_id
pushers.id

Что сделали

1. Выровняли ВСЕ счётчики во ВСЕХ базах

Скрипт находит каждую последовательность и её колонку через системный каталог (pg_depend), а не догадки.

Исправлено 52 счётчика:
  gitea_db      4
  nextcloud_db  24
  nextcloud_db_pre_utf8  24

2. Очистили служебную таблицу позиций

Synapse сам указал решение в журнале:

Postgres sequence 'receipts_sequence' is inconsistent with
associated stream position of 'receipts' in the
'stream_positions' table.

A temporary workaround ... run:
    DELETE FROM stream_positions WHERE stream_name = 'receipts';

Сделали для всех потоков. Synapse пересоздаёт её сам.

Результат

Synapse:      200 ✅
Element:      200 ✅
домен дома:   302 ✅
домен снаружи: 302 ✅

Проверено ПОЛНОСТЬЮ:
  вход → создание комнаты → отправка сообщения → чтение

Данные целы:
  пользователей 20 (было 20)
  событий      3314 (было 3314)
  комнат         30

Важный урок

Проверять надо ВСЕ счётчики, а не только колонку id.

Правильный способ — через системный каталог:

SELECT seq.relname, tab.relname, col.attname
  FROM pg_class seq
  JOIN pg_depend dep ON dep.objid = seq.oid AND dep.deptype = 'a'
  JOIN pg_class tab ON tab.oid = dep.refobjid
  JOIN pg_attribute col ON col.attrelid = tab.oid
                       AND col.attnum = dep.refobjsubid
 WHERE seq.relkind = 'S';

И ещё: счётчики без привязки к колонке (как events_stream_ordering_seq) так не находятся — их надо смотреть отдельно, через pg_sequences.

Скрипт

/root/buryan-infra/ops/scripts/fix-all-sequences.sh

Если Matrix не поднимается после правки

pct exec 155 -- docker stop matrix-synapse
pct exec 151 -- sudo -u postgres psql -d matrix_db -c "DELETE FROM stream_positions"
pct exec 155 -- docker start matrix-synapse

Данные при этом не теряются — убирается только служебная таблица позиций.