Docker Swarm部署时环境变量未解析致MongoDB连接失败

Docker Compose与Docker Swarm在环境变量解析逻辑上存在差异：Compose会自动读取本地环境变量或.env文件来替换docker-compose.yml中的${VAR}占位符，但docker stack deploy默认不会执行这个替换操作，这就是你遇到问题的核心原因。以下是几种可行的解决办法：

方法1：部署时指定环境变量文件 #

直接在docker stack deploy命令中通过--env-file参数传递你的环境变量文件，让Swarm在部署时完成变量替换：

docker stack deploy --compose-file docker-compose-prod.yml --env-file .env my_stack

确保.env文件中包含MONGODB_PORT等所需变量，且路径正确。

方法2：先转换Compose文件再部署 #

使用docker compose convert命令预先将docker-compose-prod.yml中的变量替换为实际值，生成一个适合Swarm部署的静态文件，再进行部署：

# 转换并生成Swarm可用的配置文件
docker compose -f docker-compose-prod.yml convert > swarm-stack.yml
# 用生成的文件部署服务
docker stack deploy --compose-file swarm-stack.yml my_stack

这个方法的优势是可以提前验证变量替换结果，避免部署时的意外。

方法3：手动传递单个环境变量 #

如果只有少量变量需要替换，可以在部署命令前直接指定环境变量：

MONGODB_PORT=27017 docker stack deploy --compose-file docker-compose-prod.yml my_stack

这种方式适合临时调试或变量数量极少的场景。

验证解决方案 #

部署完成后，你可以进入容器检查环境变量是否正确加载：

# 查看user_service容器的环境变量
docker exec -it $(docker ps -q -f name=user_service) env | grep MONGODB_PORT

如果输出正确的端口值，说明变量解析问题已解决，服务应该能正常连接MongoDB。

内容的提问来源于stack exchange，提问作者RegreTTO