Next.js使用Kubernetes服务名获取动态路由时构建失败求助

问题根源 #

Docker镜像构建过程不在Kubernetes集群内部，无法访问集群的CoreDNS服务，因此produtos-service这类内部服务域名会解析失败。即使删除generateStaticParams，如果还有其他在构建阶段执行的数据获取逻辑（比如Server Component预渲染、getStaticProps等），依然会触发报错。

实用解决方案 #

1. 用环境变量区分构建/运行时API地址

通过环境变量切换数据源，构建时使用本地Mock或外部可访问的测试地址，运行时再调用K8s内部服务：

// 封装API地址获取逻辑
const getApiBaseUrl = () => {
  // 运行在K8s集群时使用内部服务地址
  if (process.env.RUNTIME_ENV === 'k8s') {
    return 'http://produtos-service:80/api';
  }
  // 构建阶段或本地开发时用Mock/测试地址
  return 'http://localhost:3001/api';
};

export async function getListaProdutos() {
  const baseUrl = getApiBaseUrl();
  const res = await fetch(`${baseUrl}/produtos`);
  return res.json();
}

• 构建Docker镜像时，设置环境变量RUNTIME_ENV=build（或不设置，默认走测试地址）；
• 部署到K8s时，在Deployment的环境变量中配置RUNTIME_ENV=k8s。

2. 强制组件在运行时渲染（App Router）

如果使用Next.js App Router，Server Component默认会在构建阶段预渲染。添加dynamic="force-dynamic"强制组件在Pod运行时再执行数据获取，此时Pod已接入K8s网络，能解析内部服务名：

// 页面组件顶部添加
export const dynamic = "force-dynamic";

async function ProdutosPage() {
  const produtos = await getListaProdutos();
  return (
    <div>
      {/* 渲染产品列表 */}
    </div>
  );
}

export default ProdutosPage;

3. 构建阶段直接返回Mock数据

在数据获取函数中加入判断，构建阶段跳过真实API请求，直接返回Mock数据：

export async function getListaProdutos() {
  // 检测是否处于构建阶段
  if (process.env.NEXT_BUILD) {
    return [
      { id: 1, nome: "Mock Produto 1" },
      { id: 2, nome: "Mock Produto 2" }
    ];
  }
  // 运行时调用K8s内部服务
  const res = await fetch('http://produtos-service:80/api/produtos');
  return res.json();
}

构建Docker镜像时，传入环境变量NEXT_BUILD=true即可触发Mock逻辑。

4. 排查其他构建时执行的逻辑

检查next.config.js、自定义脚本或其他依赖中是否有在构建阶段触发API请求的代码，确保所有依赖K8s内部服务的逻辑都只在运行时执行。

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