Docker内使用jq替换JSON环境变量占位符报ENV未定义如何解决？

报错的核心原因是 Docker 容器内预装的 jq 版本过低：$ENV 是 jq 1.6 版本才新增的内置环境变量访问接口，而绝大多数 Linux 基础镜像默认自带的 jq 版本为 1.5 及以下，无法识别 $ENV 语法，因此直接抛出编译错误。

方案1：升级容器内 jq 到 1.6 及以上版本（最简便，升级后原有命令可直接复用） #

如果是 Debian/Ubuntu 系镜像，在 Dockerfile 中添加以下命令升级 jq：

RUN apt-get remove -y jq && \
    apt-get update && apt-get install -y wget && \
    wget https://github.com/stedolan/jq/releases/download/jq-1.6/jq-linux64 -O /usr/bin/jq && \
    chmod +x /usr/bin/jq

如果是 Alpine 系镜像，在 Dockerfile 中添加以下命令升级 jq：

RUN apk add --no-cache jq=1.6-r0 --repository=http://dl-cdn.alpinelinux.org/alpine/edge/main

方案2：兼容低版本 jq 的写法（无需升级 jq） #

通过 env 命令将所有环境变量传入 jq 内部，兼容 1.5 版本语法，命令如下：

jq 'with_entries( .value = if (.value | startswith("CONNECTOR_")) then $ENV[.value] // .value else .value end )' \
  --argjson ENV "$(env | jq -nR 'reduce inputs as $i ({}; .[($i | split("=")[0])] = ($i | split("=")[1:] | join("="))')" \
  device-connectorbody.json

方案3：使用 envsubst 工具替换（兼容性最强，不依赖 jq 版本） #

如果配置文件中除需要替换的 CONNECTOR_ 开头占位符外，没有其他 $ 符号，可以用更轻量的 envsubst 完成替换：

# 先将占位符转换为 envsubst 可识别的格式，再执行替换
sed 's/\(CONNECTOR_[a-zA-Z0-9_]*\)/${\1}/g' device-connectorbody.json | envsubst > replaced.json

Alpine 镜像如果没有 envsubst 可以先执行 apk add --no-cache gettext 安装。

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