Docker部署Node Express应用至Heroku时db-migrate无法读取Heroku配置变量的问题

我来帮你搞定这个问题！核心原因很明确：Docker镜像构建阶段（也就是你Dockerfile里的RUN指令执行时），Heroku的配置变量根本没被注入到容器环境里，所以db-migrate读不到CLEARDB_DATABASE_URL这些关键变量，只能默认去连本地的127.0.0.1:3306，自然就连接失败了。

下面给你两种可行的解决方案，你可以根据自己的需求选：

方案1：在GitHub Action里把Heroku环境变量传到Docker构建阶段 #

既然你用的是gonuit/heroku-docker-deploy@v1.3.3这个Action，它支持通过build_args把环境变量传递给Docker构建过程，步骤如下：

1. 先把Heroku的数据库相关变量存到GitHub仓库的Secrets里：

   • 去Heroku控制台你的应用设置里，找到CLEARDB_DATABASE_URL、DB_HOST、DB_USER、DB_PASSWORD、DB_NAME这些值
   • 在GitHub仓库的「Settings」→「Secrets and variables」→「Actions」里，把这些变量添加为Repository Secrets

2. 修改你的GitHub Action部署配置，添加build_args参数：

- name: Deploy to Heroku
  uses: gonuit/heroku-docker-deploy@v1.3.3
  with:
    heroku_api_key: ${{ secrets.HEROKU_API_KEY }}
    heroku_app_name: ${{ secrets.HEROKU_APP_NAME }}
    heroku_email: ${{ secrets.HEROKU_EMAIL }}
    build_args: |
      CLEARDB_DATABASE_URL=${{ secrets.CLEARDB_DATABASE_URL }}
      DB_HOST=${{ secrets.DB_HOST }}
      DB_USER=${{ secrets.DB_USER }}
      DB_PASSWORD=${{ secrets.DB_PASSWORD }}
      DB_NAME=${{ secrets.DB_NAME }}

3. 调整Dockerfile，接收构建参数并转为环境变量：

FROM node:16-alpine3.13
WORKDIR /app
COPY package.json ./
RUN yarn install --production
COPY . .

# 接收从GitHub Action传过来的构建参数
ARG CLEARDB_DATABASE_URL
ARG DB_HOST
ARG DB_USER
ARG DB_PASSWORD
ARG DB_NAME

# 把构建参数设置为容器环境变量，让db-migrate能读到
ENV CLEARDB_DATABASE_URL=$CLEARDB_DATABASE_URL
ENV DB_HOST=$DB_HOST
ENV DB_USER=$DB_USER
ENV DB_PASSWORD=$DB_PASSWORD
ENV DB_NAME=$DB_NAME

RUN yarn db-migrate up -e production
CMD ["yarn", "start"]

这样Docker构建的时候就能拿到这些变量，db-migrate就能正常连接数据库执行迁移了。

方案2：把db-migrate迁移放到容器启动阶段执行 #

这其实更符合Heroku的部署逻辑——因为Heroku的配置变量是在容器运行阶段才注入的，所以我们可以把迁移步骤放到应用启动前执行：

修改你的Dockerfile：

FROM node:16-alpine3.13
WORKDIR /app
COPY package.json ./
RUN yarn install --production
COPY . .

# 写一个启动脚本，先执行迁移再启动应用
RUN echo '#!/bin/sh' > start.sh && \
    echo 'yarn db-migrate up -e production' >> start.sh && \
    echo 'yarn start' >> start.sh && \
    chmod +x start.sh

CMD ["./start.sh"]

这样容器启动时，Heroku已经把所有配置变量都注入到环境里了，db-migrate能顺利读到CLEARDB_DATABASE_URL，完成迁移后再启动你的Express应用。

小提醒 #

• 用方案2的话，如果迁移耗时比较久，Heroku的健康检查可能会超时，你可以去Heroku应用设置里调整启动超时时间，或者在迁移脚本里加个重试逻辑，避免偶发的数据库连接问题。
• 方案1要注意敏感信息安全，确保GitHub Secrets里的变量不会泄露——放心，构建参数不会存在最终的镜像里，只要你的Action配置没问题就安全。

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