NestJS项目.env配置无法连接Docker容器中MariaDB数据库问题

1. 给NestJS服务配置环境变量加载规则 #

你当前的docker-compose配置没有把本地的.env文件传入etk-be容器，也没有指定环境变量，容器内的Node进程读取不到DB_*开头的配置。有两种方式修复：

• 方式一：在docker-compose的etk-be服务下添加env_file配置，指定你本地.env文件的路径：

etk-be:
  build: ./backend/
  image: etk-lizenzdb-backend:final
  container_name: etk-be
  restart: unless-stopped
  ports:
    - 3000:3000
  networks: 
    - etk
  # 新增以下内容
  env_file:
    - ./backend/.env # 替换为你本地.env文件相对于docker-compose.yml的实际路径

• 方式二：直接在etk-be服务的environment字段传入数据库配置，不需要依赖容器内的.env文件：

etk-be:
  # 原有配置不变
  environment:
    DB_USER: root
    DB_PASS: example
    DB_HOST: mariadb
    DB_NAME: lizenzdb
    DB_PORT: 3306

2. 检查NestJS项目的Dockerfile是否包含.env拷贝逻辑 #

如果你选择用容器内的.env文件加载配置，需要确保你的backend目录下的Dockerfile有将.env拷贝到容器工作目录的步骤，示例：

# 其他构建步骤不变
WORKDIR /app
COPY package*.json ./
RUN npm install
# 新增拷贝.env的步骤
COPY .env ./
COPY . .
RUN npm run build

注意：如果你的项目配置了.dockerignore文件，需要确认.env没有被加入忽略列表。

3. 配置服务启动顺序依赖，避免数据库未就绪就启动NestJS #

MariaDB首次启动需要初始化数据库、执行权限配置，耗时比NestJS长，会出现NestJS先启动完成尝试连接数据库失败的情况。在docker-compose的etk-be服务下添加依赖配置：

etk-be:
  # 原有配置不变
  depends_on:
    - mariadb

如果仍存在启动时序问题，可以给NestJS添加数据库连接重试逻辑，修改TypeORM配置：

TypeOrmModule.forRoot({
  type: 'mariadb',
  host: process.env.DB_HOST,
  port: parseInt(process.env.DB_PORT),
  username: process.env.DB_USER,
  password: process.env.DB_PASS,
  database: process.env.DB_NAME,
  entities: [User],
  synchronize: true,
  // 新增重试配置
  retryAttempts: 10,
  retryDelay: 3000,
})

4. 验证配置生效 #

修改完成后执行以下命令重启所有服务：

docker-compose down -v # 注意：-v会删除本地数据卷，如有需要可去掉
docker-compose up --build

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