这是个很典型的Docker Compose变量替换时机问题，我来给你拆解清楚：

核心原因：变量替换的阶段完全不同 #

Docker Compose的变量处理分为两个独立的阶段，这就是问题的根源：

• Compose解析阶段：当你运行docker-compose up时，Compose会先读取.env文件、系统环境变量，然后解析docker-compose.yml里的${变量名}语法。这个阶段完全看不到environment字段里的变量——因为environment是要等到容器启动时，才会注入到容器内部的环境中，属于容器运行时的配置。
• 容器运行阶段：容器启动后，environment里的变量才会成为容器内部的环境变量，只有容器内的进程（比如shell）才能读取这些变量。

你原来的entrypoint写法：

entrypoint: java ${JAVA_OPTS} -Xmx${javaMemoryLimit} -jar /app.jar

这里的${JAVA_OPTS}和${javaMemoryLimit}是让Compose在解析阶段替换的，但此时environment的变量还没被加载，所以Compose会提示变量未设置，只能用空字符串代替。

而.env文件里的变量是在Compose解析yaml之前就被读取到的，属于Compose层面的环境变量，所以能被正常替换。

解决办法 #

根据你的需求，有几种可行的方案：

方案1：用容器内的shell处理变量替换

把entrypoint改成通过shell执行的形式，让变量替换在容器内部完成，此时environment的变量已经生效：

someserver:
  image: "some-server:latest"
  restart: always
  ports:
    - "8849:8849"
  environment:
    javaMemoryLimit: 3056M
    JAVA_OPTS: "-Dcom.sun.management.jmxremote=true -Dcom.sun.management.jmxremote.port=8849 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.local.only=false -Dcom.sun.management.jmxremote.rmi.port=8849 -Djava.rmi.server.hostname=localhost"
  entrypoint: ["sh", "-c", "java $JAVA_OPTS -Xmx$javaMemoryLimit -jar /app.jar"]

这里用sh -c启动shell，shell会在容器内部读取environment注入的变量，然后替换命令中的$JAVA_OPTS和$javaMemoryLimit，就能正常使用了。

方案2：将变量保留在.env文件中

这就是你已经验证过的方法，把需要在Compose解析阶段替换的变量放在.env里，适合不需要动态修改变量的场景。

方案3：自定义镜像，内置entrypoint脚本

如果你的服务经常需要这样的配置，可以自定义一个镜像，把entrypoint写成脚本，脚本内部读取环境变量并构建启动命令，这样Compose只需要设置environment，不需要覆盖entrypoint：
比如镜像里的entrypoint.sh：

#!/bin/sh
exec java $JAVA_OPTS -Xmx$javaMemoryLimit -jar /app.jar

然后在Dockerfile里设置：

ENTRYPOINT ["/entrypoint.sh"]

这样Compose配置只需要保留environment字段即可，不需要再写entrypoint。

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