Maven读取外部属性文件失败排查及父仓库共享属性咨询

一、properties-maven-plugin配置未生效的排查点 #

• 升级插件版本：使用的1.0.0版本过于陈旧，存在已知兼容性问题，建议升级至最新稳定版（如1.1.0），修改pom中的版本号即可：

  <version>1.1.0</version>
  

• 确认插件执行状态：执行Maven命令时添加-X参数查看详细日志（如mvn clean install -X），搜索properties-maven-plugin相关记录，确认是否出现加载sample.properties的日志。若未执行，需检查是否插件配置被父pom的pluginManagement覆盖，或执行阶段未触发（常规命令如mvn compile会自动触发initialize阶段，自定义阶段需确认执行顺序）。

• 检查属性文件格式：确保sample.properties的键值对格式规范，示例如下：

  db.url=jdbc:mysql://localhost:3306/test
  db.username=root
  

  避免中文注释、特殊字符未转义等语法错误。

• 验证属性引用正确性：在pom或代码中引用属性时，需使用${属性名}格式，且保证拼写与属性文件中的键完全一致（大小写敏感）。

二、父仓库放置属性文件供子项目引用的实现方法 #

方法1：父pom配置全局属性加载 #

在父pom的build/plugins中配置properties-maven-plugin，指向父项目内的属性文件，子项目继承父pom后会自动加载这些属性：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>properties-maven-plugin</artifactId>
    <version>1.1.0</version>
    <executions>
        <execution>
            <phase>initialize</phase>
            <goals>
                <goal>read-project-properties</goal>
            </goals>
            <configuration>
                <files>
                    <!-- 路径基于父项目根目录 -->
                    <file>${project.parent.basedir}/src/main/resources/common.properties</file>
                </files>
            </configuration>
        </execution>
    </executions>
</plugin>

子项目无需额外配置，继承父pom后执行Maven命令时会自动加载父项目中的属性文件。

方法2：属性文件打包为依赖jar #

若需更灵活的引用方式，可将属性文件单独打包为jar发布到仓库，再由子项目引入：

1. 创建独立Maven项目，将属性文件放在src/main/resources下，配置maven-jar-plugin确保文件被打包：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-jar-plugin</artifactId>
       <version>3.3.0</version>
   </plugin>
   

2. 执行mvn clean install将jar发布到本地或远程仓库。
3. 在子项目中添加该jar依赖，通过properties-maven-plugin读取jar内的属性文件：

   <plugin>
       <groupId>org.codehaus.mojo</groupId>
       <artifactId>properties-maven-plugin</artifactId>
       <version>1.1.0</version>
       <executions>
           <execution>
               <phase>initialize</phase>
               <goals>
                   <goal>read-project-properties</goal>
               </goals>
               <configuration>
                   <files>
                       <file>classpath:common.properties</file>
                   </files>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

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