Maven多环境构建中application.properties加载问题求助

问题根源 #

• 直接在IDE运行程序时，IDE默认类路径包含src/main/resources（原始资源目录），而非Maven处理后的target/classes目录，所以加载到的是未替换变量的原始文件。
• 尝试/target/application.properties加载失败，是因为target目录不在Java的类路径范围内，getResourceAsStream只能加载类路径下的资源，不能直接访问文件系统的目录路径。

正确配置与操作步骤 #

1. 确保Maven资源插件配置正确 #

先确认你的pom.xml中maven-resources-plugin和Profile的配置是否正确，示例如下：

<build>
    <!-- 开启资源过滤，让Maven处理变量替换 -->
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <!-- 开启过滤，才会替换资源中的变量 -->
            <filtering>true</filtering>
        </resource>
    </resources>

    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>3.3.1</version>
            <configuration>
                <!-- 指定变量分隔符，默认就是${*}，可根据需要调整 -->
                <delimiters>
                    <delimiter>${*}</delimiter>
                </delimiters>
            </configuration>
        </plugin>
    </plugins>

    <!-- 多环境Profile配置 -->
    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <!-- 定义dev环境的变量，比如路径配置 -->
                <app.config.dir>/opt/dev/config</app.config.dir>
            </properties>
        </profile>
        <!-- 可添加prod/test等其他环境的Profile -->
    </profiles>
</build>

2. 正确的资源加载方式 #

保持代码中的加载逻辑不变：

InputStream inputStream = YourClass.class.getResourceAsStream("/application.properties");

注意：这里的/application.properties是从类路径根目录加载，Maven执行mvn clean install -Pdev后，替换后的配置文件会被复制到target/classes目录，而target/classes是Java类路径的核心组成部分，程序运行时会优先从这里加载资源。

3. 确保运行时使用处理后的资源 #

• 命令行运行：执行mvn clean install -Pdev后，直接运行target/classes下的类，或者打包成jar后运行jar包（jar包内包含替换后的配置）。
• IDE运行：
  1. 先执行mvn process-resources -Pdev，让Maven把替换后的资源同步到target/classes。
  2. 配置IDE将target/classes作为类路径的优先项，或者开启IDE的Maven委托构建（比如IDEA中：Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Runner，勾选Delegate IDE build/run actions to Maven），这样IDE运行程序时会先触发Maven的资源处理流程，确保加载的是替换后的配置。

关键注意事项 #

• 永远不要直接通过文件系统路径（比如target目录）加载资源，打包成jar后，资源会嵌入jar内部，文件系统路径会失效，getResourceAsStream是跨场景的标准加载方式。
• 如果IDE自动复制资源到输出目录，可能会覆盖Maven处理后的文件，此时需要关闭IDE的自动资源复制，完全交由Maven处理资源过滤。

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