使用GitHub Actions部署Next.js到AKS时ACR构建报错：缺少MONGODB_URI

我用GitHub Actions构建Next.js应用并部署到Azure Kubernetes Service（AKS），但在「构建并推送镜像到Azure容器注册表（ACR）」步骤中，生产构建环节提示必须在.env.local中定义MONGODB_URI环境变量。虽然我已经在K8s的Manifest.yaml文件里配置了这个变量，但构建依然失败。

报错信息 #

Creating an optimized production build ...

✓ Compiled successfully
Linting and checking validity of types ...
Collecting page data ...
Error: Please define the MONGODB_URI environment variable inside .env.local

相关配置文件 #

GitHub Actions Workflow文件 #

name: Build and deploy an app to AKS

on:
  push:
    branches: ["main"]
  workflow_dispatch:

env:
  AZURE_CONTAINER_REGISTRY: "abc"
  CONTAINER_NAME: "abc"
  RESOURCE_GROUP: "abc"
  CLUSTER_NAME: "abc"
  DEPLOYMENT_MANIFEST_PATH: "./manifest.yaml"

jobs:
  buildImage:
    permissions:
      contents: read
      id-token: write
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Azure login
        uses: azure/login@v1.4.6
        with:
          client-id: ${{ secrets.AZURE_CLIENT_ID }}
          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}

      - name: Build and push image to ACR
        run: |
          az acr build --image ${{ env.AZURE_CONTAINER_REGISTRY }}.azurecr.io/${{ env.CONTAINER_NAME }}:${{ github.sha }} --registry ${{ env.AZURE_CONTAINER_REGISTRY }} -g ${{ env.RESOURCE_GROUP }} .
  deploy:
    permissions:
      actions: read
      contents: read
      id-token: write
    runs-on: ubuntu-latest
    needs: [buildImage]
    steps:
      - uses: actions/checkout@v3

      - name: Azure login
        uses: azure/login@v1.4.6
        with:
          client-id: ${{ secrets.AZURE_CLIENT_ID }}
          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}

      - name: Set up kubelogin for non-interactive login
        uses: azure/use-kubelogin@v1
        with:
          kubelogin-version: 'v0.0.25'

      - name: Get K8s context
        uses: azure/aks-set-context@v3
        with:
          resource-group: ${{ env.RESOURCE_GROUP }}
          cluster-name: ${{ env.CLUSTER_NAME }}
          admin: 'false'
          use-kubelogin: 'true'

      - name: Deploys application
        uses: Azure/k8s-deploy@v4
        with:
          action: deploy
          manifests: ${{ env.DEPLOYMENT_MANIFEST_PATH }}
          images: |
            ${{ env.AZURE_CONTAINER_REGISTRY }}.azurecr.io/${{ env.CONTAINER_NAME }}:${{ github.sha }}

Kubernetes Manifest.yaml文件 #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: app
  template:
    metadata:
      labels:
        app: app
    spec:
      containers:
      - name: app
        image: app.azurecr.io/app:latest
        ports:
        - containerPort: 3000
        env:
        - name: MONGODB_URI
          value: "mongodb+srv://webapp:abc"
---

apiVersion: v1
kind: Service
metadata:
  name: app-service
spec:
  type: LoadBalancer
  ports:
    - port: 80
      targetPort: 3000
  selector:
    app: app

解决方案 #

核心原因 #

Manifest.yaml里配置的环境变量是容器运行时生效的，而Next.js在ACR构建镜像时（执行next build的生产构建阶段）会尝试读取MONGODB_URI——如果你的代码在getStaticProps/getStaticPaths这类构建时运行的函数里使用了这个变量，就会触发报错。

解决方法1：在构建阶段注入环境变量 #

在GitHub Actions的buildImage步骤中，先从GitHub Secrets生成临时的.env.local文件，再执行镜像构建：

修改Build and push image to ACR步骤的脚本：

run: |
  # 从GitHub Secrets生成.env.local文件
  echo "MONGODB_URI=${{ secrets.MONGODB_URI }}" > .env.local
  # 执行ACR构建
  az acr build --image ${{ env.AZURE_CONTAINER_REGISTRY }}.azurecr.io/${{ env.CONTAINER_NAME }}:${{ github.sha }} --registry ${{ env.AZURE_CONTAINER_REGISTRY }} -g ${{ env.RESOURCE_GROUP }} .

解决方法2：调整代码避免构建时依赖变量 #

如果MONGODB_URI只在运行时使用（比如API路由、客户端请求），可以修改代码逻辑：

• 将数据获取逻辑移到API路由（运行时执行），而非getStaticProps这类构建时执行的函数
• 给变量添加默认值，避免构建时报错（比如process.env.MONGODB_URI || ""）

解决方法3：通过Dockerfile传递构建参数 #

如果项目有自定义Dockerfile，可通过构建参数传递变量：

1. 修改Dockerfile：

# 添加构建参数
ARG MONGODB_URI
# 设置环境变量
ENV MONGODB_URI=$MONGODB_URI

# 原有的Dockerfile内容...
RUN npm run build

2. 修改Workflow中的构建命令：

az acr build --image ${{ env.AZURE_CONTAINER_REGISTRY }}.azurecr.io/${{ env.CONTAINER_NAME }}:${{ github.sha }} --registry ${{ env.AZURE_CONTAINER_REGISTRY }} -g ${{ env.RESOURCE_GROUP }} --build-arg MONGODB_URI=${{ secrets.MONGODB_URI }} .

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