Kubernetes部署NextJS应用出现500内部服务器错误求助

1. 核心类型不匹配问题定位 #

报错TypeError: Expected "9001" to be a string明确指向代码期望字符串类型，但实际传入了数值类型（这里的9001大概率是端口号或其他配置项）。优先检查以下场景：

• 后端代码中是否有逻辑强制要求某个环境变量（如后端端口、数据库端口）为字符串类型，但K8s传入的变量被自动解析成了数字。比如代码里写了typeof process.env.PORT !== 'string'这类校验，而实际process.env.PORT是数字9001而非字符串"9001"。
• 前端NextJS的API路由（如果用它转发登录请求）中，是否直接将数值型变量拼接进URL或传递给后端，比如http://backend-service:${process.env.BACKEND_PORT}/login，若BACKEND_PORT是数字类型，拼接时可能触发类型错误。

2. 验证K8s环境变量实际传递情况 #

• 进入前端Pod查看环境变量：

  kubectl exec -it <你的前端Pod名称> -- printenv
  

  重点核对和登录流程相关的配置（如后端API地址、端口），确认变量值的类型是否符合代码预期。
• 若报错来自后端Pod，同样进入后端Pod执行上述命令，验证环境变量的传递是否正常。

3. 代码层类型处理修正 #

• 后端代码中，对数值型环境变量统一做字符串转换，比如：

  const backendPort = String(process.env.BACKEND_PORT || '9001');
  

• 前端API路由中，拼接URL时强制转换变量类型：

  const backendUrl = `http://backend-service:${String(process.env.BACKEND_PORT)}/login`;
  

4. 检查请求参数类型 #

在浏览器DevTools的Network标签中查看登录POST请求的Body，确认提交的用户名、密码之外的参数（如隐含的端口、标识ID）是否被错误转为数字类型，而后端接口期望接收字符串。

5. Docker镜像构建环节校验 #

检查前端Dockerfile中是否存在环境变量设置步骤，确认构建时的变量是否和K8s运行时变量冲突，或是否在构建时未将数值型变量转为字符串。

内容的提问来源于stack exchange，提问作者Container-Man