Dockerfile中RUN命令使用HereDoc为何失效？

核心原因 #

• Dockerfile中RUN指令默认使用sh而非bash，部分sh实现对HereDoc的变量展开、语法兼容存在限制。
• 用/bin/bash -c包裹时，若HereDoc边界符或引号处理不当，会导致Docker构建时提前解析变量，或bash执行时触发语法错误。
• 生成的SQL文件路径不符合PostgreSQL容器的初始化目录要求（比如未放到/docker-entrypoint-initdb.d/），或文件权限不足导致容器无法读取。

解决方案 #

方案1：指定bash执行并正确处理HereDoc #

直接在RUN中启动bash进程，确保HereDoc的变量由bash解析，避免sh的兼容性问题：

RUN /bin/bash <<EOF
cat > /docker-entrypoint-initdb.d/init.sql <<SQL_END
CREATE DATABASE ${DB_NAME};
CREATE USER ${DB_USER} WITH PASSWORD '${DB_PASSWORD}';
GRANT ALL PRIVILEGES ON DATABASE ${DB_NAME} TO ${DB_USER};
SQL_END
EOF

• 外层用/bin/bash <<EOF启动bash，避免sh的语法限制。
• 内层HereDoc的边界符SQL_END不添加引号，保证变量正常展开。

方案2：用echo多行输出替代HereDoc #

如果HereDoc仍有问题，可改用echo结合换行符生成文件：

RUN echo -e "CREATE DATABASE ${DB_NAME};\nCREATE USER ${DB_USER} WITH PASSWORD '${DB_PASSWORD}';\nGRANT ALL PRIVILEGES ON DATABASE ${DB_NAME} TO ${DB_USER};" > /docker-entrypoint-initdb.d/init.sql

• 注意密码中的特殊字符需要提前转义，避免触发SQL语法错误。

方案3：确保文件路径与权限正确 #

• 必须将SQL文件生成到PostgreSQL容器默认的初始化目录/docker-entrypoint-initdb.d/，该目录下的.sql文件会在容器首次启动时自动执行。
• 添加权限修复命令，保证PostgreSQL进程能读取文件：

RUN chown postgres:postgres /docker-entrypoint-initdb.d/init.sql && chmod 644 /docker-entrypoint-initdb.d/init.sql

方案4：确认构建参数传递正确 #

Dockerfile开头需声明构建参数：

ARG DB_NAME
ARG DB_USER
ARG DB_PASSWORD

构建时通过以下命令传递参数：

docker build --build-arg DB_NAME=mydb --build-arg DB_USER=myuser --build-arg DB_PASSWORD=mypass .

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