Kubernetes容器启动失败，Docker-Compose运行正常求排查指导

1. 确认K8s Pod中实际生效的环境变量 #

Docker-Compose与K8s的环境变量传递逻辑存在差异，优先排查变量值是否符合JSON格式要求：

• 执行命令查看目标Pod的BACKEND_CORS_ORIGINS值：

  kubectl exec <你的Pod名称> -- printenv BACKEND_CORS_ORIGINS
  

• 正确的格式应为JSON数组字符串，例如：["http://frontend:3000", "https://example.com"]；如果输出是逗号分隔的字符串（如http://frontend:3000,https://example.com）或未加引号的数组，都会触发JSONDecodeError。

2. 修正K8s Deployment的环境变量配置 #

检查Deployment.yml中BACKEND_CORS_ORIGINS的定义，确保格式合法：

• 直接设置值时，必须用单引号包裹整个JSON数组（避免YAML解析引号）：

  env:
    - name: BACKEND_CORS_ORIGINS
      value: '["http://frontend:3000", "https://example.com"]'
  

• 若从ConfigMap/Secret读取，检查对应资源中的值是否为标准JSON数组字符串。

3. 验证Pydantic校验逻辑 #

确认config.py中的校验器能正确处理字符串格式的环境变量：

• 示例正确的校验逻辑（适配Pydantic v1/v2）：

  from pydantic import BaseSettings, validator
  import json
  
  class Settings(BaseSettings):
      BACKEND_CORS_ORIGINS: list[str] = ["http://localhost:3000"]
  
      @validator("BACKEND_CORS_ORIGINS", pre=True)
      def parse_cors_origins(cls, v):
          if isinstance(v, str):
              try:
                  return json.loads(v)
              except json.JSONDecodeError:
                  # 兼容逗号分隔的字符串格式（可选）
                  return [origin.strip() for origin in v.split(",")]
          return v
  

  如果校验器未实现字符串转JSON数组的逻辑，会直接抛出解析错误。

4. 手动调试Pod内的启动流程 #

若上述步骤未定位问题，可进入Pod手动模拟启动：

• 进入目标Pod：

  kubectl exec -it <你的Pod名称> -- /bin/bash
  

• 手动设置合法的变量值并启动程序：

  export BACKEND_CORS_ORIGINS='["http://frontend:3000"]'
  ./run.sh
  

  如果此方式能正常启动，即可确认问题源于K8s的环境变量配置。

5. 排查启动脚本的变量覆盖问题 #

检查docker-entrypoint.sh和run.sh，确保脚本未意外修改BACKEND_CORS_ORIGINS的值：

• 例如脚本中若存在BACKEND_CORS_ORIGINS=${BACKEND_CORS_ORIGINS:-"http://localhost"}，会将默认值设为单个字符串而非JSON数组，导致解析失败。

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