格式化电脑后无法执行mvn clean install构建Quarkus Maven应用

问题 #

此前能正常运行的Quarkus Maven应用，格式化电脑后按原配置重装了JDK、Maven并设置环境变量，安装了VS Code的Java扩展包、Maven for Java、Quarkus插件，甚至尝试用之前版本的JDK和Maven，但执行mvn clean install时构建失败，报错信息如下：

[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  15.705 s
[INFO] Finished at: 2023-07-19T14:17:04+02:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal io.quarkus.platform:quarkus-maven-plugin:3.0.1.Final:build (default) on project piksa-quarkus-1: Failed to build quarkus application: io.quarkus.builder.BuildException: Build failure: Build failed due to errors
[ERROR]         [error]: Build step io.quarkus.deployment.pkg.steps.JarResultBuildStep#buildRunnerJar threw an exception: java.lang.UnsupportedOperationException
[ERROR]         at jdk.zipfs/jdk.nio.zipfs.ZipFileSystemProvider.ensureFile(ZipFileSystemProvider.java:87)
[ERROR]         at jdk.zipfs/jdk.nio.zipfs.ZipFileSystemProvider.newFileSystem(ZipFileSystemProvider.java:101)
[ERROR]         at io.quarkus.fs.util.ZipUtils.newZip(ZipUtils.java:130)
[ERROR]         at io.quarkus.deployment.pkg.steps.JarResultBuildStep.buildThinJar(JarResultBuildStep.java:627)
[ERROR]         at io.quarkus.deployment.pkg.steps.JarResultBuildStep.buildRunnerJar(JarResultBuildStep.java:222)
[ERROR]         at java.base/jdk.internal.reflect.DirectMethodHandleAccessor.invoke(DirectMethodHandleAccessor.java:104)
[ERROR]         at java.base/java.lang.reflect.Method.invoke(Method.java:578)
[ERROR]         at io.quarkus.deployment.ExtensionLoader$3.execute(ExtensionLoader.java:909)
[ERROR]         at io.quarkus.builder.BuildContext.run(BuildContext.java:282)
[ERROR]         at org.jboss.threads.ContextHandler$1.runWith(ContextHandler.java:18)
[ERROR]         at org.jboss.threads.EnhancedQueueExecutor$Task.run(EnhancedQueueExecutor.java:2513)
[ERROR]         at org.jboss.threads.EnhancedQueueExecutor$ThreadBody.run(EnhancedQueueExecutor.java:1538)
[ERROR]         at java.base/java.lang.Thread.run(Thread.java:1623)
[ERROR]         at org.jboss.threads.JBossThread.run(JBossThread.java:501)
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException

解决建议 #

• 清理并重建Maven本地仓库：删除本地仓库中io/quarkus开头的依赖目录（默认路径~/.m2/repository），重新执行mvn clean install让Maven重新下载完整依赖；同时确认仓库目录有读写权限，避免因权限不足导致Zip文件操作失败。
• 验证JDK环境：执行java -version和javac -version确认JDK版本符合Quarkus 3.x要求（JDK 11+），检查JAVA_HOME指向JDK而非JRE，PATH变量优先使用目标JDK的bin目录。
• 强制更新项目依赖：执行mvn clean install -U，-U参数强制Maven更新快照依赖；在VS Code中执行Maven: Clean和Maven: Update Project同步项目依赖。
• 检查Quarkus版本兼容性：确认pom.xml中Quarkus插件版本与核心依赖版本一致，尝试升级插件到最新稳定版（如3.2.x系列），修复可能存在的Zip文件系统bug。
• 更换项目目录：将项目复制到路径无特殊字符的目录（如C:\projects\quarkus-app或/home/user/projects/quarkus-app），避免原目录残留异常缓存或路径字符导致构建失败。

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