import{_ as i,o as a,c as t,ae as e}from"./chunks/framework.B1nRs-GM.js";const g=JSON.parse('{"title":"Troubleshooting","description":"Типовые ошибки при обновлении проекта от шаблона и способы диагностики.","frontmatter":{"title":"Troubleshooting","description":"Типовые ошибки при обновлении проекта от шаблона и способы диагностики."},"headers":[],"relativePath":"reference/troubleshooting.md","filePath":"reference/troubleshooting.md"}'),n={name:"reference/troubleshooting.md"};function l(h,s,p,k,r,o){return a(),t("div",null,[...s[0]||(s[0]=[e(`

Troubleshooting ​

fatal: отказ слияния несвязанных историй изменений ​

Ошибка:

text
fatal: отказ слияния несвязанных историй изменений

Причина: master приложения не был создан от template, поэтому у веток нет общего предка.

Решение: выполнить одноразовую миграцию через sync/bootstrap-template по инструкции Миграция существующего master.

Коротко:

bash
git switch -c sync/bootstrap-template origin/master
git merge --allow-unrelated-histories origin/template
git push -u origin sync/bootstrap-template

--ff-only падает на template ​

Ошибка возникает при команде:

bash
git merge --ff-only templates/master

Причина: в template появились коммиты, которых нет в шаблоне. Значит ветка перестала быть чистым слепком.

Что проверить:

bash
git fetch templates
git --no-pager log --oneline --graph --decorate templates/master..template

Решение зависит от причины. Не продолжайте обновление, пока не станет понятно, какие локальные коммиты попали в template.

Пустой diff в sync-ветке ​

Симптом:

bash
git --no-pager diff --stat origin/master...HEAD

не показывает изменений.

Возможные причины:

Что проверить:

bash
git fetch origin
git fetch templates
git --no-pager log --oneline -1 origin/template
git --no-pager log --oneline -1 templates/master
git --no-pager log --oneline --graph --decorate --all --max-count=50

Случайно включили squash ​

Если sync-PR/MR уже влит squash-merge, история шаблона могла не сохраниться как нормальная merge-связь.

Что сделать:

Если ситуация стала неуправляемой, может потребоваться отдельная техническая миграция истории.

cannot run less ​

Ошибка:

text
cannot run less

Причина: Git пытается открыть pager less, которого нет в системе.

Решение: использовать git --no-pager:

bash
git --no-pager log --oneline --graph --decorate --all --max-count=50
git --no-pager diff template...master
`,35)])])}const F=i(n,[["render",l]]);export{g as __pageData,F as default};