Spring Boot无法解析'catalina.base'占位符问题求助

问题原因 #

mvn install执行时处于Maven构建阶段，此时Tomcat尚未启动，catalina.base这个Tomcat专属系统变量还未被初始化，Spring解析@PropertySource注解时无法识别该占位符，因此报错。而硬编码路径或Tomcat运行时的Spring应用能正常工作，是因为此时Tomcat已经设置了该系统变量。

解决方案 #

• 方案一：Maven构建时手动传递系统属性
  执行mvn install时临时指定catalina.base的值（适用于本地开发测试）：

  mvn install -Dcatalina.base=/your/local/tomcat/base/path
  

• 方案二：编程方式动态加载配置文件（推荐）
  放弃在@PropertySource中直接使用占位符，通过编程方式在Spring环境初始化时加载配置：

  1. 创建环境后置处理器类：

  @Configuration
  public class LdapConfig implements EnvironmentPostProcessor {
      @Override
      public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
          String catalinaBase = System.getProperty("catalina.base");
          if (catalinaBase != null) {
              Path configPath = Paths.get(catalinaBase, "ldap.properties");
              if (Files.exists(configPath)) {
                  environment.getPropertySources().addFirst(new ResourcePropertySource("file:" + configPath.toString()));
              }
          }
      }
  }
  

  2. 在src/main/resources/META-INF/spring.factories中注册该处理器：

  org.springframework.boot.env.EnvironmentPostProcessor=ca.rtss.ldaptest.LdapConfig
  

  这种方式会在运行时（Tomcat已启动，catalina.base已存在）动态加载配置文件，避免构建阶段的占位符解析问题。

• 方案三：构建阶段跳过配置检查
  若测试用例无需加载外部配置，可在测试类中使用@TestPropertySource指定测试配置路径，或排除相关配置类的属性解析逻辑，避免构建时报错。

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