Docker镜像启动出现ZodError：serverUrl未定义问题求助

报错原因 #

Zod校验失败说明：你的应用在Docker容器启动时无法获取到serverUrl配置项。本地运行正常是因为本地.env文件或系统环境变量中存在该配置，但Docker环境中未正确传入或加载。

解决步骤 #

1. 确认环境变量的对应名称 #

先查看代码中Zod Schema的定义，明确serverUrl对应的环境变量名（注意大小写），比如：

import { z } from "zod";

const envSchema = z.object({
  // 注意这里的环境变量名可能是SERVER_URL而非serverUrl
  SERVER_URL: z.string().url(),
});

export const env = envSchema.parse(process.env);

如果是上述情况，你需要确保Docker中设置的是SERVER_URL，而非之前尝试的backend_url或host。

2. 给Docker容器传入环境变量 #

提供三种可行方式：

方式1：Dockerfile硬编码（适合固定环境）

修改Dockerfile的生产阶段，直接添加对应环境变量：

FROM node:16-alpine

RUN apk add --update --no-cache curl

WORKDIR /usr/src/app

ARG release

ENV RELEASE=$staging
ENV NODE_ENV=staging
ENV PORT=80
# 替换为你的实际serverUrl地址
ENV SERVER_URL="http://your-backend-server:port"

EXPOSE 80

# 后续COPY/CMD命令保持不变

方式2：运行容器时动态传入（推荐，灵活且避免敏感信息泄露）

启动容器时通过-e参数传入变量：

docker run -d -p 80:80 -e SERVER_URL="http://your-backend-server:port" your-image-name

方式3：复制.env文件到镜像（不推荐用于生产环境，风险高）

如果应用依赖.env文件，在Dockerfile生产阶段添加复制命令：

# builder阶段保持不变

FROM node:16-alpine

RUN apk add --update --no-cache curl

WORKDIR /usr/src/app

ARG release

ENV RELEASE=$staging
ENV NODE_ENV=staging
ENV PORT=80

EXPOSE 80

# 从builder阶段复制.env文件到容器
COPY --from=builder /usr/src/app/.env .

# 后续COPY/CMD命令保持不变

3. 验证环境变量是否生效 #

启动临时容器检查环境变量：

docker run --rm your-image-name printenv

查看输出中是否存在你设置的SERVER_URL（或对应变量名）。

4. 检查应用加载逻辑 #

• 若为Next.js后端代码：确保服务器启动时执行Zod校验，后端代码可直接读取process.env，无需NEXT_PUBLIC_前缀。
• 确认代码中是否存在环境变量映射逻辑，比如将SERVER_URL赋值给serverUrl后再传入Zod校验。

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