如何在Maven项目中本地构建依赖源码而非使用预构建JAR？

可行，但直接把所有依赖源码塞进src/main/java会破坏Maven标准结构，还可能因依赖层级关系、包结构冲突导致编译错误。下面是两种规范的实现方案：

方案一：重构为多模块Maven项目（推荐） #

这是最清晰、易于维护的方式，每个依赖作为独立子模块存在：

1. 调整项目结构
   在原项目根目录下创建子模块文件夹，每个对应一个需要本地构建的依赖，示例结构：

   your-project/
   ├── pom.xml（父POM）
   ├── core/（原主项目模块）
   │   └── pom.xml
   ├── metadata-extractor/
   │   └── src/main/java/com/drewnoakes/...（对应原com.drewnoakes:metadata-extractor源码）
   ├── xmpcore/
   │   └── src/main/java/com/adobe/xmp/...（对应原com.adobe.xmp:xmpcore源码）
   ├── json/
   │   └── src/main/java/org/json/...（对应原org.json:json源码）
   ├── mgrs/
   │   └── src/main/java/mil/nga/mgrs/...（对应原mil.nga:mgrs源码）
   ├── grid/
   │   └── src/main/java/mil/nga/grid/...（对应原mil.nga:grid源码）
   ├── sf/
   │   └── src/main/java/mil/nga/sf/...（对应原mil.nga:sf源码）
   ├── color/
   │   └── src/main/java/mil/nga/color/...（对应原mil.nga:color源码）
   └── tiff/
       └── src/main/java/mil/nga/tiff/...（对应原mil.nga:tiff源码）
   

2. 配置父POM
   在根目录pom.xml中声明所有子模块：

   <modules>
       <module>core</module>
       <module>metadata-extractor</module>
       <module>xmpcore</module>
       <module>json</module>
       <module>mgrs</module>
       <module>grid</module>
       <module>sf</module>
       <module>color</module>
       <module>tiff</module>
   </modules>
   

3. 调整主项目（core）的依赖
   移除原来对中央仓库依赖的声明，替换为对本地子模块的依赖：

   <!-- 替换原com.drewnoakes:metadata-extractor依赖 -->
   <dependency>
       <groupId>com.drewnoakes</groupId>
       <artifactId>metadata-extractor</artifactId>
       <version>2.15.0</version>
   </dependency>
   <!-- 同理替换其他需要本地构建的依赖 -->
   

4. 配置子模块POM
   每个子模块的pom.xml只需保留原依赖的基本配置（groupId、artifactId、version），若子模块有内部依赖（比如grid依赖sf和color），直接在对应子模块的pom.xml中依赖本地子模块即可。

方案二：单模块下添加额外源码目录（适合快速改造） #

如果不想拆分为多模块，可通过build-helper-maven-plugin将依赖源码目录加入Maven编译路径：

1. 整理依赖源码结构
   在项目根目录下创建third-party文件夹，每个依赖的源码放在独立子目录中，保持原包结构：

   your-project/
   ├── src/main/java/（原主项目源码）
   ├── third-party/
   │   ├── metadata-extractor/src/main/java/com/drewnoakes/...
   │   ├── xmpcore/src/main/java/com/adobe/xmp/...
   │   ├── json/src/main/java/org/json/...
   │   └── ...（其他依赖源码）
   └── pom.xml
   

2. 引入build-helper插件
   在主项目pom.xml中添加插件配置，将所有第三方源码目录加入编译路径：

   <build>
       <plugins>
           <plugin>
               <groupId>org.codehaus.mojo</groupId>
               <artifactId>build-helper-maven-plugin</artifactId>
               <version>3.3.0</version>
               <executions>
                   <execution>
                       <id>add-source</id>
                       <phase>generate-sources</phase>
                       <goals>
                           <goal>add-source</goal>
                       </goals>
                       <configuration>
                           <sources>
                               <source>third-party/metadata-extractor/src/main/java</source>
                               <source>third-party/xmpcore/src/main/java</source>
                               <source>third-party/json/src/main/java</source>
                               <source>third-party/mgrs/src/main/java</source>
                               <source>third-party/grid/src/main/java</source>
                               <source>third-party/sf/src/main/java</source>
                               <source>third-party/color/src/main/java</source>
                               <source>third-party/tiff/src/main/java</source>
                           </sources>
                       </configuration>
                   </execution>
               </executions>
           </plugin>
       </plugins>
   </build>
   

3. 移除原仓库依赖
   删除pom.xml中所有需要本地构建的依赖声明，避免Maven同时加载本地源码和仓库JAR导致冲突。

关键注意事项 #

• 确保依赖源码的版本与原项目依赖的版本完全一致，避免兼容性问题；
• 处理依赖间的层级关系（比如metadata-extractor依赖xmpcore），必须同时包含所有依赖的源码；
• 若依赖包含测试代码，可按需添加add-test-source的插件配置，或直接忽略测试代码；
• 对于不关心的junit和jcommander，保留原仓库依赖即可，无需处理。

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