运行docker compose up时看到变量未设置的警告，Compose会把该变量替换成空字符串。容器有时仍能创建，但镜像标签、端口、卷路径或连接地址可能已经变成错误值。
先检查渲染后的Compose配置，不要把警告当作无影响提示。
Compose为什么会使用空字符串
Docker官方文档说明，Compose文件中的值可以通过变量插值生成；变量没有设置且表达式没有默认值时，会替换为空字符串。插值发生在每个文件合并之前，并只作用于YAML值。
容器内部环境变量和Compose解析文件时使用的变量不是同一阶段。仅在environment里写名称，不一定能解决文件插值。
变量可能来自哪些位置
先检查当前shell环境、项目目录中的.env、命令行指定的--env-file，以及Compose文件里的默认表达式。执行docker compose config --environment可查看用于插值的环境来源，再用docker compose config检查解析结果。
排查输出可能包含密码或令牌。保存和分享配置前要先清理敏感值。
为必填变量设置失败条件
对数据库密码、镜像标签或关键路径，可使用Compose支持的必填变量表达式，让缺失值直接中止，而不是默默变成空字符串。可选值则给出明确默认值，并记录部署环境的覆盖方式。
默认值不能用来掩盖必须由运维提供的密钥。机密信息应通过合适的secret或受控配置渠道提供。
核对多文件合并结果
同时使用多个-f文件时，Compose会分别插值后再合并；不同工作目录和命令参数也可能改变.env来源。升级脚本或CI任务应固定运行目录和环境文件路径。
可先在萤光云或LightNode的独立VPS执行配置渲染。不要直接在生产主机用不明环境变量启动容器。
怎样确认问题已解决
补齐变量后重新运行docker compose config，核对镜像、端口、卷和服务地址，再创建容器。用docker compose ps与应用健康检查确认服务行为。
验收标准是警告消失、最终配置没有意外空值，容器和业务均按预期运行。
FAQ
问：.env里的变量一定会传进容器吗？答：不一定，.env主要可用于Compose插值，容器环境仍取决于服务配置。
问：为何本机正常，CI里变成空值？答：优先比较运行目录、shell环境、–env-file参数和CI密钥注入方式。
温馨提示
温馨提示：把docker compose config加入部署前检查，但注意脱敏输出；关键变量应缺失即失败。
