Файл .env рядом с compose.yaml сам по себе не передаёт все переменные приложению. Compose использует его для подстановки значений в YAML; окружение сервиса задаётся отдельно. Начните с одного несекретного поля, например APP_MODE: найдите его в разделе environment или в файле, указанном через env_file.

Если поле объявлено, сравните итоговый Compose и запущенный контейнер. Это две разные точки контроля. Правильный YAML не доказывает, что работающий экземпляр создан из него: деплой мог использовать другой project name, override или прежний контейнер. Полный вывод конфигурации может содержать пароли, поэтому не прикладывайте его к публичному сообщению.

Одна переменная проходит через две границы

# условный compose.yaml
services:
  app:
    image: example/app:tested
    environment:
      APP_MODE: ${APP_MODE:?APP_MODE is required}

В этом условном фрагменте образ example/app:tested обозначает ваш проверенный образ. Подстановка читает APP_MODE из окружения запуска Compose или выбранного env-файла. Выражение с :? останавливает обработку при отсутствующем или пустом значении. Затем environment передаёт результат в сервис. Документация Docker описывает обе операции отдельно; это полезно для диагностики, потому что сбой может находиться только на одной из границ.

Что обнаруженоГде искать
В .env значение есть, объявления нетдобавить явную передачу в сервис
В config значение неожиданноеокружение shell и набор Compose-файлов
В config верное, контейнер старыйидентичность проекта и пересоздание
В контейнере верное, приложение не видиткеш конфигурации и процесс запуска

Приоритет бывает причиной пустого значения

При одновременном env_file и environment значение из environment имеет приоритет. Посмотрите, нет ли там пустой строки или другого значения. Для подстановки также значимо окружение команды запуска: локальный терминал и CI могут получать разные переменные. Сохраните используемые -f, --env-file и рабочий каталог как часть описания релиза.

Не смешивайте переменные сборки образа с runtime-окружением. Если приложение встраивает значение в статический frontend при сборке, изменение environment уже запущенного сервиса не перепишет готовые файлы. Чтобы отличить этот случай, найдите место чтения переменной в коде и этап, на котором оно выполняется.

Проверка приложения не требует печатать пароль

  • Проверить наличие нужного ключа в итоговой конфигурации локально.
  • Сопоставить имя проекта, имя сервиса и ID текущего контейнера.
  • Для несекретного APP_MODE сравнить значение с ожидаемым.
  • Для секрета вывести только признак наличия через диагностический код приложения.
  • Сравнить конфигурацию web-процесса и фонового worker.

Проверка в новом shell внутри контейнера полезна, но не заменяет проверку долгоживущего процесса. Приложение могло загрузить настройки раньше, а worker продолжает использовать предыдущую конфигурацию. Если ключ есть, но результат отличается, исследуйте кеш и порядок запуска до очередной правки .env.

Новое окружение требует управляемого релиза

После исправления декларации пересоздайте нужный сервис штатным способом деплоя. Обычный restart существующего контейнера не следует считать обновлением его конфигурации. Перед переключением убедитесь, что новый экземпляр проходит healthcheck, а потребители используют совместимые значения. Не меняйте одновременно URL базы, пароль и формат сообщения: тогда причина отказа останется понятной.

При параллельной работе двух версий заранее решите, могут ли они использовать разные настройки. Например, смена имени очереди без обновления worker оставит задания необработанными. Для отката сохраните прежнюю декларацию и доступный образ; восстановление файла на хосте без пересоздания сервиса недостаточно.

После релиза проверьте пользовательский запрос и выполнение фоновой задачи. Если проблема осталась, подготовьте версию Compose, обезличенный раздел environment, список используемых файлов и признак наличия ключа в приложении. Значения токенов и паролей для такого разбора не нужны.

Проверенные источники