Spring Boot部署K8s时无法解析HOSTNAME占位符问题求助

问题根源 #

你的Spring Boot应用配置中使用了${HOSTNAME}占位符，但Kubernetes Pod内并未自动注入该环境变量，导致Spring框架无法解析占位符，抛出错误。对于StatefulSet类型的Pod，其默认hostname格式为<StatefulSet名称>-<序号>（你的场景下就是eureka-0），需要显式将Pod的hostname注入为环境变量。

解决方案：修改Kubernetes StatefulSet配置 #

在deploymentservice.yaml的StatefulSet容器环境变量配置中，添加HOSTNAME变量，通过Kubernetes字段引用动态获取Pod的hostname：

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: eureka
spec:
  serviceName: "eureka"
  replicas: 1
  selector:
    matchLabels:
      app: eureka
  template:
    metadata:
      labels:
        app: eureka
    spec:
      containers:
        - name: eureka
          image: firozehossain01/gieurekaserver:latest
          imagePullPolicy: Always
          ports:
            - containerPort: 8761
          env:
            - name: EUREKA_SERVER_ADDRESS
              valueFrom:
                configMapKeyRef:
                  name: eureka-cm
                  key: eureka_service_address
            # 新增：注入Pod的hostname作为环境变量
            - name: HOSTNAME
              valueFrom:
                fieldRef:
                  fieldPath: metadata.name

原理说明 #

• metadata.name对应Pod的名称，StatefulSet的Pod名称格式固定为<StatefulSet名称>-<序号>，和Pod的hostname完全一致。
• 注入该环境变量后，Spring Boot就能解析${HOSTNAME}，生成eureka-0.eureka的hostname，与你ConfigMap中配置的Eureka服务地址匹配。

验证操作步骤 #

1. 重新应用修改后的Kubernetes配置：

kubectl apply -f deploymentservice.yaml

2. 检查Pod启动状态，确认无报错：

kubectl get pods

3. 通过Minikube端口转发在本地访问Eureka服务：
   方式一：利用NodePort服务暴露地址

   minikube service eureka-lb --url
   

   方式二：直接端口转发到本地端口

   kubectl port-forward svc/eureka-lb 8761:80
   

   之后在本地浏览器访问http://localhost:8761即可查看Eureka控制台。

内容的提问来源于stack exchange，提问作者Md. Firoze Hossain