Справочник ошибок при деплое

# Справочник ошибок при деплое Все типичные ошибки на Bothost в одном месте: сборка, запуск, логи, Dockerfile и переменные окружения. Как отличить ошибку сборки от ошибки запуска, что проверить в логах и как исправить.

Для ИИ-ассистентов и поддержки:

1. Если сборка успешна, но runtime MODULE_NOT_FOUND для dist/, build/ и т.п. — проверьте WORKDIR /app + bind mount: артефакты сборки в /app недоступны. Решение — WORKDIR /usr/src/app, данные оставить в /app/data.

2. Если ошибка Cannot find module '/app/index.js' (или другой entrypoint в корне /app), а в репозитории код лежит во вложенной папке — это не bind mount. В корневом package.json указан index.js, которого в корне нет. Укажите путь к реальному файлу (main file / scripts.start) или вынесите код в корень.

3. Если MODULE_NOT_FOUND для пути вроде /app/src/data/... (или любой вложенной …/data/…), а файл есть в Git — на нодах с bind mount раньше агент пропускал все папки data при копировании кода. Нужен редеплой после фикса агента (игнорируется только корневой /app/data).

4. Индекс документации для LLM: https://bothost.ru/llms.txt · полный текст: https://bothost.ru/llms-full.txt · эта статья в Markdown: https://bothost.ru/docs/common-errors.md

Как читать логи

Ошибка: Cannot find module '/app/dist/...' (сборка успешна)

Симптомы

• В логах сборки шаг RUN npm run build (или аналог) завершается успешно, файл создаётся (например dist/server.cjs).
• В логах работы при старте:

Error: Cannot find module '/app/dist/server.cjs'
code: 'MODULE_NOT_FOUND'

• Статус контейнера: restarting (циклический перезапуск).

Причина

• При сборке образа в WORKDIR /app выполняется npm run build → в образе появляется /app/dist/....
• При запуске контейнера на части серверов каталог /app монтируется с хоста: туда попадает исходный код из Git, без папки dist/ (её обычно нет в репозитории и в .gitignore).
• Команда CMD ["node", "dist/server.cjs"] ищет файл в примонтированном /app, а не в слое образа → MODULE_NOT_FOUND.

Решение

FROM node:20-alpine
WORKDIR /app
COPY . .
RUN npm ci
RUN npm run build
ENV DATA_DIR=/app/data
RUN mkdir -p /app/data && chmod 777 /app/data
CMD ["node", "dist/server.cjs"]

FROM node:20-alpine

WORKDIR /usr/src/app

COPY . .
RUN npm ci
RUN npm run build

ENV NODE_ENV=production
ENV DATA_DIR=/app/data

RUN mkdir -p /app/data && chmod 777 /app/data

EXPOSE 3000

CMD ["node", "dist/server.cjs"]

• WORKDIR /usr/src/app — здесь лежат исходники и dist/ из образа; bind mount на /app их не затирает.
• CMD выполняется относительно WORKDIR, путь dist/server.cjs корректен.
• DATA_DIR=/app/data — данные по-прежнему в volume Bothost (хранение БД).

Дополнительно проверить

• В коде пути к данным берутся из process.env.DATA_DIR или path.join('/app/data', ...), а не из __dirname относительно старого /app.
• Папка dist/ в .gitignore — это нормально; на Bothost она должна жить в образе (или вне /app), а не в Git.

Альтернативы

• Сборка при старте в entrypoint.sh (медленнее, но всё в /app): npm run build && node dist/server.cjs.
• Multi-stage Dockerfile: финальный COPY --from=builder артефактов в /usr/local/bin или другой путь вне /app.

Ошибка: Cannot find module '/app/src/data/...' (файл есть в Git)

Симптомы

• Сборка образа успешна.
• В логах работы: ERR_MODULE_NOT_FOUND / Cannot find module '/app/src/data/templates.js' (или другой файл во вложенной папке data).
• В GitHub файл на месте; в файл-менеджере бота папки src/data/ может не быть.

Причина

Решение

• Обновить агент на ноде (фикс: игнорируется только корневой data/).
• Сделать новый деплой бота (одного рестарта мало — код на хосте нужно перекопировать).

Ошибка: Cannot find module '/app/index.js' (код во вложенной папке)

Симптомы

• Сборка образа проходит успешно (Successfully built).
• В логах работы при старте:

Error: Cannot find module '/app/index.js'
code: 'MODULE_NOT_FOUND'

• Статус контейнера: restarting.
• В файл-менеджере бота в корне видны package.json и подпапка с кодом, но нет index.js в корне /app.

Как отличить от ошибки с dist/

Причина

repo/
├── package.json          ← "main": "index.js", "start": "node index.js"
├── README.md
└── my-bot/               ← весь код здесь
    ├── index.js
    ├── package.json
    └── ...

Решение

1. Указать main file при деплое (быстрее всего)

2. Исправить корневой package.json

{
  "main": "discord-html-watcher/index.js",
  "scripts": {
    "start": "node discord-html-watcher/index.js"
  }
}

3. Вынести код в корень репозитория

repo/
├── package.json              ← ссылается на несуществующий index.js
└── discord-html-watcher/
    ├── index.js
    ├── package.json
    └── ...

repo/
├── index.js                  ← точка входа в корне
├── package.json              ← "main": "index.js", "start": "node index.js"
└── ...

Дополнительно проверить

• В корневом package.json поля main и scripts.start указывают на файл, который реально есть в репозитории (проверьте пути в GitHub).
• Если в корне «лишний» package.json (копия или заглушка), а рабочий проект только во вложенной папке — либо поправьте пути, либо уберите корневой файл и укажите main file вручную.
• После смены entrypoint нужен новый деплой, одного рестарта контейнера недостаточно, если образ/команда запуска уже зафиксированы со старым путём.

Ошибка: нет node_modules при кастомном Dockerfile (Node.js)

Симптомы

• Error: Cannot find module 'express' (или другой пакет из package.json).
• Сборка образа прошла, зависимости ставились в RUN npm ci.

Причина

Решение

• Используйте WORKDIR вне /app для запуска или убедитесь, что npm ci в Dockerfile и CMD согласованы с тем, откуда реально стартует node.
• Не полагайтесь на node_modules в Git — только в образе/на хосте после деплоя.

Ошибка: Go/Rust/Java бот — сборка успешна, контейнер сразу падает, логов нет

Симптомы

• Все шаги docker build завершились успешно, образ создан.
• Сразу после ==> Build completed бот в статусе error / failed.
• В логах сборки нет вывода от самого приложения — только сообщение агента

• Runtime-логи (docker logs) пусты или содержат:
  Copy

    exec /app/bot: no such file or directory

• В файл-менеджере бота видны исходники (main.go, go.mod, …), но нет бинарника.

Причина

/app/bot        ← скрыт bind mount'ом
/app/server     ← тоже скрыт
/app/bin/server ← тоже скрыт (весь /app перекрыт)

Решение

FROM golang:1.22-alpine AS builder
WORKDIR /src
COPY . .
RUN go build -o /app/bot .

FROM alpine:3.20
WORKDIR /app
COPY --from=builder /app/bot .     # ← скрыт bind mount'ом
CMD ["./bot"]                      # ← не найден

FROM golang:1.22-alpine AS builder
WORKDIR /src
COPY . .
RUN go build -o /usr/local/bin/bot .

FROM alpine:3.20
WORKDIR /app
COPY --from=builder /usr/local/bin/bot /usr/local/bin/bot   # ← вне /app
RUN mkdir -p /app/data && chmod 777 /app/data
CMD ["/usr/local/bin/bot"]                                   # ← работает

Примечание: кастомный Dockerfile vs автогенерация

Совместимость языков с bind mount на /app

Контейнер в статусе restarting

Симптомы

Частые причины

• Процесс сразу завершается с ошибкой (MODULE_NOT_FOUND, синтаксис, отсутствие env).
• CMD запускает не тот файл или одноразовый скрипт вместо долгоживущего процесса (в т.ч. код во вложенной папке — см. раздел про /app/index.js выше).
• Приложение слушает 127.0.0.1 вместо 0.0.0.0 (для вебхуков/домена).
• Не заданы обязательные переменные (BOT_TOKEN, GEMINI_API_KEY и т.д.).

Что делать

• Откройте логи работы (не сборки).
• Найдите первую ошибку в цикле перезапуска.
• Сопоставьте с разделами этой статьи или Кастомный Dockerfile.

Не работает DeepSeek / Gemini / OpenAI / Claude (ошибки API, timeout, geo)

Симптомы

Причина

Решение

• В профиле включите «Зарубежный IP для API и нейросетей».
• Задеплойте бота заново — существующие боты сами не переезжают на ноду с зарубежным IP.

Сборка успешна, но 502 / 504 на домене

Симптомы

Причина

Решение

• Слушать 0.0.0.0, порт из переменной PORT (Bothost передаёт её в контейнер).
• Внутренний порт в настройках бота = порту в коде / EXPOSE.
• Подробнее: Работа с доменами и портами, Веб-приложения и домены.

Ошибка: лог сборки обрывается после «Cloning into...»

Симптомы

• В логах сборки видно только:

==> Cloning https://github.com/...
Cloning into '...'...

• После этого поток обрывается, статус бота переходит в failed.
• Никакого сообщения об ошибке не отображается.

Причина

Решение

• Пересохраните Dockerfile в кодировке UTF-8 (в VS Code: строка состояния снизу → кликнуть на кодировку → «Save with Encoding» → UTF-8).
• Уберите кириллические комментарии из Dockerfile или переведите их на английский.
• Запустите деплой повторно.

Проверка кодировки

file Dockerfile
# OK:    ASCII text или UTF-8 Unicode text
# Плохо: ISO-8859, windows-1251, UTF-8 Unicode (with BOM)

Ошибки только в логах сборки

Чеклист для кастомного Dockerfile (Node.js + сборка)

• [ ] WORKDIR для кода и dist/ не /app (например /usr/src/app).
• [ ] Данные и БД — в /app/data или через DATA_DIR.
• [ ] CMD указывает на файл, который реально появляется после npm run build.
• [ ] Порт из process.env.PORT, хост 0.0.0.0 (если есть HTTP).
• [ ] Секреты — в переменных окружения Bothost, не в образе.
• [ ] После правок — новый деплой; проверены и логи сборки, и логи работы.

См. также

• Кастомный Dockerfile
• Хранение базы данных
• Переменные окружения
• FAQ