如何防止swagger代码生成系统创建javadocs？

编程问答 2022-08-23

问题描述

我们正在使用swagger代码生成来创建客户端API，并且代码库是使用Java 8编写的，现在我们正在升级至Java11。我们正在使用2.4.15版本的swagger-codegen-cli 。代码生成可以正常工作，但是最后它尝试为代码生成javadoc，在此过程中，我们得到以下错误：

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:jar (attach-javadocs) on project cohortmgr-client: MavenReportException: Error while generating Javadoc: 
[ERROR] Exit code: 1 - javadoc: error - The code being documented uses modules but the packages defined in http://docs.oracle.com/javase/8/docs/api/ are in the unnamed module.
[ERROR] 
[ERROR] Command line was: /Library/Java/JavaVirtualMachines/adoptopenjdk-11.jdk/Contents/Home/bin/javadoc @options @packages
[ERROR]

我不需要Java文档，并且如果它会导致我遇到问题，我希望不生成Java文档。反正有什么办法防止生成Java文档？

解决方法

您可以使用-Dmaven.javadoc.skip=true跳过javadoc错误，例如

mvn clean install -Dmaven.javadoc.skip=true
javadocjavadocswagger-codegen