New API 的 Compose 配置里含美元符号，怎样核对插值后的实际值

Compose文件里的美元符号可能在容器启动之前就被解释。拿到的值不符合预期时，先区分Compose插值、容器环境注入和shell运行三段过程。本文所有值都是假哨兵，当前只验证有限语法参考与配置片段，未执行Docker Compose或启动New API。

先用不同的假值观察字符变化

附件令DEMO变量为fixture。demo$DEMO的参考输出是demofixture，demo$$DEMO的参考输出是保留单个美元符号的demo$DEMO。双美元符号用于避免Compose在这一层替换；如果最终命令还经过容器内shell，后面仍可能再展开，因此“插值后保真”不等于“应用最终收到保真”。

测试不能拿真实secret做可见哨兵。应专门造一串包含美元符号、空格和普通字母的假值，先在独立配置上看渲染结果；真实环境只比较长度、掩码和必要的摘要，避免把docker compose config的完整输出粘进工单。即使暂时为了排错，也不该将真实环境全量打印保存。

区分未设置与设置为空

附件分别准备MISSING未设置和EMPTY为空，使用带冒号的必填表达式时都应失败。若业务允许空串，应改用与该意图一致的表达式并另测；不要把“变量名存在”误当成“值可用”。默认值表达式中是否有冒号同样影响空值行为，必须按官方插值文档核对，不能凭YAML语法有效推断业务配置有效。

本运行器只覆盖文中几种表达式，不是完整Compose解析器，更没有验证shell引用、多个env文件或所有嵌套语法。输出中的required-error是参考器的原因码，不是假装Docker返回了某条真实错误。若升级Compose，应在隔离目录运行实际config命令保存版本和脱敏结果，再与这张期望表比较。

与网关版本一起保存渲染证据

New API官方仓库用于找到实际部署文件，具体变量名和启动方式必须以固定版本为准。本文故意用不存在的示例镜像和DEMO字段，不能直接作为网关生产配置导入。拿目标版本的文件做适配时，先只读核对，再把假值放入独立副本，避免为了测试字符展开修改正在服务的配置。

验收单可记录原始假输入、Compose版本、渲染后的字符长度、应用读取阶段是否还经过shell。若前两段一致而应用仍不同，应继续检查入口脚本，而不是反复改美元符号数量。本文解决的是插值阶段的字符保真，环境变量来源谁覆盖谁则另有独立教程；把两种问题拆开，才能明确这次变化究竟是值被替换还是来源被覆盖。

配套样本与复核入口

下载本篇独立合成输入和实验运行器，并下载运行器实际读取的c021.compose.yaml。上述文件放在同一目录后运行 python run_lab.py C021。完整运行需要全部四十四份输入及相关配置。结果中的method区分离线计算、静态参考检查与回环实测，不能把前两者当成真实网关已通过。

资料核对日期：2026-10-24。官方依据1；官方依据2；官方依据3。

与本站相关基础教程的区别：旧文提供部署命令和环境变量；本文只验Compose插值阶段的美元符号、空变量与必填检查，不部署服务或展示真实secret。