Docker环境下Spring Boot容器无法解析CASSANDRA_HOST环境变量占位符问题求助

你遇到的核心问题是Maven资源过滤与Spring占位符解析的冲突：你在pom.xml中开启了<filtering>true</filtering>，这会让Maven在构建阶段尝试替换application.properties里的${CASSANDRA_HOST}占位符，但该环境变量仅存在于Docker容器中，构建阶段根本不存在，所以Maven会把这个占位符替换为空或直接移除，最终导致Spring启动时无法解析对应的变量。

解决方案一：修改Maven资源过滤规则，避免干扰Spring占位符 #

调整Maven的资源配置，指定它使用不同的分隔符处理需要Maven替换的变量，这样就不会触碰Spring的${...}格式占位符。修改pom.xml的<resources>部分：

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <!-- 指定Maven使用@@作为变量分隔符，不再处理${}格式 -->
        <delimiters>
            <delimiter>@@</delimiter>
        </delimiters>
    </resource>
</resources>

之后如果需要Maven在构建时替换变量，就用@@MY_VAR@@的格式，Spring的${CASSANDRA_HOST}会被完整保留，启动时正常读取Docker环境变量。

解决方案二：转义Spring占位符 #

如果必须保留Maven的默认过滤规则，你可以在application.properties里转义Spring的占位符，让Maven构建后输出正确的格式：

cassandra.contactpoints= \${CASSANDRA_HOST}

Maven构建时会自动去掉反斜杠，最终文件里的内容就是${CASSANDRA_HOST}，Spring就能正常解析了。

解决方案三：关闭不必要的资源过滤 #

如果你不需要Maven在构建阶段替换任何资源文件变量，直接关闭过滤功能即可：

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>false</filtering>
    </resource>
</resources>

这样application.properties里的${CASSANDRA_HOST}会原封不动地保留，Spring启动时会从Docker环境变量中读取对应的值。

额外验证方案：直接读取环境变量 #

你也可以跳过application.properties的中间层，在CassandraConfig中直接注入环境变量，绕开资源过滤的影响：

@Configuration
public class CassandraConfig extends AbstractCassandraConfiguration {
    // 直接读取Docker环境变量
    @Value("${CASSANDRA_HOST}")
    private String contactPoints;
}

同时记得把application.properties里的对应配置注释掉，避免冲突。

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