Next.js无法读取K8s Pod/容器主机名的问题排查

我在Azure上基于AKS和DevOps开发，部署了两个Next.js应用，通过next.config.js的路由重写机制实现代理通信。目前遇到问题：Next.js无法读取Pod/容器内的HOSTNAME环境变量。我使用的是Node服务器模式（非standalone模式，明确standalone模式会在构建时序列化配置，而当前是启动时加载配置）。已经通过kubectl exec执行printenv命令确认，Pod内确实存在目标环境变量（包括自定义Secret中的变量）。

需要明确两个问题：

1. 为什么Next.js无法读取K8s分配的Pod主机名？
2. 有没有更合理的多容器通信实现方式？比如拆分为独立Pod并配置Service？

部署定义 #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: project-home-dev-deploy
  namespace: project-dev
  labels:
    environment: development
    name: project-home-dev-deploy
    app: project-home-dev-deploy
spec:
  replicas: 1
  selector:
    matchLabels:
      app: project-home-dev-pod
  template:
    metadata:
      name: project-home-dev-pod
      namespace: project-dev
      labels:
        environment: development
        app: project-home-dev-pod
        name: project-home-dev-pod
    spec:
      nodeSelector:
        kubernetes.io/os: linux
      containers:
      - name: project-home-dev-container
        image: 镜像仓库地址
        envFrom:
        - secretRef:
            name: project-dev-secrets-env
        ports:
        - containerPort: 3000

      - name: project-admin-dev-container
        image: 镜像仓库地址
        envFrom:
        - secretRef:
            name: project-dev-secrets-env
        ports:
        - containerPort: 3001

Dockerfile #

FROM node:22.3-alpine AS base

FROM base AS builder
RUN apk update
RUN apk add --no-cache libc6-compat
WORKDIR /app
RUN npm -g i turbo
COPY . .
RUN turbo prune project-home --docker

FROM base AS installer
RUN apk update
RUN apk add --no-cache libc6-compat
WORKDIR /app
COPY .gitignore .gitignore
COPY --from=builder /app/out/json/ .
COPY --from=builder /app/out/package-lock.json ./package-lock.json
RUN npm install

COPY --from=builder /app/out/full/ .
COPY turbo.json turbo.json
RUN npm run build

FROM base AS runner
WORKDIR /app

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs
USER nextjs

COPY --from=installer /app/apps/home/next.config.js .
COPY --from=installer /app/apps/home/package.json .
COPY --from=installer --chown=nextjs:nodejs /app/apps/home/src ./src
COPY --from=installer --chown=nextjs:nodejs /app/apps/home/.next ./.next
COPY --from=installer --chown=nextjs:nodejs /app/apps/home/publi[c] ./public
COPY --from=installer --chown=nextjs:nodejs /app/node_modules ./node_modules

EXPOSE 3000
ENV PORT 3000

CMD ["npm", "run", "start"]

next.config.js #

const path = require('path')

const hostname = process.env.HOSTNAME || 'localhost';
const adminPort = process.env.ADMIN_PORT || '3001';
const envAdminUrl = `http://${hostname}:${adminPort}`;

/** @type {import('next').NextConfig} */
module.exports = {
  transpilePackages: ['@repo/database'],
  eslint: {
    ignoreDuringBuilds: true
  },
  experimental: {
    outputFileTracingRoot: path.join(__dirname, '../../'),
  },
  poweredByHeader: false,
  async rewrites() {
    return [
      {
        source: "/:path*",
        destination: `/:path*`,
      },
      {
        source: "/admin",
        destination: `${envAdminUrl}/admin`,
      },
      {
        source: "/admin/:path*",
        destination: `${envAdminUrl}/admin/:path*`,
      },
    ];
  },
};

一、为什么无法读取HOSTNAME环境变量？ #

1. K8s HOSTNAME的特性误解：K8s默认给Pod注入的HOSTNAME是Pod的名称，属于Pod级变量，所有容器都能读取。但同Pod内的容器共享网络命名空间，互相通信根本不需要依赖Pod主机名，直接用localhost即可互通，这是更可靠的方式。
2. 变量来源混淆：你提到Secret中存在自定义变量，但HOSTNAME是K8s自动注入的，不需要放在Secret中。如果你的自定义主机名变量不是HOSTNAME（比如命名为POD_HOSTNAME），就会出现读取失败的情况。
3. Next.js配置加载逻辑：非standalone模式下，next.config.js的代码在启动时执行，若容器内确实存在HOSTNAME，却读取失败，大概率是变量名拼写错误，或者启动脚本中存在覆盖环境变量的操作。

二、更优的多容器通信方案 #

方案1：同Pod内通信优化（保留单Pod架构） #

直接利用同Pod容器共享网络的特性，修改next.config.js中的通信地址：

const adminPort = process.env.ADMIN_PORT || '3001';
const envAdminUrl = `http://localhost:${adminPort}`; // 替换为localhost

这种方式无需依赖Pod主机名，通信更稳定，也避免了环境变量读取问题。

方案2：拆分Pod + K8s Service（生产环境推荐） #

将两个应用拆分为独立的Deployment和Pod，通过K8s Service实现服务发现，这是K8s微服务架构的标准实践：

1. 给project-admin创建独立Deployment，暴露3001端口。
2. 创建ClusterIP类型的Service指向project-admin的Pod：

apiVersion: v1
kind: Service
metadata:
  name: project-admin-service
  namespace: project-dev
spec:
  selector:
    app: project-admin-dev-pod # 对应admin Pod的标签
  ports:
    - protocol: TCP
      port: 3001
      targetPort: 3001

3. 修改project-home的next.config.js，使用Service名称作为通信主机名：

const adminServiceName = process.env.ADMIN_SERVICE_NAME || 'project-admin-service';
const adminPort = process.env.ADMIN_PORT || '3001';
const envAdminUrl = `http://${adminServiceName}:${adminPort}`;

K8s DNS会自动解析Service名称到对应ClusterIP，即使Pod扩容、重启，通信也不会中断，同时支持独立扩缩容和维护。

额外建议 #

• 所有环境变量通过K8s ConfigMap或Secret管理，避免硬编码。
• 若后续切换到standalone模式，需采用动态注入环境变量的方式（比如启动脚本替换配置模板、使用Next.js的env配置传递变量），避免构建时固化配置。

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