通过AWS CDK的Ec2TaskDefinition为NextJS应用传递环境变量失败

问题背景 #

使用AWS CDK的Ec2TaskDefinition部署Node.js/Next.js应用时，通过ContainerDefinition.addEnvironment()向容器传递DB_USERNAME、DB_PASSWORD、DB_ENDPOINT三个环境变量。Dockerfile采用多阶段构建，在runner阶段尝试通过ENV指令拼接这些变量生成DATABASE_URL，但Next.js中获取到的DATABASE_URL为空值（格式为postgresql://:@/postgres?schema=public），尽管AWS任务定义控制台中能看到这些环境变量已正确配置。

问题原因 #

Dockerfile中的ENV指令是在镜像构建阶段执行的，而ECS传递给容器的环境变量是在容器启动阶段才注入的。构建镜像时，ECS的环境变量还未存在，因此${DB_USERNAME}这类变量插值会失败，最终生成的DATABASE_URL中变量值为空。

解决方案 #

方案1：通过启动脚本在容器启动时拼接变量 #

删除Dockerfile中定义DATABASE_URL的ENV指令，改用启动脚本在容器启动时动态拼接：

1. 在项目根目录创建start.sh脚本：

#!/bin/sh
# 动态拼接DATABASE_URL
export DATABASE_URL="postgresql://${DB_USERNAME}:${DB_PASSWORD}@${DB_ENDPOINT}/postgres?schema=public"
# 启动Next.js应用
exec node_modules/.bin/next start -p 8081

2. 修改Dockerfile的runner阶段：

FROM --platform=linux/amd64 node:16-alpine AS runner
# 复制启动脚本并添加执行权限
COPY start.sh .
RUN chmod +x start.sh

EXPOSE 8081
CMD ["./start.sh"]

容器启动时，脚本会读取ECS注入的环境变量，正确拼接出DATABASE_URL并传递给Next.js。

方案2：在Next.js代码中直接拼接变量 #

无需在Dockerfile中处理，直接在Next.js的配置或数据库连接代码中读取环境变量并拼接：

// 示例：在数据库初始化文件或prisma配置中使用
const databaseUrl = `postgresql://${process.env.DB_USERNAME}:${process.env.DB_PASSWORD}@${process.env.DB_ENDPOINT}/postgres?schema=public`;

这种方式直接利用Node.js的环境变量读取能力，绕过Docker构建阶段的限制。

方案3：在CDK代码中提前拼接完整的DATABASE_URL #

直接在AWS CDK代码中拼接好DATABASE_URL，再通过addEnvironment传递给容器：

// TypeScript CDK代码示例
const dbUsername = "your-db-username"; // 建议从Secrets Manager/Parameter Store安全获取
const dbPassword = "your-db-password";
const dbEndpoint = "your-db-endpoint";

// 拼接完整的DATABASE_URL并传递给容器
containerDefinition.addEnvironment(
  "DATABASE_URL",
  `postgresql://${dbUsername}:${dbPassword}@${dbEndpoint}/postgres?schema=public`
);

此方式无需在Dockerfile或应用代码中处理拼接，直接传递最终的环境变量值。

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