适配PDFBox3时Openhtmltopdf Maven多模块编译报错求助

一、排查父模块的子模块路径配置 #

• 检查父pom.xml里的<modules>节点，子模块路径必须和实际文件系统路径完全匹配，比如core模块在根目录下的core文件夹，就写<module>core</module>，别写错大小写或层级。
• 必须在父模块根目录执行mvn clean install，别单独在子模块跑，否则父模块识别不到子模块。

二、修复PDFBox模块的依赖与父POM快照问题 #

• 确认PDFBox模块的pom.xml中，<parent>节点的groupId、artifactId、version和父pom完全一致，尤其是快照版本号（比如1.0.0-SNAPSHOT）不能出错。
• PDFBox依赖Core时，用${project.groupId}和${project.version}动态引用，避免硬写版本导致不一致：

  <dependency>
      <groupId>${project.groupId}</groupId>
      <artifactId>openhtmltopdf-core</artifactId>
      <version>${project.version}</version>
  </dependency>
  

• 先单独在Core模块根目录运行mvn clean install，把Core的快照包安装到本地Maven仓库，让PDFBox模块能找到依赖。

三、清理Maven缓存消除干扰 #

• 删除本地Maven仓库中对应项目的快照包（路径一般是~/.m2/repository/[你的项目groupId]/openhtmltopdf-core和openhtmltopdf-pdfbox），避免旧缓存影响。
• 执行mvn clean install -U，强制更新快照依赖。

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