Типичные ошибки

На этой странице собраны ошибки, с которыми чаще всего сталкиваются при установке и эксплуатации TG Support Bot, — с описанием причин и конкретными шагами для их устранения.

Не удаётся настроить SSL-сертификат

Certbot или другой ACME-клиент не может получить сертификат, потому что порт 80 занят другим процессом (обычно системным Nginx).

Проверьте, что занимает порт 80:

sudo netstat -ltnp | grep -w ':80'

Если порт удерживает системный Nginx, остановите его:

sudo systemctl stop nginx

После этого повторно запустите выпуск сертификата.

Grafana не запускается из-за ошибки прав доступа

Контейнер grafana завершается с ошибкой прав на запись в директорию данных.

Вывод docker compose logs grafana:

grafana  | GF_PATHS_DATA='/var/lib/grafana' is not writable.
grafana  | You may have issues with file permissions, more information here: http://docs.grafana.org/installation/docker/#migrate-to-v51-or-later
grafana  | mkdir: can't create directory '/var/lib/grafana/plugins': Permission denied

Назначьте владельцем директории пользователя с UID 472 (внутренний пользователь Grafana):

sudo chown -R 472:472 ./docker/grafana

Ошибка: Failed to open stream: Permission denied

Laravel не может записать в файл лога из-за недостаточных прав доступа к директории.

Перейдите в корень проекта и исправьте права:

sudo chown -R 775 storage/logs/laravel.log

Ошибка: require(autoload.php): Failed to open stream

Зависимости Composer не установлены — директория vendor отсутствует.

Вывод из лога контейнера:

laravel_queue  | PHP Warning:  require(/var/www/vendor/autoload.php): Failed to open stream: No such file or directory in /var/www/artisan on line 10
laravel_queue  | PHP Fatal error:  Uncaught Error: Failed opening required '/var/www/vendor/autoload.php' (include_path='.:/usr/local/lib/php') in /var/www/artisan on line 10

Установите или обновите зависимости:

composer update

Ошибка: MissingAppKeyException

Переменная APP_KEY в .env не задана или пуста — Laravel не может выполнять шифрование.

Сгенерируйте новый ключ приложения:

php artisan key:generate

Ошибка: file_put_contents

Владелец директории не совпадает с пользователем, от которого работает веб-сервер, поэтому PHP не может записать файл.

Перейдите в директорию, где находится корневая папка проекта:

cd /путь/к/родительской/директории

Рекурсивно передайте владение директорией пользователю www-data:

sudo chown -R www-data:www-data название_директории

Контейнер базы данных PgSQL не запускается

При запуске через docker compose контейнер pgdb завершается с ошибкой несовместимости формата данных — обычно после обновления образа PostgreSQL.

Вывод docker compose logs pgdb:

Error: in 18+, these Docker images are configured to store database data in a
       format which is compatible with "pg_ctlcluster"...
       Counter to that, there appears to be PostgreSQL data in:
         /var/lib/postgresql/data (unused mount/volume)
       This is usually the result of upgrading the Docker image without
       upgrading the underlying database using "pg_upgrade"...

Подробное решение описано в обсуждении на GitHub.