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

113 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`.**
Правильный способ — через системный каталог:
```sql
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 не поднимается после правки
```bash
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
```
**Данные при этом не теряются** — убирается только служебная
таблица позиций.