Docker启动脚本需严谨处理环境变量，默认值回退用${VAR:-default}，空值/空白需trim校验，未定义、显式为空、含空白均应覆盖，并支持运行时覆盖优先级。
在 Docker 镜像的启动脚本（如 entrypoint.sh 或 startup.sh）中，合理解析环境变量并设置默认值，是保障容器健壮运行的关键。这类脚本通常依赖 $ENV_VAR 获取配置，但若变量未传入或为空，直接使用会导致启动失败或行为异常。
变量是否为空的判断逻辑要严谨
Docker 启动时通过 -e VAR=value 或 environment: 传入变量，但以下情况都需覆盖：
-
变量完全未定义：
$VAR展开为空字符串，[ -z "$VAR" ]为真 -
变量显式设为空：如
-e DB_HOST=，此时$DB_HOST是空字符串，同样触发-z -
变量含空白字符：如
-e LOG_LEVEL=" "，-z仍为真，但可能需 trim 处理
推荐用 ${VAR:-default} 进行简单默认值回退；对需校验/清理的场景，建议先赋值再判断：
DB_HOST=${DB_HOST:-"localhost"}
DB_PORT=${DB_PORT:-5432}
# 若允许空值但需非空才生效，可加条件检查
if [ -n "$DB_HOST" ]; then
echo "Connecting to $DB_HOST:$DB_PORT"
else
echo "DB_HOST not set, skipping connection"
fi支持运行时覆盖的变量优先级设计
常见需求是：镜像内置默认值 .env 文件
- 先读取
/etc/default/app或/app/config.env（如有，用set -a; source ...; set +a导出） - 再用
${VAR:-${DEFAULT_VAR}}形式兜底，避免覆盖已定义变量 - 关键配置（如密码、密钥）不设默认值，改用
${VAR:?Error: VAR is required}强制校验
数值与布尔型变量的安全转换
环境变量本质是字符串，直接用于判断易出错：
-
端口/数字类：用
[[ "$PORT" =~ ^[0-9]+$ ]] && PORT=${PORT:-8080}校验格式 -
布尔类：统一约定
ENABLE_CACHE=true/false/1/0/yes/no，转为小写后匹配：
enable_cache=$(echo "${ENABLE_CACHE:-false}" | tr '[:upper:]' '[:lower:]')
if [[ "$enable_cache" =~ ^(1|true|yes)$ ]]; then
CACHE_ENABLED=1
else
CACHE_ENABLED=0
fi敏感变量不打印、不透出到日志
调试时常用 set -x 查看变量展开，但会泄露密码等敏感信息：
- 启动脚本中避免对敏感变量执行
echo $DB_PASSWORD或set -x全局开启 - 确需调试可用
echo "DB_HOST=$DB_HOST, DB_PORT=$DB_PORT"显式排除敏感字段 - 生产镜像中移除调试语句，或通过
DEBUG=1环境变量控制日志级别
