Spring Boot容器部署报错：无法解析占位符'mjmlSecrets.appId'

1. Docker Compose变量配置优先级冲突 #

当docker-compose.yml同时配置environment和env_file时，environment中的变量会覆盖env_file里的同名变量。如果.env里的变量没被正确加载，或者变量名不匹配，就会导致Spring Boot读不到值。

检查要点：

• 确认.env文件里的变量名是MJMLSECRETS_APPID（Spring Boot的驼峰占位符mjmlSecrets.appId对应环境变量是大写下划线格式，不是原驼峰名）
• 检查environment块里是否有同名变量，避免.env里的变量被覆盖

2. .env文件路径错误 #

Docker Compose默认读取和docker-compose.yml同目录的.env文件，如果你的.env在其他路径，必须在env_file里明确指定：

env_file:
  - ./config/.env  # 替换成你的.env实际路径

3. Maven打包时的占位符提前替换问题 #

执行mvn clean install时，Spring Boot Maven插件默认会替换配置文件里的占位符。如果本地环境没有这些变量，打包后占位符会被留空或设为null，导致容器运行时读不到值。

解决方法：在pom.xml里配置插件，禁止打包时替换占位符，让Spring Boot在容器内运行时读取环境变量：

<build>
  <plugins>
    <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <configuration>
        <expandProperties>false</expandProperties>
      </configuration>
    </plugin>
  </plugins>
</build>

4. 容器内环境变量未正确传递 #

可以进入容器验证变量是否存在：

# 查看运行中的容器ID
docker ps
# 进入容器终端
docker exec -it <容器ID> /bin/bash
# 打印目标变量值
echo $MJMLSECRETS_APPID

如果输出为空，说明Docker没正确加载.env里的变量，需要重新检查env_file配置。

5. Spring Boot配置写法问题 #

确认application.yml里的占位符格式正确，建议加默认值避免直接报错：

mjmlSecrets:
  appId: ${MJMLSECRETS_APPID:}  # 冒号后留空表示无默认值，也可以填临时测试值

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