使用Digital Persona SDK构建Java项目时遇包冲突编译错误

错误原因 #

该错误源于Java模块系统（JPMS）的包冲突：dpotapi和dpfpenrollment两个jar包均包含完全相同的包路径com.digitalpersona.onetouch.ui.swing，模块系统无法确定该加载哪个包的内容，导致编译失败。

解决方案 #

1. 移除不必要的依赖包 #

• 检查项目依赖配置（如Maven的pom.xml或Gradle的build.gradle），确认是否同时引入了dpotapi和dpfpenrollment。
• 根据项目实际需求，移除其中一个非必需的包：
  • 若仅需指纹注册功能，保留dpfpenrollment即可；
  • 若仅需基础指纹识别功能，保留dpotapi即可。
• 不确定时可解压两个jar包，对比内部类文件，确认项目实际依赖的类来自哪个包后再做移除。

2. 排除冲突包（需同时保留两个jar时） #

如果项目必须依赖两个包的功能，可在依赖管理中排除其中一个包的冲突路径：

• Maven示例（保留dpotapi，排除dpfpenrollment中的冲突包）：

  <dependency>
      <groupId>com.digitalpersona</groupId>
      <artifactId>dpfpenrollment</artifactId>
      <version>你的版本号</version>
      <exclusions>
          <exclusion>
              <groupId>com.digitalpersona</groupId>
              <artifactId>dpfpenrollment</artifactId>
              <classifier>com.digitalpersona.onetouch.ui.swing</classifier>
          </exclusion>
      </exclusions>
  </dependency>
  

• 注意：此操作可能导致类缺失，需测试确认项目功能不受影响。

3. 临时禁用模块系统检查 #

若项目无需使用JPMS，可通过参数绕过模块检查：

• IDEA中：打开Run Configuration，在VM options中添加--illegal-access=permit；
• Maven编译时：执行命令 mvn compile -Dmaven.compiler.args="--illegal-access=permit"；
• 此为临时方案，Java后续版本可能移除该参数，不推荐长期使用。

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