Docker部署Nest.js项目无法连接远程MySQL服务器求助

将连接远程MySQL服务器的Nest.js项目Docker化后，尝试连接数据库时出现错误：unable to connect to the database 127.0.0.1:3306，但实际数据库的主机地址和端口并非localhost和3306。以下是当前使用的Dockerfile配置：

FROM node:16 As development

WORKDIR /api
RUN mkdir -p /api/data
COPY . .

ENV $(cat .env | xargs)

#RUN npm install
ENV PORT=${PORT} \
    NODE_ENV=production \
    DATABASE_HOST=${DATABASE_HOST} \
    DATABASE_NAME=${DATABASE_NAME} \
    DATABASE_PASSWORD=${DATABASE_PASSWORD} \
    DATABASE_PORT=${DATABASE_PORT} \
    DATABASE_USERNAME=${DATABASE_USERNAME} \
    DATABASE_TYPE=${DATABASE_TYPE} \
    REDIS_HOST=${REDIS_HOST} \
    REDIS_PORT=${REDIS_PORT} \
    REDIS_PASSWORD=${REDIS_PASSWORD} \
    JWT_SECRET=xxxx \
    JWT_EXPIRES_IN=${JWT_EXPIRES_IN} \
    EMAIL_SERVER=${EMAIL_SERVER} \
    EMAIL_ADDRESS=${EMAIL_ADDRESS} \
    EMAIL_PASSWORD=${EMAIL_PASSWORD}

COPY .env /api

RUN npm install
RUN npm run build
COPY . .

EXPOSE 3000
CMD ["npm", "run", "start:prod"]

你的Dockerfile存在几个关键问题，导致项目无法正确读取远程数据库的配置：

1. 环境变量加载逻辑混乱 #

• 先执行COPY . .再加载.env变量，后续又手动重复设置ENV，此时${DATABASE_HOST}等变量可能未被正确解析，最终项目会 fallback 到Nest.js默认的数据库配置（127.0.0.1:3306）。
• 重复执行COPY .env /api属于冗余操作，且可能覆盖之前加载的变量。

2. 重复COPY导致文件覆盖 #

构建完成后再次执行COPY . .，会将本地未编译的源码覆盖掉dist目录下的构建产物，导致生产环境运行的代码可能未读取到正确的环境变量。

3. 依赖安装与镜像构建不规范 #

• 生产环境使用npm install无法保证依赖版本的一致性，建议用npm ci。
• 未使用多阶段构建，镜像体积过大且包含不必要的开发依赖。

修正后的Dockerfile #

# 构建阶段：编译代码并安装完整依赖
FROM node:16 As builder

WORKDIR /api

# 先复制依赖锁文件，利用Docker缓存优化构建速度
COPY package*.json ./
RUN npm ci

# 复制.env文件并加载所有环境变量
COPY .env ./
ENV $(cat .env | xargs)

# 复制项目源码并执行构建
COPY . .
RUN npm run build

# 生产阶段：仅保留运行所需文件，减小镜像体积
FROM node:16-alpine As production

WORKDIR /api

# 从构建阶段复制生产依赖、编译产物和.env文件
COPY --from=builder /api/node_modules ./node_modules
COPY --from=builder /api/dist ./dist
COPY --from=builder /api/.env ./

# 设置固定的生产环境变量
ENV NODE_ENV=production
ENV JWT_SECRET=xxxx

EXPOSE 3000
# 直接运行编译后的主文件，避免npm脚本额外开销
CMD ["node", "dist/main.js"]

额外注意事项 #

• 确保你的.env文件中确实正确配置了远程数据库的DATABASE_HOST和DATABASE_PORT，且没有拼写错误。
• 确认远程MySQL服务器允许Docker容器所在网络的IP访问（检查数据库的防火墙规则和授权列表）。

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